CX_DB_UTILITY::DumpCollection

CX_DB_UTILITY::DumpCollection

Beschreibung:

Diese Methode schreibt die Objekt-Ids aller persistenten Objekte der übergebenen Collection (die Collection selbst darf transient sein) in die angegebene Datei und liefert als Rückgabewert die Anzahl der geschriebenen Objekte. Die Datei, die hier geschrieben wird, hat im Gegensatz zu ExportCollection ein Fixed-Record-Format und ist bestens geeignet, um bei sehr vielen Objekten schnell an beliebiger Stelle zu lesen.

223312 
Die Datei hat folgenden Aufbau:

Bis Dll-Version 223312 war die Recordgröße auf 32 Bytes festgelegt, dies war für einige Objektadressen jedoch zu kurz.

Dieses Dateiformat wird aktuell nur von LoadCollectionDump und MoveFrameBatch unterstützt und dient dazu, die MoveFrame-Operation auf einer sehr großen Anzahl von Objekten bei geringem Address-Space (32-Bit) sicher und jederzeit unterbrechbar durchzuführen.

Während die Datei geschrieben wird, wird ein Fortschrittsfenster angezeigt. Wird eine geordnete Collection übergeben (Liste), dann werden die Objekte in der gleichen Reihenfolge in die Datei geschrieben.

Code-Beispiel:

Var(util)
GetManager(OBJECT) Call(GetDBUtility) -> util

objects "CX_SYSTEM_OUT\\objects.coll" util Call(DumpCollection)
"CX_SYSTEM_OUT\\objects.coll" 1000 0 util Call(MoveFrameBatch)

Funktionsaufruf: Call(DumpCollection)