CL_ABAP_MEMORY_AREA 

Gemeinsame Oberklasse aller Gebietsklassen. Diese Klasse enthält allgemeine Methoden für Gebietshandles.

 

Statische Methoden

 

GET_HANDLE_BY_OREF

Diese Methode gibt das Gebietshandle zu einer Instanz einer Klasse zurück. Die Instanz kann im im Shared Memory oder im internen Modus vorliegen.

Eingabeparameter

·        OREF vom Typ REF TO OBJECT

Referenz auf die Instanz einer Klasse.

Rückgabewert

·        HANDLE vom Typ REF TO CL_ABAP_MEMORY_AREA

Referenz auf das Gebietshandle der entsprechenden Gebietsinstanzversion. Wegen der Typisierung ist diese Referenz im Wesentlichen nur für die Erzeugung von Objekten geeignet.

 

GET_HANDLE_BY_DREF

Diese Methode gibt das Gebietshandle zu einem Datenobjekt zurück (ab Release 7.10). Das Datenobjekt kann im im Shared Memory oder im internen Modus vorliegen.

Eingabeparameter

·        DREF vom Typ REF TO DATA

Referenz auf ein Datenobjekt im Shared Memory.

Rückgabewert

·        HANDLE vom Typ REF TO CL_ABAP_MEMORY_AREA

Referenz auf das Gebietshandle der entsprechenden Gebietsinstanzversion. Wegen der Typisierung ist diese Referenz im Wesentlichen nur für die Erzeugung von Objekten geeignet.

 

GET_HANDLE_BY_DATA

Diese Methode gibt das Gebietshandle zu einem Datenobjekt zurück (ab Release 7.10). Das Datenobjekt kann im im Shared Memory oder im internen Modus vorliegen.

Eingabeparameter

·        DATAOBJECT vom Typ ANY

Datenobjekt im Shared Memory. Kann beispielsweise als Feldsymbol angegeben werden, das auf ein dereferenziertes Datenobjekt des Shared Memory zeigt.

Rückgabewert

·        HANDLE vom Typ REF TO CL_ABAP_MEMORY_AREA

Referenz auf das Gebietshandle der entsprechenden Gebietsinstanzversion. Wegen der Typisierung ist diese Referenz im Wesentlichen nur für die Erzeugung von Objekten geeignet.

 

Instanzmethoden

 

IS_SHARED

Diese Methode überprüft, ob das Gebietshandle eine Gebietsinstanzversion im Shared Memory oder den aktuellen internen Modus repräsentiert

Rückgabewert

·        SHARED vom Typ ABAP_BOOL

ABAP_TRUE, wenn eine Gebietsinstanzversion im Shared Objects Memory repräsentiert wird, und ABAP_FALSE, wenn der aktuelle interne Modus repräsentiert wird.

 

IS_VALID

Diese Methode überprüft, ob über das Gebietshandle auf eine Gebietsinstanzversion im Shared Memory oder den aktuellen internen Modus zugegriffen werden kann.

Rückgabewert

·        VALID vom Typ ABAP_BOOL

ABAP_TRUE, wenn über das Gebietshandle auf eine Gebietsinstanzversion oder den aktuellen internen Modus zugegriffen werden kann, andernfalls ABAP_FALSE.

 

IS_ACTIVE_VERSION

Diese Methode überprüft, ob das Gebietshandle auf die aktive Gebietsinstanzversion zeigt.

Rückgabewert

·        ACTIVE_VERSION vom Typ ABAP_BOOL

ABAP_TRUE, wenn die aktuelle Gebietsinstanzversion oder der interne Modus repräsentiert wird. ABAP_FALSE, wenn eine veraltete Gebietsinstanzversion repräsentiert wird, das Gebietshandle bereits freigegeben wurde oder wenn es sich um ein Änderungshandle handelt.

 

HAS_ACTIVE_PROPERTIES

Diese Methode überprüft, ob die aktuellen dynamischen Eigenschaften des Gebiets mit den Eigenschaften der repräsentierten Gebietsinstanzversion übereinstimmen:

Rückgabewert

·        ACTIVE_PROPERTIES vom Typ ABAP_BOOL

ABAP_TRUE, wenn die dynamischen Eigenschaften des Gebiets nach Beginn des Aufbaus der aktuelle Gebietsinstanzversion nicht geändert wurden oder der aktuelle interne Modus repräsentiert wird. Andernfalls oder wenn das Gebietshandle bereits freigegeben wurde, ABAP_FALSE.

 

GET_DETACH_INFO

Diese Methode ermittelt den Grund für ein ungültiges Gebietshandle (ab Release 7.10).

Rückgabewert

·        DETACH_INFO vom Typ SHM_DETACH_INFO

Der Rückgabewert kann mit einer der folgenden Konstanten der Klasse CL_ABAP_MEMORY_AREA verglichen werden.

DETACH_INFO_NOT_DETACHED	Das Gebietshandle ist noch gültig. Dieser Wert wird auch zurückgegeben, wenn auf dem Gebietshandle ein Commit fehlgeschlagen, aber noch kein Rollback erfolgt ist. Außerdem wird dieser Wert zurückgegeben, wenn der aktuelle interne Modus repräsentiert wird.
DETACH_INFO_HANDLE	Die Lese- bzw. Änderungssperre wurde explizit mit  einer der Methoden DETACH, DETACH_COMMIT oder DETACH_ROLLBACK freigegeben
DETACH_INFO_AREA	Die Lese- bzw. Änderungssperre wurde durch eine der Methoden DETACH_AREA oder DETACH_ALL_AREAS aufgehoben.
DETACH_INFO_ATTACH	Die Lesesperre wurde durch die Methode ATTACH_FOR_WRITE aufgehoben, wobei an den Parameter ATTACH_MODE die Konstante CL_SHM_AREA=>ATTACH_MODE_DETACH_READER übergeben wurde.
DETACH_INFO_INVALIDATE	Die Änderungssperre wurde durch eine Methode INVALIDATE_... aufgehoben, wobei an den Parameter TERMINATE_CHANGER die Konstante ABAP_TRUE übergeben wurde.
DETACH_INFO_PROPAGATE	Die Änderungssperre wurde durch eine Methode PROPAGATE_... aufgehoben.
DETACH_INFO_FREE	Die Lese- bzw. Änderungssperre wurde durch eine Methode FREE_... aufgehoben.