Chapter 7 - Storage
This is the fifth of eight chapters that discuss the OpenDoc programming interface in detail. This chapter describes the external storage facilities OpenDoc uses and provides. OpenDoc relies on a system of persistent storage that is built upon the native file-storage facilities of each of the individual OpenDoc platforms. The same fundamental storage concepts and structures are used consistently for document storage and for data transfer (clipboard transfer, drag and drop, and linking, described in the next chapter).Before reading this chapter, you should be familiar with the concepts presented in Chapter 1, "Introduction to OpenDoc," and Chapter 2, "Development Overview." For additional concepts related to your part editor's runtime environment, see Chapter 11, "OpenDoc Runtime Features."
This chapter introduces the general architecture of the OpenDoc storage system, including how parts are stored, and then describes how your OpenDoc part editor can use that architecture to store and retrieve its own content.
Chapter Contents
- The OpenDoc Storage System
- Storage Units, Properties, and Values
- Storage-Unit Organization
- Standard Properties
- Creating Properties and Values
- Focusing a Storage Unit
- Manipulating the Data in a Value
- Iterating Through a Storage Unit
- Removing Properties and Values
- Storage-Unit IDs
- Persistent References
- Persistent References in OpenDoc
- Creating Persistent References
- Persistent References and Cloning
- Main and Auxiliary Storage Units
- Prefocused Access With Storage-Unit Views
- Documents, Drafts, and Parts
- Drafts
- Storage Model for Parts
- What a Draft Contains
- Info Properties
- Container Properties
- Creating a New Document
- Reading and Writing Your Part
- Initializing and Reading a Part From Storage
- The somInit Method
- The InitPart Method
- The InitPartFromStorage Method
- Writing a Part to Storage
- The Externalize Method
- The ExternalizeKinds Method
- Creating Additional Storage Units
- Storing and Retrieving Display Frames
- Storing and Retrieving Embedded Frames
- Reading and Writing Part Info
- Changing Your Part's Content
- Adding an Embedded Part
- Removing an Embedded Part
- Making Content Changes Known
- Closing Your Part
- The ReleaseAll Method
- The somUninit Method
Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help