|
|||||||||||
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES |
See:
Description
Interface Summary | |
CompoundFilter | CompoundFilters are used to AND or OR multiple filters together. |
ConnectionSource | ConnectionSource |
DataAssociation | This is used to represent the relationship between two objects. |
DataAssociationCursor | DataAssociationCursor - This is used to allow developers to iterate through the objects within an association and get properties for those objects. |
DataCollection | The DataCollection interface defines the public methods available on a collection of DataObjects. |
DataObject | Defines the public methods of Data Objects. |
DataQuery | An instance of the DataQuery class may be used to access the results of a named query. |
Filter | Filter is used to restrict the results of a query. |
FilterFactory | FilterFactory is the interface that dictates the methods needed by factories to hand out filters |
SQLUtilities | This is the interface for random SQL utilities that are needed to allow the system to work with different databases. |
TransactionListener | A simple listener to allow tasks to be performed after a transaction is committed or rolled back. |
Class Summary | |
AbstractTransactionListener | AbstractTransactionListener is a default implementation of TransactionListener . |
DataHandler | The DataHandler can be used to override the behavior of the persistence layer when it performs certain operations. |
DataObserver | DataObserver |
DataOperation | Used to allow the user to control execution of a named DML event (a data operation, in PDL). |
DataQueryDataCollectionAdapter | Adapter to make a data query look like a data collection. |
DataQueryDecorator | Decorate a data query so that its behavior can be changed and additional methods can be added to a stock data query. |
DedicatedConnectionSource | DedicatedConnectionSource |
GenericDataQuery | GenericDataQuery |
Initializer | Initializer loads UDCTs. |
OID | An OID represents a unique object ID. |
PooledConnectionSource | PooledConnectionSource |
Session | All persistence operations take place within the context of a session. |
SessionManager | The SessionManager is a purely static class that allows users to retrieve the current Session. |
TransactionContext | Title: TransactionContext class This class is intentionally NOT threadsafe; it should not be shared across threads. |
TransactionListenerImpl | Deprecated. |
Utilities | Utilities |
Exception Summary | |
FlushException | An exception representing the inability to write all changes to the database. |
ObjectDeletedException | ObjectDeletedException |
PersistenceException | PersistenceException |
UndefinedEventException | UndefinedEventException - Thrown when the persistence system attempts to invoke an event, such as a property retrieve event, which is undefined. |
The classes in this package provide an API for creating and manipulating Data Objects. These classes fall into two categories. The External Interfaces which are used by code outside the persistence layer to create, retrieve, and manipulate data objects and queries.
The DataObject interface is how a DataObject presents itself for use to code outside the persistence layer. This interface represents a single data object. It may be used to modify the properties of the data object and retrieve any DataAssociations the data object may have.
The DataAssociation interface is what a
DataObject returns when its getProperty() method is
called with the name of a role. The DataAssociation
interface may be used to add and remove items from the association.
It also has a method, cursor
, that returns
a DataAssociationCursor
object that allows
the programmer to iterate through the objects (and associated
LinkAttributes) associated with the parent DataObject.
This interface is similar to DataAssociationCursor, in that it allows you to iterate through a collection of objects, but the collection need not represent an association between two objects.
This interface is used to access the results of a free form query against the object model, such as might be necessary in order to generate a complicated report. It also allows the developer to write free-form queries that return data objects. This is useful for situations where the standard persistence events do not do exactly what is desired or do not provide the needed performance optimizations.
This is the interface used to allow user's to filter the results returned by DataQueries, DataCollections, and DataAssociationCursors. It allows user's to set a condition and set values for bind variables used within those conditions.
This creates various types of filters, including filters that can be combined together. While Filter's can only contain a specific condition, the FitlerFactory has the ability to return CompoundFilters that an combine fitlers with each other. It also has many convenience methods that allow users to create filters without worrying about which database is being used (using them eliminates oracle's problem with "null" values).
An OID describes a given DataObject. Specifically, it holds the type of the data object so that the persistence system knows which object type to use when persistening the object and it also holds values for key properties so that the system knows which values to use to identify the specific row represented by the object.
The Link class is used to represent the relationship between two object types. This is the same terminology that is used within UML. Links may contain properties (e.g. the property isDefault could be used to indicate whether this is the defaut link for the object).
All persistence operations take place within the context of a session. The operational persistence methods operate on the object types and associations defined in the Persistence Definition Langauge (PDL) files. The Session object has the operational methods for creating and retrieving data objects. The APIs that operate on the PDL-defined metadata are in the metadata package. The Session object can be retrieved from the static SessionManager.getSession() method.
This is the context of a given transaction. More concretely, this provides user's with the ability to begin, commite, abort, and rollback transactions. Most developer's will not need to deal with this class as the ACS handles transaction management within its dispatcher.
Sample code can be found in the junit tests for the persistence system under the examples directory.
|
|||||||||||
PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES |