Serialisierung: Erstellen einer serialisierbaren Klasse
Fünf Hauptschritte sind erforderlich, um eine Klasse serialisierbar zu machen. Sie sind nachfolgend aufgeführt und erläutert in den folgenden Abschnitten:
Ableiten der Klasse von CObject (oder von einer Klasse abgeleitet von CObject).
Überschreiben der serialisierensmemberfunktion.
Verwenden des DECLARE_SERIAL-Makros in der Klassendeklaration.
Ein Konstruktor definieren, der keine Argumente akzeptiert.
Verwenden des IMPLEMENT_SERIAL-Makros in der Implementierungsdatei für die Klasse.
Wenn Sie Serialize direkt anstatt von Operatoren und >> << von CArchive aufrufen, werden die letzten drei Schritte nicht für Serialisierung erforderlich.
Ableiten der Klasse von CObject
Das grundlegende Serialisierungsprotokoll und Funktionen werden in der CObject-Klasse definiert. Indem Sie die Klasse von CObject (oder einer Klasse abgeleitet von CObject), wie in der folgenden Deklaration der Klasse CPerson angezeigt werden, rufen Sie den Serialisierungsprotokoll und die Funktionalität von CObject zugreifen.
Überschreiben der serialisierens-Memberfunktion
Die Memberfunktion Serialize, die in der CObject-Klasse definiert ist, ist für die Daten tatsächlich serialisieren zuständig, die erforderlich sind, um den aktuellen Zustand eines Objekts aufzuzeichnen. Die Funktion Serialize verfügt über ein Argument CArchive, das verwendet, die zum Lesen und schreibt die Objektdaten. CArchive Das Objekt verfügt über eine Memberfunktion, IsStoring, die angibt, ob Serialize speichert (Protokoll) oder (Laden Lesendaten). Verwenden der IsStoring Ergebnisse als Leitfaden, fügen Sie entweder die Daten des Objekts im CArchive-Objekt mit dem Einfügungsoperator (<<) oder die Auszugdaten mit dem Extraktionsoperator ein (>>).
Erwägen Sie eine Klasse, die von CObject abgeleitet und zwei neue Membervariablen verfügt, Typen CString und WORD. Im folgenden Klassendeklarationsfragment zeigt die neue Membervariablen und die Deklaration für die überschriebene Serialize-Memberfunktion an:
class CPerson : public CObject
{
public:
DECLARE_SERIAL( CPerson )
// empty constructor is necessary
CPerson();
virtual ~CPerson();
CString m_name;
WORD m_number;
void Serialize( CArchive& archive );
};
Um die serialisierensmemberfunktion überschreiben
Rufen Sie die Basisklassenversion von Serialize auf, um zu überprüfen, ob der geerbte Teil des Objekts serialisiert wird.
Einfügen oder Extrahieren Sie die Membervariablen, die der Klasse bestimmt sind.
Die Datensätze einfügen und Extraktionsoperatoren interagieren mit der Archivklasse, um die Daten zu lesen und zu schreiben. Das folgende Beispiel zeigt, wie Serialize für die CPerson-Klasse implementiert, die oben deklariert wird:
void CPerson::Serialize( CArchive& archive ) { // call base class function first // base class is CObject in this case CObject::Serialize( archive ); // now do the stuff for our specific class if( archive.IsStoring() ) archive << m_name << m_number; else archive >> m_name >> m_number; }
Sie können die CArchive::Read und CArchive::Write-Memberfunktionen auch verwenden, um große Mengen der nicht typisierten Daten lesen und schreiben.
Verwenden des DECLARE_SERIAL-Makros
Das Makro ist DECLARE_SERIAL in der Deklaration von Klassen, die die Serialisierung unterstützen, wie hier gezeigt erforderlich:
class CPerson : public CObject
{
public:
DECLARE_SERIAL( CPerson )
Definieren eines Konstruktor ohne Argumente
MFC benötigt einen Standardkonstruktor, wenn die Objekte erneut erstellt, die deserialisiert werden (vom Datenträger geladen). Der Deserialisierungsprozess füllt alle Membervariablen mit den Werten aus, die erforderlich sind, das Objekt neu zu erstellen.
Dieser Konstruktor kann deklariert werden öffentlich, geschützt wurde, oder privat. Wenn Sie ihn geschützt oder als privat machen, unterstützen Sie, sicherzustellen, dass er nur durch die Serialisierungsfunktionen verwendet wird. Der Konstruktor muss das Objekt in einen Zustand versetzt werden, der bei Bedarf können gelöscht werden es.
Hinweis
Wenn Sie vergessen, einen Konstruktor ohne Argumente in einer Klasse definiert, die DECLARE_SERIAL und IMPLEMENT_SERIAL für Makros verwendet, rufen Sie eine "keine" verfügbaren Compilerwarnung des Standardkonstruktors in der Zeile ab, in der das IMPLEMENT_SERIAL-Makro verwendet wird.
Verwenden des IMPLEMENT_SERIAL-Makros in der Implementierungsdatei
Das Makro IMPLEMENT_SERIAL wird verwendet, um die verschiedenen erforderlichen Funktionen zu definieren, wenn eine serialisierbare Klasse von CObject ableiten. Sie verwenden dieses Makro in der Implementierungsdatei (.CPP) für die Klasse. Die ersten beiden Argumente in Makro sind der Name der Klasse und den Namen seiner unmittelbaren Basisklasse.
Das dritte Argument zu diesem Makro ist ein Schemazahl. Die Schemazahl ist im Wesentlichen eine Versionsnummer für Objekte der Klasse. Verwenden Sie eine ganze Zahl größer oder gleich 0 für die Schemazahl. (Verwechseln Sie diese Schemazahl nicht mit Datenbankterminologie.)
Die MFC-Serialisierungscode-überprüfungen die Schemazahl, wenn Objekte in den Arbeitsspeicher gelesen werden. Wenn die Schemazahl des Objekts auf der Festplatte nicht die Schemazahl der Klasse im Arbeitsspeicher übereinstimmt, löst die Bibliothek CArchiveException aus und verhindert das Programm am Lesen einer falschen Version des Objekts.
Wenn Sie Ihre Serialize-Memberfunktion in der Lage sein sollen, mehrere Versionen zu lesen - d. h, Dateien geschrieben in unterschiedlichen Versionen der Anwendung - Sie können den Wert VERSIONABLE_SCHEMA als Argument für das Makro IMPLEMENT_SERIAL verwenden. So Verwendungsinformation und ein Beispiel finden Sie die GetObjectSchema-Memberfunktion der Klasse CArchive.
Das folgende Beispiel zeigt, wie IMPLEMENT_SERIAL für eine Klasse, CPerson verwendet, die von CObject abgeleitet wurde:
IMPLEMENT_SERIAL( CPerson, CObject, 1 )
Sobald eine serialisierbare Klasse haben, können Sie Objekte der Klasse serialisiert, wie im Artikel Serialisierung: Serialisieren eines Objekts erläutert.