Ansicht
Dokumentation

CL_ABAP_DB_X_LOCATOR - Lokator für einen binären LOB

TXBHW - Original Tax Base Amount in Local Currency ABAP Short Reference
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Die Klasse CL_ABAP_DB_X_LOCATOR realisiert den Zugriff über einen Lokator auf einen binären LOB einer Datenbanktabelle. Ein Lokator repräsentiert einen Zeiger auf die LOB-Daten. Mit einem Lokator ist es beispielsweise möglich, nach einer gewissen Suchfolge in den LOB-Daten zu suchen. Eine Instanz der Klasse CL_ABAP_DB_X_LOCATOR kann nur über eine SELECT-Anweisung erzeugt werden. Die Daten des LOBs werden hierbei nicht auf den Applikationsserver übertragen. Eine Instanz dieser Klasse kann auch als Eingabe für eine Änderungsoperation auf eine binäre LOB-Spalte dienen. Die LOB-Daten, auf die der Lokator zeigt, werden so in die bei der Änderungsoperation spezifizierte Spalte übertragen, ohne dass die LOB-Daten auf dem Applikationsserver materialisiert werden müssen.

Weiterführende Informationen

Die Klasse CL_ABAP_DB_X_LOCATOR implementiert die folgenden Methoden:

Beispiel

Die Datanbanktabelle dbtab habe ein ganzzahliges Schlüsselfeld k1 und eine binäre LOB-Spalte blob1.

data: x_loc type ref to cl_abap_db_x_locator,

len type abap_msize, xstr type xstring.

select single blob1 from dbtab into x_loc where k1 = 1.

if sy-subrc = 0.

len = x_loc->get_length( ).

if len > 0.

len = len div 2.

xstr = x_loc->get_bytes( offset = 0 length = len ).

write: /'First half of xstring = ', xstr.

else.

write: /'Initial xstring found'.

endif.

x_loc->close( ).