Ansicht
Dokumentation

CL_ISHMED_PROPERTY_BAG - IS-H*MED: Persistente Ablage des Objektzustands

PERFORM Short Reference   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Die Klasse CL_ISHMED_PROPERTY_BAG realisiert eine Programmierschnittstelle (API) für die temporäre Ablage von Attributwerten eines Objekts. Die Ablage erfolgt transaktionsübergreifend transient im SAP Shared Buffer oder persistent in der Clusterdatenbank INDX. Der Objektzustand (aktuelle Werte) wird durch die identische Transformation id als XML Strom serialisiert und gespeichert. Der XML Strom dient beim Laden des Objekts als Beschreibung für die Instanzierung eines Objekts vom gleichen Typ mit den gespeicherten Werten (Deserialisierung).

Einzige Voraussetzung für die Verwendung der API ist, dass das Objekt serialisierbar ist.

Beziehungen

Objekte der Klasse sind serialisierbar, wenn sie das Interface IF_ISHMED_SERIALIZEABLE implementiert.
Die identische Transformation id wird in der Sprachbeschreibung zum Befehl CALL TRANSACTION erläutert.

Beispiel

siehe Beispielprogramm RN2_ISHMED_PROPERTY_BAG_DEMO

Hinweise

Property Bag Objekte werden durch einen anwendungsbezogenen zeichenartigen Schlüssel <id> identifiziert und sind temporär. Transiente Objektablagen haben eine maximale Lebensdauer von einem Tag.
Property bag Objekt können benutzerbezogen angelegt und über einen Sperrmechanismus mit der Methode LOCK vor Fremdzugriffen geschützt werden. Alle gesetzten Sperren müssen mit der Methode UNLOCK wieder entfernt werden.
Das Ablegen eines Property bags mit der Methode SAVE oder EXPORT_TO_MEMORY verpflichtet auch zum expliziten Löschen mit DELETE. Zeitlich abgelaufene Property bags werden mit der ersten Verwendung der API automatisch aus der persistenten Ablage (Datenbanktabelle INDX) entfernt.

Weiterführende Informationen

siehe identische Transformation in CALL TRANSFORMATION

PERFORM Short Reference   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 2129 Date: 20240419 Time: 214025     sap01-206 ( 41 ms )