ObjectStore C++ API User Guide

Contents

Preface

Chapter 1

ObjectStore Concepts

Chapter 2

Persistence

Basic Behaviors
- Persistent new() and delete()
- Prerequisites to Persistent Access
- Databases
- Clustering
- Transactions
- Roots and Entry-Point Objects
Requirements for ObjectStore Applications
- Initializing ObjectStore
- Single-Threaded Applications
- Fault Handler Macros for Multithreaded Applications
Creating Databases
- Creating a Database with os_database::create()
- Database Pathnames
- Database Modes
- Automatic Overwrite
- Schema Databases
- Return Value
- Creating Databases with os_database::open()
Destroying Databases with
os_database::destroy()
Opening Databases with os_database::open()
- Opening a Database with os_database::open()
- Database Pathnames
- Opening Read-Only
- Automatic Creation
- Schema Database
- Multiversion Concurrency Control (MVCC)
Closing Databases with os_database::close()
Nested Database Opens
- Nested Opens and Read-Only Access
Determining Database Open Status
Finding a Specified Database
- Pathname Lookup
Rawfs Databases
- Rawfs Host Prefix
- Creating ObjectStore Directories
- Finding a Rawfs Pathname
- Aliases
Persistent new and delete
- Creating Nonarrays with Operator new()
- Creating Arrays with Persistent new()
- Persistent Unions
- Pointers to and from Persistent Memory
- Clustering
Using Typespecs
- Typespecs for Fundamental Types
- Typespecs for Classes
- The os_typespec Constructor
- Parameterized Typespecs
Example: Linked List of Notes
Pointer Validity
- Pointers to Persistent Memory
- Cross-Database Pointers
- Cross-Transaction Pointers
- Pointers to Transient Memory
- Pointer Validity Summary
Basic Clustering
- Transient Allocation
Database Entry Points and Data Retrieval
- When to Use Persistent Names
Establishing Entry Points
- Creating Database Roots
- Setting the Value of a Root
- Clustering of Roots
Retrieving Entry Points
Type Safety for Database Roots
Deleting Database Roots
Application Schemas
- Including a Class in the Application Schema
Database Schemas
- Batch Database Schema Installation
- Incremental Database Schema Installation
- Comparison Between Batch and Incremental Installation
- Timing of Installation
Schema Validation
- Specific Schema Verification Implementation
- Timing of Validation
Creating Segments
Referring Across Databases and Transactions
Cross-Database Pointers and Relative Pathnames
- Default Relative Directory
- Specifying a Relative Directory
- Using Absolute Pathnames
- The oschangedbref Utility
Ensuring Data Access During System Calls

Chapter 3

Transactions

Chapter 4

Notification

Chapter 5

Collections

Chapter 6

Data Integrity

Chapter 7

Database Access Control

Chapter 8

Schema Evolution

Chapter 9

Using Asian Language String Encodings

Chapter 10

Support for the XA Standard for Transaction Processing

Chapter 11

Component Schema

How to Use Component Schema

Index

[next]

Copyright © 1997 Object Design, Inc. All rights reserved.

Updated: 03/31/98 16:51:12