Book.h
上传用户:hechengdz
上传日期:2020-05-13
资源大小:1591k
文件大小:4k
- /*
- File: Book.h
- Abstract:
- The Book class manages the in-memory representation of information about a single book.
- Version: 1.9
- Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple
- Inc. ("Apple") in consideration of your agreement to the following
- terms, and your use, installation, modification or redistribution of
- this Apple software constitutes acceptance of these terms. If you do
- not agree with these terms, please do not use, install, modify or
- redistribute this Apple software.
- In consideration of your agreement to abide by the following terms, and
- subject to these terms, Apple grants you a personal, non-exclusive
- license, under Apple's copyrights in this original Apple software (the
- "Apple Software"), to use, reproduce, modify and redistribute the Apple
- Software, with or without modifications, in source and/or binary forms;
- provided that if you redistribute the Apple Software in its entirety and
- without modifications, you must retain this notice and the following
- text and disclaimers in all such redistributions of the Apple Software.
- Neither the name, trademarks, service marks or logos of Apple Inc. may
- be used to endorse or promote products derived from the Apple Software
- without specific prior written permission from Apple. Except as
- expressly stated in this notice, no other rights or licenses, express or
- implied, are granted by Apple herein, including but not limited to any
- patent rights that may be infringed by your derivative works or by other
- works in which the Apple Software may be incorporated.
- The Apple Software is provided by Apple on an "AS IS" basis. APPLE
- MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION
- THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS
- FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND
- OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS.
- IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL
- OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
- SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
- INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION,
- MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED
- AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE),
- STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE
- POSSIBILITY OF SUCH DAMAGE.
- Copyright (C) 2008 Apple Inc. All Rights Reserved.
- */
- #import <Foundation/Foundation.h>
- #import <sqlite3.h>
- @interface Book : NSObject {
- // Opaque reference to the underlying database.
- sqlite3 *database;
- // Primary key in the database.
- NSInteger primaryKey;
- // Attributes.
- NSString *title;
- NSDate *copyright;
- NSString *author;
- // Internal state variables. Hydrated tracks whether attribute data is in the object or the database.
- BOOL hydrated;
- // Dirty tracks whether there are in-memory changes to data which have no been written to the database.
- BOOL dirty;
- NSData *data;
- }
- // Property exposure for primary key and other attributes. The primary key is 'assign' because it is not an object,
- // nonatomic because there is no need for concurrent access, and readonly because it cannot be changed without
- // corrupting the database.
- @property (assign, nonatomic, readonly) NSInteger primaryKey;
- // The remaining attributes are copied rather than retained because they are value objects.
- @property (copy, nonatomic) NSString *title;
- @property (copy, nonatomic) NSDate *copyright;
- @property (copy, nonatomic) NSString *author;
- // Finalize (delete) all of the SQLite compiled queries.
- + (void)finalizeStatements;
- // Creates the object with primary key and title is brought into memory.
- - (id)initWithPrimaryKey:(NSInteger)pk database:(sqlite3 *)db;
- // Inserts the book into the database and stores its primary key.
- - (void)insertIntoDatabase:(sqlite3 *)database;
- // Brings the rest of the object data into memory. If already in memory, no action is taken (harmless no-op).
- - (void)hydrate;
- // Flushes all but the primary key and title out to the database.
- - (void)dehydrate;
- // Remove the book complete from the database. In memory deletion to follow...
- - (void)deleteFromDatabase;
- @end