Documentation Archive Developer
Search
PATH  WebObjects 4.0 Documentation > EOAccess Reference





The EOAccess Framework

Framework:
/System/Library/Frameworks/EOAccess.framework

Header File Directories:
/System/Library/Frameworks/EOAccess.framework/Headers

Introduction

The EOAccess framework is one of a group of frameworks known collectively as the Enterprise Objects Framework. The classes and protocols that make up the EOAccess framework allow your applications to interact with database servers at a high level of abstraction. These classes make up what is known as the access layer. The access layer is divided into two main parts:

Working with the access layer allows you to have a finer level of control over database operations.


EOAccess Framework Class Hierarchy

The EOAccess class hierarchy is rooted in the Foundation Framework's NSObject class (see Figure 1). The remainder of the EOAccess Framework consists of several related groups of classes, a few miscellaneous classes, and a number of protocols.

Figure 1 The EOAccess Framework class hierarchy


The Database Level

The database level is where enterprise objects are created from the dictionaries retreived by the adaptor level. It's also where snapshotting is performed. The database level is primarily made up of the following classes:


The Adaptor Level

The adaptor level deals with database rows packaged as dictionaries. The adaptor level is primarily made up of the following classes:


The Modeling Classes

A model defines, in entity-relationship terms, the mapping between enterprise object classes and a database. The following are the principal modeling classes in the EOAccess framework:


Faulting

These classes implement or are used to implement object faulting:

EOAccessArrayFaultHandler is a subclass of EOAccessGenericFaultHandler that implements a fault for an array of enterprise objects.

EOAccessFaultHandler is a subclass of EOAccessGenericFaultHandler that implements an object fault for enterprise objects.

EOAccessGenericFaultHandler is an abstract class that helps an EOAccessFault to fire by fetching data using an EODatabaseContext.


Additions to Other Frameworks

The EOAccess framework adds methods to a number of classes in different frameworks:

EOGenericRecord Additions adds one method to the control layer's class, for returning a generic record's associated EOEntity.

EOObjectStoreCoordinator Additions adds two methods to the EOControl class for accessing the coordinator's EOModelGroup.

EOQualifier Additions adds one method to the class, for "rerooting" a qualifier to another entity.

NSString Additions adds two methods to the class, to convert modeling object names to database schema names, and database schema names to modeling object names


Miscellaneous Classes

The EOAccess framework also has a number of other useful classes, including:


Delegates

A number of EOAccess classes delegate behavior. The delegate methods are defined in these Objective-C protocols:


Miscellaneous Protocols



[TOC] [Prev] [Next]

Copyright © 1998, Apple Computer, Inc. All rights reserved.