com.objy.db.iapp
Interface Persistent

All Known Subinterfaces:

IooObj, PersistentEvents

public interface Persistent

Defines the behavior shared by all persistent objects.

The Persistent interface provides implicit persistence behavior. Its methods give access to an object's persistor; Objectivity for Java uses the persistor to perform persistent operations on the object.

Defining a Persistence-Capable Class Using Persistent

To define a persistence-capable class with the minimal public API, you define a class that implements the Persistent interface. Your class must provide a mechanism for getting and setting an object's persistor.

• Objectivity for Java calls the persistent object's setPersistor method to set the object's persistor. Your implementation of setPersistor should cache the specified persistor.

• A persistent object's getPersistor method returns the object's persistor. Your implementation of getPersistor should return the persistor cached by the most recent call to setPersistor, or null if setPersistor has never been called.

If you desire, you can also implement public or private methods to perform persistence operations explicitly; see Providing Explicit Persistence Behavior.

Related Classes and Interfaces

Alternative ways to define a persistence-capable class are:

• Define a descendant class of ooObj. The class inherits default implementations for public methods that get and set an object’s persistor, that perform persistence operations explicitly, and that handle persistent events. You do not need to implement any persistence behavior unless you want to modify the default implementation.

• Implement the IooObj interface, which provides public methods to get and set an object’s persistor, to perform persistence operations explicitly, and to handle persistent events. You must implement all these methods.

• Implement the PersistentEvents interface, which has public methods to get and set the persistor and to handle persistent events; you need to implement those methods. If you desire, you can also implement public or private methods to perform persistence operations explicitly.

For additional information, see Defining Persistence-Capable Classes.

Method Summary

PooObj	getPersistor() Gets the object providing persistence behavior for this object.
void	setPersistor(PooObj persistor) Sets the object providing persistence behavior for this object.

Method Detail

getPersistor

public PooObj getPersistor()

Gets the object providing persistence behavior for this object.

Returns:

This object's persistor.

setPersistor

public void setPersistor(PooObj persistor)

Sets the object providing persistence behavior for this object.

Parameters:

persistor - The object providing persistence behavior for this object.

You should not call this method directly.