Table of Contents

OIL2 Class Standard.PersistenceService

class Standard . PersistenceService {
        any     dbService;
        int32   delay;
        set     deleteObjs;
        assoc   externalKeyTable;
        assoc   objTable;
        oid     pageInObj;
        string  serviceName;
        oid     serviceOID;
        oid     timerObj;
        set     updateObjs;
} inherits from Object;

DESCRIPTION

The class PersistenceService implements the standard interface between the class PersistentObject and a remote object database.

METHODS

Standard.PersistenceService:create

PersistenceService:create(optional any qualifiedName)

Method Description

The optional argument qualifiedName can be used to permit the use of multiple PersistenceService databases. If no qualifiedName is specified, the PersistenceService object is registered as the local well-known service /ObjectPager.

Standard.PersistenceService:databaseConnected

PersistenceService:databaseConnected(any objIDorName)

Method Description

When an external object database process connects to the local Object Management Environment, it sends the /ObjectPager service a databaseConnected message and passes the object Id or well-known service that denotes the object database.

Return Value

This method does not return a value.

Standard.PersistenceService:makePersistent

PersistenceService:makePersistent(oid mgmtOID)

Method Description

The makePersistent method registers an object with the PersistenceService, which in turn will issue an addNotifyWhenModified request to subscribe to objectModified / objectDeleted notifications.

Return Value

This method does not return a value.

Standard.PersistenceService:disablePersistence

PersistenceService:disablePersistence(oid mgmtOID)

Method Description

The disablePersistence method unregisters an object with the PersistenceService, which in turn will issue an removeNotifyWhenModified request to the object.

Return Value

This method does not return a value.

Standard.PersistenceService:objectModified

PersistenceService:objectModified(oid obj)

Method Description

After a PersistentObject has registered itself with the PersistenceService, it will send objectModified notifications every time it has been modified. Upon receipt of such a notification, the PersistenceService will schedule an update of the object's state in the object database.

Return Value

This method does not return a value.

Standard.PersistenceService:objectDeleted

PersistenceService:objectDeleted(oid obj)

Method Description

After a PersistentObject has registered itself with the PersistenceService, it will send objectDeleted notifications when it is deleted. Upon receipt of such a notification, the PersistenceService will remove the record of the object's state in the object database.

Return Value

This method does not return a value.

Standard.PersistenceService:objectFault

PersistenceService:objectFault(oid obj, string methodName, array args, any fromInfo)

Method Description

The objectFault method handles the reflection of method invocation against a paged-out object. It retrieves the object's contents from the object database and then issues the reflected method invocation.

Return Value

Like all reflection handlers, this method does not return a value.