SAP OS PERSISTENCE REFS documentation, setup help and example usage

ARTICLE

Persistent Object References
At runtime, the persistence service works with the instances of persistent classes, which are generally addressed and kept alive using references (as in ABAP objects). If a reference to a persistent object is to be persisted beyond the runtime of an ABAP program (for example, to work with the same object later in another ABAP program), it must be saved persistently.
To save this information in a database, two table fields of the type OS_GUID are needed. The first field contains the class GUID
generated when the persistent class is created, while the second contains the instance GUID that provides the unique global identifier for the object and its values. Both of these together form an
object ID (or OID ). References to objects of persistent classes that are defined by mappings and business keys cannot be saved in this way since they do not have an instance GUID .
Both fields of an OID of this type can be mapped to a single attribute of a persistent class. This attribute provides a reference to the relevant persistent object. The Persistence Service then handles this reference � which is not a reference variable in the original ABAP objects sense. It also loads the persistent object (to which the reference points) from the database.
Creating these two fields for the class GUID and the instance GUID does not make sense unless the tables are used as the basis for a persistent class. The most common use for this technique is to save references to other persistent objects in a persistent object accessed by a semantic key (business key), where these other objects are managed by instance GUID s, and cannot be accessed otherwise (that is, where objects are closely interlinked).

Note
When a persistent object is loaded that contains a reference to another persistent object as an attribute, an instance is created in the memory for the latter, but its persistent attributes are only loaded when required and not straight away.