Ein Tuple von Datensatz und Objekt-ID. Mehr ...

#include <GloObjIDRecordTuple.h>

Öffentliche Methoden
	ObjIDRecordTuple (const ObjID &rObjID)

	ObjIDRecordTuple (const ObjID &rObjID, Record *pRecord)

	ObjIDRecordTuple (const ObjIDRecordTuple &rT)

	ObjIDRecordTuple (Record *pRecord)

virtual	~ObjIDRecordTuple ()

ObjID	getObjID () const

bool	getRecord (Record *&prRetVal) const

bool	hasRecord () const

ObjIDRecordTuple &	operator= (const ObjIDRecordTuple &)

int	setObjID (const ObjID &rObjID)

int	setRecord (Record *pRecord)

void	unsetRecord ()


bool	operator== (const ObjIDRecordTuple &rT) const

bool	operator!= (const ObjIDRecordTuple &rT) const

bool	operator> (const ObjIDRecordTuple &rT) const

bool	operator>= (const ObjIDRecordTuple &rT) const

bool	operator< (const ObjIDRecordTuple &rT) const

bool	operator<= (const ObjIDRecordTuple &rT) const

Private Methoden
	ObjIDRecordTuple ()

Private Attribute
ObjID	m_ObjID

Record *	m_pRecord

Ausführliche Beschreibung

Ein Tuple von Datensatz und Objekt-ID.

Warum die Objekt-ID welche ja auch im Datensatz vorhanden sein kann?

Um den Datentransfer zwischen Client/Server nicht mit doppelten Datensätzen zu belasten, werden bei Übertragungen Objekte dieser Klasse übertragen. Wenn ein Datensatz schon in der Übertragung ist, wird nur die ObjID eingetragen. Das kommt u.a. dann zum Tragen, wenn ein persistentes Objekt ein anderes mehrfach referenzierte.

Copyright: © 2010 Helmut Jakoby

Autor: Helmut Jakoby

Beschreibung der Konstruktoren und Destruktoren

◆ ObjIDRecordTuple() [1/5]

glo::ObjIDRecordTuple::ObjIDRecordTuple ( )

private

Der Standard-Konstruktor steht nicht zur Verfügung.

◆ ObjIDRecordTuple() [2/5]

glo::ObjIDRecordTuple::ObjIDRecordTuple ( const ObjID & rObjID )

Konstruktor mit Parameterübergabe.

Parameter

[in] rObjID Es wird eine gültige Objekt-ID erwartet.

Ausnahmebehandlung

eut::ErrorNException Bei einem Fehler wird eine Exception geworfen.

◆ ObjIDRecordTuple() [3/5]

glo::ObjIDRecordTuple::ObjIDRecordTuple ( Record * pRecord )

Konstruktor mit Parameterübergabe.

Parameter

[in] pRecord Es wird ein gültiger Datensatz erwartet. Es wird der Referenzzähler des Datensatzes inkrementiert.

Ausnahmebehandlung

eut::ErrorNException Bei einem Fehler wird eine Exception geworfen.

◆ ObjIDRecordTuple() [4/5]

glo::ObjIDRecordTuple::ObjIDRecordTuple	(	const ObjID &	rObjID,
		Record *	pRecord )

Konstruktor mit Parameterübergabe.

Parameter

[in]	rObjID	Es wird eine gültige Objekt-ID erwartet.
[in]	pRecord	Es wird ein gültiger Datensatz erwartet. Dessen Objekt-ID muss mit der übergebenen Objekt-ID übereinstimmen. Es wird der Referenzzähler des Datensatzes inkrementiert.

Ausnahmebehandlung

eut::ErrorNException Bei einem Fehler wird eine Exception geworfen.

◆ ObjIDRecordTuple() [5/5]

glo::ObjIDRecordTuple::ObjIDRecordTuple ( const ObjIDRecordTuple & rT )

Copy-Konstruktor.

Parameter

[in] rT Von diesem Objekt werden die Daten übernommen.

◆ ~ObjIDRecordTuple()

virtual glo::ObjIDRecordTuple::~ObjIDRecordTuple ( )

virtual

Destruktor. Es wird der Referenzzähler des referenzierten Datensatzes dekrementiert.

Dokumentation der Elementfunktionen

◆ getObjID()

ObjID glo::ObjIDRecordTuple::getObjID ( ) const

Liefert die Objekt-ID.

Rückgabe: Die Objekt-ID.

◆ getRecord()

bool glo::ObjIDRecordTuple::getRecord ( Record *& prRetVal ) const

Liefert, wenn vorhanden, den referenzierten Datensatz.

Parameter

[in,out] prRetVal Wenn vorhanden, der referenzierte Datensatz.

Rückgabe: Wenn true, dann wurde ein Datensatz geliefert.

Achtung: Die aufrufende Instanz muss das gelieferte Objekt mittels Record::forget() aus dem Speicher entfernen.

◆ hasRecord()

bool glo::ObjIDRecordTuple::hasRecord ( ) const

Prüft, ob ein Record in m_pRecord referenziert wird.

Rückgabe: Wenn true, wird ein Record referenziert.