Abstrakte Basisklasse für Persistent und die generische GenericPersistent. Mehr ...

#include <GloBasePersistent.h>

Klassendiagramm für glo::BasePersistent:

[Legende]

Öffentliche Methoden
	BasePersistent ()

	BasePersistent (const BasePersistent &)

virtual void	activate ()

virtual int	assign (Base &rBase)

virtual int	deleteInBase (EnDeepMode eDeepMode=DM_SHALLOW)

virtual unsigned int	forget ()

int	getAllPersAttributeNames (std::list< std::string > &rRetValList, const std::vector< unsigned long > *pClassIdVector=0) const

int	getAllPersAttributeNamesSortByID (std::map< AttributeID, std::string > &rRetValMap, const std::vector< unsigned long > *pClassIdVector=0) const

int	getAllPersAttributes (std::list< BaseRecordAttribute * > &rRetValList, const std::vector< unsigned long > *pClassIdVector=0) const

int	getAllPersAttributes (std::list< std::shared_ptr< BaseRecordAttribute > > &rRetValList, const std::vector< unsigned long > *pClassIdVector=0) const

int	getAllPersAttributesSortByID (std::map< AttributeID, BaseRecordAttribute , std::less< AttributeID > > &rRetValMap, const std::vector< unsigned long > pClassIdVector=0) const

int	getAllPersAttributesSortByID (std::map< AttributeID, std::shared_ptr< BaseRecordAttribute >, std::less< AttributeID > > &rRetValMap, const std::vector< unsigned long > *pClassIdVector=0) const

int	getAllPersAttributesSortByName (std::map< std::string, BaseRecordAttribute , std::less< std::string > > &rRetValMap, const std::vector< unsigned long > pClassIdVector=0) const

int	getAllPersAttributesSortByName (std::map< std::string, std::shared_ptr< BaseRecordAttribute >, std::less< std::string > > &rRetValMap, const std::vector< unsigned long > *pClassIdVector=0) const

virtual int	getClassInfo (ClassInfo *&prClassInfo)

virtual std::time_t	getCreateDate () const =0

virtual unsigned long	getGloClassID () const =0

virtual std::time_t	getLastChangeDate () const =0

unsigned int	getLinkCount () const

virtual ObjID	getObjID () const

int	getPersAttribute (BaseRecordAttribute *&prRetVal, const AttributeID &rAttributeID) const

int	getPersAttribute (BaseRecordAttribute *&prRetVal, const std::string &sName) const

int	getPersAttribute (std::shared_ptr< BaseRecordAttribute > &rRetVal, const AttributeID &rAttributeID) const

int	getPersAttribute (std::shared_ptr< BaseRecordAttribute > &rRetVal, const std::string &sName) const

virtual int	getProcessingPossibilities (LockPossibleSpecification &rLockPossibleSpec, EnDeepMode eDeepMode=DM_SHALLOW) const

int	getRecord (Record *&prRecord) const

int	getRecord (std::shared_ptr< Record > &rRetVal) const

virtual int	getTypeAsString (std::string &rsTypeName) override

virtual bool	isAssigned () const

virtual bool	isDeletedInBase ()

virtual int	isLocked (const LockSpecification &rLockSpecification) const

virtual int	isLocked (EnLockMode eLockMode=LK_DELETEvWRITE, EnDeepMode eDeepMode=DM_SHALLOW) const

virtual int	isPossible (bool bRead, bool bWrite, bool bDelete, EnDeepMode eDeepMode=DM_SHALLOW) const

virtual int	isPossible (const LockPossibleSpecification &rLockPossibleSpec, EnDeepMode eDeepMode=DM_SHALLOW) const

virtual bool	isStored ()

virtual int	lock (const LockSpecification &rLockSpecification)

virtual int	lock (EnLockMode eLockMode=LK_DELETEvWRITE, EnDeepMode eDeepMode=DM_SHALLOW)

BasePersistent &	operator= (const BasePersistent &rT)

virtual int	refresh ()

virtual unsigned int	remember ()

virtual void	removeBase ()

virtual int	setWatch (const WatchSpecification &rWatchSpec)

virtual int	setWatch (TdWatchNotifyMode ulWatchMode, EnDeepMode eDeepMode, CallBack *pCallBack=0)

virtual int	store (EnDeepMode eDeepMode=DM_SHALLOW)

virtual void	takeOverRecord (Record *pRecord)

virtual int	unlock (const LockSpecification &rLockSpecification)

virtual int	unlock (EnLockMode eLockMode=LK_DELETEvWRITE, EnDeepMode eDeepMode=DM_SHALLOW)

virtual int	unsetWatch (const WatchSpecification &rWatchSpec)

virtual int	unsetWatch (TdWatchNotifyMode ulWatchMode, EnDeepMode eDeepMode, CallBack *pCallBack=0)


bool	operator== (const BasePersistent &rT) const
	Vergleichsoperator, es werden alle Attribute verglichen.

bool	operator!= (const BasePersistent &rT) const
	Vergleichsoperator, es werden alle Attribute verglichen.

Öffentliche Methoden geerbt von glo::CallBack
	CallBack ()

	CallBack (Base &rBase)

virtual	~CallBack ()

Base *	getBase () const

virtual void	notify (NotifyNote &rNote)

CallBack &	operator= (const CallBack &rT)

virtual void	setBase (Base *pBase)

bool	operator== (const CallBack &rT) const
	Vergleichsoperator, es werden alle Attribute verglichen.

bool	operator!= (const CallBack &rT) const
	Vergleichsoperator, es werden alle Attribute verglichen.

Geschützte Methoden
virtual	~BasePersistent ()

virtual void	insertInObjectSpy () const =0

virtual void	removeInObjectSpy () const =0

virtual void	setCreateDate ()=0

void	setSpyaction (bool bSpyaction)

Geschützte Methoden geerbt von glo::CallBack
	CallBack (const CallBack &rT)

Geschützte Attribute
bool	m_bSpyaction

eut::CriticalSection	m_LocalCriticalSection

Record *	m_pRecord

unsigned int	m_uiReferenceCount

Freundbeziehungen
class	PrivateBase

Weitere Geerbte Elemente
Öffentliche Attribute geerbt von glo::CallBack
std::string	m_strDebugInfo

Ausführliche Beschreibung

Abstrakte Basisklasse für Persistent und die generische GenericPersistent.

Objekte dieses Typs haben einen Referenzzähler und dürfen nicht mittels des Destruktors aus den Speicher entfernt werden.
Objekte mit Referenzzähler dürfen nur einmalig instanziiert werden. Bei Übergabe an eine andere Instanz muss über BasePersistent::remember() der Referenzzähler inkrementiert werden.
Wenn die eine besitzende Instanz das Objekt nicht mehr braucht, wird über BasePersistent::forget() der Referenzzähler dekrementiert.
Wenn der Referenzzähler auf 0 läuft, wird der Destruktors automatisch aufgerufen.

Copyright: © 2010 Helmut Jakoby

Autor: Helmut Jakoby

Beschreibung der Konstruktoren und Destruktoren

◆ BasePersistent() [1/2]

glo::BasePersistent::BasePersistent ( )

Standard-Konstruktor.

◆ ~BasePersistent()

virtual glo::BasePersistent::~BasePersistent ( )

protectedvirtual

Destruktor, wenn nötig wird Speicher aufgeräumt.
Der Destruktor steht nicht zur Verfügung. Das Objekt darf nur über forget() aus dem Speicher entfernt werden.

◆ BasePersistent() [2/2]

glo::BasePersistent::BasePersistent ( const BasePersistent & )

Copy-Konstruktor. Es werden keine Attribute dieser Klasse kopiert!

m_uiReferenceCount (1)
m_pRecord (NULL_PTR)
m_bSpyaction (true)

Dokumentation der Elementfunktionen

◆ activate()

virtual void glo::BasePersistent::activate ( )

virtual

Wird grundsätzlich nach einer Instanziierung aus der Datenbank aufgerufen.
Es können hier in abgeleiteten Klassen z.B. Zeiger auf NULL_PTR gesetzt, 'nicht-persistente' Variablen gesetzt und/oder andere Initialisierungen vorgenommen werden.

◆ assign()

virtual int glo::BasePersistent::assign ( Base & rBase )

virtual

Mittels dieser Methode wird ein Objekt dieser Klasse der Datenbank bekannt gemacht und bekommt dadurch (bei Erfolg) eine eindeutige ObjID (wenn nicht schon angemeldet).
Erst nach diesem Aufruf dieser Methode kann ein Objekt gespeichert werden. Ein persistentes Objekt muss nur einmal, vor dem ersten Speichern, an die Datenbank angemeldet werden. Danach behält es ja seine eindeutige ObjID.

Parameter

[in] rBase Die Datenbank, in der das Objekt gespeichert werden soll.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Die übergebene Datenbank muss geöffnet sein.

Erneute Implementation in glo::Persistent.

◆ deleteInBase()

virtual int glo::BasePersistent::deleteInBase ( EnDeepMode eDeepMode = DM_SHALLOW )

virtual

Das Objekt bzw. dessen persistenten Attribute werden in der Datenbank gelöscht.

Parameter

[in] eDeepMode Der Löschtiefenmodus.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Erneute Implementation in glo::Persistent.

◆ forget()

virtual unsigned int glo::BasePersistent::forget ( )

virtual

Ein Objekt dieser Klasse sollte immer mit einem vorherigen Aufruf von BasePersistent::remember() ausgeliefert werden. Die belieferte Instanz muss dann das Objekt mittels dieser Methode wieder 'vergessen'.

Rückgabe: Der Rückgabewert ist die Anzahl der Referenzen auf das Objekt dieser Klasse.

Ausnahmebehandlung

eut::ErrorNException Es wird eine Exception geworfen, wenn der Referenzzähler ins Minus laufen möchte.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Verbindung mit Forgeter in Betracht zu ziehen.

Erneute Implementation in glo::GenericPersistent.

◆ getAllPersAttributeNames()

int glo::BasePersistent::getAllPersAttributeNames	(	std::list< std::string > &	rRetValList,
		const std::vector< unsigned long > *	pClassIdVector = 0 ) const

Liefert alle Namen der persistenten Attribute aus seinem Datensatz.

Parameter

[in,out]	rRetValList	Die Liste aller Attributnamen.
[in]	pClassIdVector	Wenn übergeben, werden nur die Attribute der (Ober-) Klassen mit der ClassID aus pClassIdVector in rRetValMap übertragen.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

◆ getAllPersAttributeNamesSortByID()

int glo::BasePersistent::getAllPersAttributeNamesSortByID	(	std::map< AttributeID, std::string > &	rRetValMap,
		const std::vector< unsigned long > *	pClassIdVector = 0 ) const

Liefert die Namen der persistenten Attribute sortiert nach AttributeID aus seinem Datensatz.

Parameter

[in,out]	rRetValMap	Die Liste aller Attributnamen.
[in]	pClassIdVector	Wenn übergeben, werden nur die Attribute der (Ober-) Klassen mit der ClassID aus pClassIdVector in rRetValMap übertragen.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

◆ getAllPersAttributes() [1/2]

int glo::BasePersistent::getAllPersAttributes	(	std::list< BaseRecordAttribute * > &	rRetValList,
		const std::vector< unsigned long > *	pClassIdVector = 0 ) const

Liefert alle BaseRecordAttribute aus seinem Datensatz.

Parameter

[in,out]	rRetValList	In diese Liste werden die Attribute angehängt. Die Liste wird nicht vorher bereinigt.
[in]	pClassIdVector	Wenn übergeben, werden nur die Attribute der (Ober-) Klassen mit der ClassID aus pClassIdVector in rRetValList übertragen.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung: Die in rRetValList gelieferten Objekte müssen von der aufrufenden Instanz mittels BaseRecordAttribute::forget() aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Verbindung mit Forgeter in Betracht zu ziehen und die Methode getAllPersAttributes(std::list<std::shared_ptr<BaseRecordAttribute>>&, const std::vector<unsigned long>*)const zu nutzen.

◆ getAllPersAttributes() [2/2]

int glo::BasePersistent::getAllPersAttributes	(	std::list< std::shared_ptr< BaseRecordAttribute > > &	rRetValList,
		const std::vector< unsigned long > *	pClassIdVector = 0 ) const

Liefert alle BaseRecordAttribute aus seinem Datensatz.

Parameter

[in,out]	rRetValList	In diese Liste werden die Attribute angehängt. Die Liste wird nicht vorher bereinigt.
[in]	pClassIdVector	Wenn übergeben, werden nur die Attribute der (Ober-) Klassen mit der ClassID aus pClassIdVector in rRetValList übertragen.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

◆ getAllPersAttributesSortByID() [1/2]

int glo::BasePersistent::getAllPersAttributesSortByID	(	std::map< AttributeID, BaseRecordAttribute *, std::less< AttributeID > > &	rRetValMap,
		const std::vector< unsigned long > *	pClassIdVector = 0 ) const

Liefert alle BaseRecordAttribute aus seinem Datensatz sortiert nach deren AttributeID.

Parameter

[in,out]	rRetValMap	In diese Map werden die Attribute eingefügt. Die Map wird nicht vorher bereinigt.
[in]	pClassIdVector	Wenn übergeben, werden nur die Attribute der (Ober-) Klassen mit der ClassID aus pClassIdVector in rRetValMap übertragen.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung: Die in rRetValMap gelieferten Objekte müssen von der aufrufenden Instanz mittels BaseRecordAttribute::forget() aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Verbindung mit Forgeter in Betracht zu ziehen und die Methode getAllPersAttributesSortByID(std::map<std::string,std::shared_ptr<BaseRecordAttribute>,std::less<std::string>>&,const std::vector<unsigned long>*)const zu nutzen.

◆ getAllPersAttributesSortByID() [2/2]

int glo::BasePersistent::getAllPersAttributesSortByID	(	std::map< AttributeID, std::shared_ptr< BaseRecordAttribute >, std::less< AttributeID > > &	rRetValMap,
		const std::vector< unsigned long > *	pClassIdVector = 0 ) const

Liefert alle BaseRecordAttribute aus seinem Datensatz sortiert nach deren AttributeID.

Parameter

[in,out]	rRetValMap	In diese Map werden die Attribute eingefügt. Die Map wird nicht vorher bereinigt.
[in]	pClassIdVector	Wenn übergeben, werden nur die Attribute der (Ober-) Klassen mit der ClassID aus pClassIdVector in rRetValMap übertragen.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

◆ getAllPersAttributesSortByName() [1/2]

int glo::BasePersistent::getAllPersAttributesSortByName	(	std::map< std::string, BaseRecordAttribute *, std::less< std::string > > &	rRetValMap,
		const std::vector< unsigned long > *	pClassIdVector = 0 ) const

Liefert alle BaseRecordAttribute aus seinem Datensatz sortiert nach der Attributbezeichnung.

Parameter

[in,out]	rRetValMap	In diese Map werden die Attribute eingefügt. Die Map wird nicht vorher bereinigt.
[in]	pClassIdVector	Wenn übergeben, werden nur die Attribute der (Ober-) Klassen mit der ClassID aus pClassIdVector in rRetValMap übertragen.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung: Die in rRetValMap gelieferten Objekte müssen von der aufrufenden Instanz mittels BaseRecordAttribute::forget() aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Verbindung mit Forgeter in Betracht zu ziehen und die Methode getAllPersAttributesSortByName(std::map<std::string,std::shared_ptr<BaseRecordAttribute>,std::less<std::string>>&,const std::vector<unsigned long>*)const zu nutzen.

◆ getAllPersAttributesSortByName() [2/2]

int glo::BasePersistent::getAllPersAttributesSortByName	(	std::map< std::string, std::shared_ptr< BaseRecordAttribute >, std::less< std::string > > &	rRetValMap,
		const std::vector< unsigned long > *	pClassIdVector = 0 ) const

Liefert alle BaseRecordAttribute aus seinem Datensatz sortiert nach der Attributbezeichnung.

Parameter

[in,out]	rRetValMap	In diese Map werden die Attribute eingefügt. Die Map wird nicht vorher bereinigt.
[in]	pClassIdVector	Wenn übergeben, werden nur die Attribute der (Ober-) Klassen mit der ClassID aus pClassIdVector in rRetValMap übertragen.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

◆ getClassInfo()

virtual int glo::BasePersistent::getClassInfo ( ClassInfo *& prClassInfo )

virtual

Liefert die ClassInfo, wenn mit Datenbank verbunden.

Parameter

[in,out] prClassInfo Die ClassInfo dieses Objektes.

Rückgabe: Wenn Rückgabewert < 0, dann ist ein Fehler aufgetreten.

Achtung: Die gelieferte ClassInfo muss von der aufrufenden Instanz aus dem Speicher entfernt werden.

◆ getCreateDate()

virtual std::time_t glo::BasePersistent::getCreateDate ( ) const

pure virtual

Liefert in Unterklassen das Datum der Erstellung in der Datenbank.

Rückgabe: Das Erstellungsdatum.

Implementiert in glo::GenericPersistent und glo::Persistent.

◆ getGloClassID()

virtual unsigned long glo::BasePersistent::getGloClassID ( ) const

pure virtual

Rückgabe: Liefert die eigene Klassen-ID.

Implementiert in glo::GenericPersistent und glo::Persistent.

◆ getLastChangeDate()

virtual std::time_t glo::BasePersistent::getLastChangeDate ( ) const

pure virtual

Liefert in Unterklassen das Datum der letzten Änderung in der Datenbank.

Rückgabe: Das Änderungsdatum.

Implementiert in glo::GenericPersistent und glo::Persistent.

◆ getLinkCount()

unsigned int glo::BasePersistent::getLinkCount ( ) const

Rückgabe: Liefert die Anzahl von referenzierenden Instanzen.

Siehe auch: remember() and forget()

◆ getObjID()

virtual ObjID glo::BasePersistent::getObjID ( ) const

virtual

Rückgabe: Liefert die eindeutige ObjID.

Erneute Implementation in glo::GenericPersistent und glo::Persistent.

◆ getPersAttribute() [1/4]

int glo::BasePersistent::getPersAttribute	(	BaseRecordAttribute *&	prRetVal,
		const AttributeID &	rAttributeID ) const

Liefert ein BaseRecordAttribute aus seinem Datensatz, welches der übergebenen AttributID entsprichet.

Parameter

[in,out]	prRetVal	Das Attribut.
[in]	rAttributeID	Die Attribut-ID.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung: Wenn prRetVal gültig, muss dieser mittels BaseRecordAttribute::forget() von der aufrufenden Instanz aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Verbindung mit Forgeter in Betracht zu ziehen und die Methode getPersAttribute(std::shared_ptr<BaseRecordAttribute>&, const AttributeID&)const zu nutzen.

◆ getPersAttribute() [2/4]

int glo::BasePersistent::getPersAttribute	(	BaseRecordAttribute *&	prRetVal,
		const std::string &	sName ) const

Liefert ein BaseRecordAttribute aus seinem Datensatz, welches der übergebenen Bezeichnung (inkl. der Klassenbezeichnung) entsprichet (z.B.:"glo::Persistent.m_dtCreateDate").

Parameter

[in,out]	prRetVal	Das Attribut.
[in]	sName	Die vollständige Bezeichnung des gesuchten Datensatzattributs (z.B."glo::Persistent.m_dtCreateDate").

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung: Wenn prRetVal gültig, muss dieser mittels BaseRecordAttribute::forget() von der aufrufenden Instanz aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Verbindung mit Forgeter in Betracht zu ziehen und die Methode getPersAttribute(std::shared_ptr<BaseRecordAttribute>&, const std::string&)const zu nutzen.

◆ getPersAttribute() [3/4]

int glo::BasePersistent::getPersAttribute	(	std::shared_ptr< BaseRecordAttribute > &	rRetVal,
		const AttributeID &	rAttributeID ) const

Liefert ein BaseRecordAttribute aus seinem Datensatz, welches der übergebenen AttributID entsprichet.

Parameter

[in,out]	rRetVal	Das Attribut in einem std::shared_ptr.
[in]	rAttributeID	Die Attribut-ID.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

◆ getPersAttribute() [4/4]

int glo::BasePersistent::getPersAttribute	(	std::shared_ptr< BaseRecordAttribute > &	rRetVal,
		const std::string &	sName ) const

Liefert ein BaseRecordAttribute aus seinem Datensatz, welches der übergebenen Bezeichnung (inkl. der Klassenbezeichnung) entsprichet (z.B.:"glo::Persistent.m_dtCreateDate").

Parameter

[in,out]	rRetVal	Das Attribut in einem std::shared_ptr.
[in]	sName	Der Name des Attributs.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

◆ getProcessingPossibilities()

virtual int glo::BasePersistent::getProcessingPossibilities	(	LockPossibleSpecification &	rLockPossibleSpec,
		EnDeepMode	eDeepMode = DM_SHALLOW ) const

virtual

Liefert die erlaubten Möglichkeiten für dieses Objekt in der Datenbank.

Parameter

[in,out]	rLockPossibleSpec	Die Möglichkeitsantwort.
[in]	eDeepMode	Der Tiefenmodus für den geprüft wird.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Siehe auch: Objekt auf Sperren bzw. Zugriffsmöglichkeiten prüfen.

◆ getRecord() [1/2]

int glo::BasePersistent::getRecord ( Record *& prRecord ) const

Liefert den Datensatz dieses Objektes.

Parameter

[in,out] prRecord Der Datensatz, wenn vorhanden.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Achtung: Wenn prRecord gültig ist, muss dieser von der aufrufenden Instanz mittels Record::forget(), aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Verbindung mit Forgeter in Betracht zu ziehen und die Methode getRecord(std::shared_ptr<Record>&)const zu nutzen.

◆ getRecord() [2/2]

int glo::BasePersistent::getRecord ( std::shared_ptr< Record > & rRetVal ) const

Liefert den Datensatz dieses Objektes.

Parameter

[in,out] rRetVal Der Datensatz in einem std::shared_ptr, wenn vorhanden.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

◆ getTypeAsString()

virtual int glo::BasePersistent::getTypeAsString ( std::string & rsTypeName )

overridevirtual

Liefert die Klassenbezeichnung.

Parameter

[in,out] rsTypeName Die Typbezeichnung.

Rückgabe: Wenn Rückgabewert < 0, ist ein Fehler aufgetreten.

Erneute Implementation von glo::CallBack.

Erneute Implementation in glo::GenericPersistent und glo::Persistent.

◆ insertInObjectSpy()

virtual void glo::BasePersistent::insertInObjectSpy ( ) const

protectedpure virtual

Fügt das Objekt in seinen ObjectSpy ein (in Unterklassen, weil Persistent und GenericPersistent unterschiedliche ObjectSpy's haben).

Implementiert in glo::GenericPersistent und glo::Persistent.

◆ isAssigned()

virtual bool glo::BasePersistent::isAssigned ( ) const

virtual

Rückgabe: Liefert true, wenn Objekt an einer Datenbank angemeldet ist.

◆ isDeletedInBase()

virtual bool glo::BasePersistent::isDeletedInBase ( )

virtual

Fragt in der Datenbank nach, ob Objekt gelöscht ist (nicht irgendein Flag im Speicher, also 'teuer').

Rückgabe: Wenn true, ist Objekt in der Datenbank gelöscht.

Achtung: Gelöschte Objekte können nicht mehr mit ihrer ursprünglichen ObjID gespeichert wertden.

◆ isLocked() [1/2]

virtual int glo::BasePersistent::isLocked ( const LockSpecification & rLockSpecification ) const

virtual

Fragt in der Datenbank nach, ob Objekt mit einem bestimmten Sperrmodus gesperrt ist (nicht irgendein Flag im Speicher, also 'teuer').

Parameter

[in] rLockSpecification Der Sperr- und Sperrtiefenmodus.

Rückgabe: Wenn > 0, ist das Objekt mit dem übergebenen Sperrmodus in der Datenbank gesperrt. Eine Rückgabe < 0 zeigt einen Fehler an.

Siehe auch: Objekt auf Sperren bzw. Zugriffsmöglichkeiten prüfen.

◆ isLocked() [2/2]

virtual int glo::BasePersistent::isLocked	(	EnLockMode	eLockMode = LK_DELETEvWRITE,
		EnDeepMode	eDeepMode = DM_SHALLOW ) const

virtual

Fragt in der Datenbank nach, ob Objekt mit einem bestimmten Sperrmodus gesperrt ist (nicht irgendein Flag im Speicher, also 'teuer').

Parameter

[in]	eLockMode	Der Sperrmodus.
[in]	eDeepMode	Der Sperrtiefenmodus.

Rückgabe: Wenn > 0, ist das Objekt mit dem übergebenen Sperrmodus in der Datenbank gesperrt. Eine Rückgabe < 0 zeigt einen Fehler an.

Siehe auch: Objekt auf Sperren bzw. Zugriffsmöglichkeiten prüfen.

◆ isPossible() [1/2]

virtual int glo::BasePersistent::isPossible	(	bool	bRead,
		bool	bWrite,
		bool	bDelete,
		EnDeepMode	eDeepMode = DM_SHALLOW ) const

virtual

Es werden die erlaubten Aktionen für das Objekt in der Datenbank erfragt.

Parameter

[in]	bRead	Wenn true, wird auf Lesen dürfen geprüft.
[in]	bWrite	Wenn true, wird auf Schreiben dürfen geprüft.
[in]	bDelete	Wenn true, wird auf Löschen dürfen geprüft.
[in]	eDeepMode	Der Tiefenmodus für den geprüft wird.

Rückgabe: Wenn Rückgabe == 0, ist die jeweilige Aktion erlaubt. Eine Rückgabe < 0 zeigt einen Fehler an.

Siehe auch: Objekt auf Sperren bzw. Zugriffsmöglichkeiten prüfen.

◆ isPossible() [2/2]

virtual int glo::BasePersistent::isPossible	(	const LockPossibleSpecification &	rLockPossibleSpec,
		EnDeepMode	eDeepMode = DM_SHALLOW ) const

virtual

Es werden die erlaubten Aktionen für das Objekt in der Datenbank erfragt.

Parameter

[in]	rLockPossibleSpec	Die Möglichkeitsanfrage.
[in]	eDeepMode	Der Tiefenmodus für den geprüft wird.

Rückgabe: Wenn Rückgabe == 0, ist die jeweilige Aktion in rLockPossibleSpec erlaubt. Eine Rückgabe < 0 zeigt einen Fehler an.

Siehe auch: Objekt auf Sperren bzw. Zugriffsmöglichkeiten prüfen.

◆ isStored()

virtual bool glo::BasePersistent::isStored ( )

virtual

Fragt in der Datenbank nach, ob Objekt gespeichert ist (nicht irgendein Flag im Speicher, also 'teuer').

Rückgabe: Wenn true, ist Objekt in der Datenbank gespeichert.

◆ lock() [1/2]

virtual int glo::BasePersistent::lock ( const LockSpecification & rLockSpecification )

virtual

Das Objekt wird in der Datenbank für andere Clients gesperrt.

Parameter

[in] rLockSpecification Der Sperr- und Sperrtiefenmodus.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Um die Sperre aufzuheben muss die korrespondierende Methode unlock(const LockSpecification&) const mit gleichen Parameterwerten genutzt werden.
Letztendlich wird die Methode Persistent::lock(EnLockMode,EnDeepMode) aufgerufen.

Siehe auch: Ein persistentes Objekt sperren.

◆ lock() [2/2]

virtual int glo::BasePersistent::lock	(	EnLockMode	eLockMode = LK_DELETEvWRITE,
		EnDeepMode	eDeepMode = DM_SHALLOW )

virtual

Das Objekt wird in der Datenbank für andere Clients gesperrt.

Parameter

[in]	eLockMode	Der Sperrmodus.
[in]	eDeepMode	Der Sperrtiefenmodus.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Um die Sperre aufzuheben muss die korrespondierende Methode unlock(EnLockMode, EnDeepMode) const mit gleichen Parameterwerten genutzt werden.

Siehe auch: Ein persistentes Objekt sperren.

Erneute Implementation in glo::Persistent.

◆ operator!=()

bool glo::BasePersistent::operator!= ( const BasePersistent & rT ) const

Vergleichsoperator, es werden alle Attribute verglichen.

Parameter

[in] rT Das mit diesem zu vergleichende Objekt.

◆ operator=()

BasePersistent & glo::BasePersistent::operator= ( const BasePersistent & rT )

Zuweisungsoperator.

Parameter

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

◆ operator==()

bool glo::BasePersistent::operator== ( const BasePersistent & rT ) const

Vergleichsoperator, es werden alle Attribute verglichen.

Parameter

[in] rT Das mit diesem zu vergleichende Objekt.

◆ refresh()

virtual int glo::BasePersistent::refresh ( )

virtual

Liest alle persistenten Attribute des Objekts aus der Datenbank neu ein.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Wenn das Objekt in einer noch nicht abgeschlossenen Transaktion ist, werden die Werte aus der Transaktion geholt.

Siehe auch: GlobalObjects Transaktion.

Erneute Implementation in glo::Persistent.

◆ remember()

virtual unsigned int glo::BasePersistent::remember ( )

virtual

Inkrementiert den Referenz-Zähler. Sollte immer bei 'Auslieferung' eines Objektes dieser Klasse aufgerufen werden. Die belieferte Instanz muss dann das Objekt mit BasePersistent::forget() 'vergessen'.

Rückgabe: Der Rückgabewert ist die Anzahl der Referenzen auf das Objekt dieser Klasse.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Verbindung mit Forgeter in Betracht zu ziehen.

Erneute Implementation in glo::GenericPersistent.

◆ removeBase()

virtual void glo::BasePersistent::removeBase ( )

virtual

Entfernt die Referenz auf die Datenbank und setzt diese auf NULL_PTR.

Erneute Implementation in glo::GenericPersistent und glo::Persistent.

◆ removeInObjectSpy()

virtual void glo::BasePersistent::removeInObjectSpy ( ) const

protectedpure virtual

Entfernt das Objekt aus seinem ObjectSpy (in Unterklassen, weil Persistent und GenericPersistent unterschiedliche ObjectSpy's haben).

Implementiert in glo::GenericPersistent und glo::Persistent.

◆ setCreateDate()

virtual void glo::BasePersistent::setCreateDate ( )

protectedpure virtual

Setzt das Erstellungsdatum (in Unterklassen).

Implementiert in glo::GenericPersistent und glo::Persistent.

◆ setSpyaction()

void glo::BasePersistent::setSpyaction ( bool bSpyaction )

protected

Setzt m_bSpyaction.

Parameter

[in] bSpyaction Wenn false, wird z.B. im dtor das Objekt nicht aus dem ObjectSpy entfernt.

◆ setWatch() [1/2]

virtual int glo::BasePersistent::setWatch ( const WatchSpecification & rWatchSpec )

virtual

Das Objekt wird in der Datenbank überwacht.

Parameter

[in] rWatchSpec Die Überwachungsspezifikation.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Um die Überwachung aufzuheben muss die korrespondierende Methode unsetWatch(const WatchSpecification&) const mit gleichen Parameterwerten genutzt werden.
Prinzipiell ist es möglich, einzelne Überwachungsmodi aufzuheben Es sollte dann darauf geachtet werden, dass alle einzelnen Überwachungsmodi auch angewendet werden, damit keine Überwachung im Speicher verbleibt bis das Programm beendet wird.
Letztendlich wird die Methode Persistent::setWatch(TdWatchNotifyMode,EnDeepMode,CallBack*) aufgerufen.

Siehe auch: Beobachten und benachrichtigen.

◆ setWatch() [2/2]

virtual int glo::BasePersistent::setWatch	(	TdWatchNotifyMode	ulWatchMode,
		EnDeepMode	eDeepMode,
		CallBack *	pCallBack = 0 )

virtual

Das Objekt wird in der Datenbank überwacht.

Parameter

[in]	ulWatchMode	Der Überwachungsmodus. Erlaubte Überwachungsmodi: WNM_READ = lesen wird gemeldet WNM_WRITE = schreiben wird gemeldet WNM_DELETE = löschen wird gemeldet WNM_LOCK = sperren wird gemeldet WNM_UNLOCK = freigeben wird gemeldet
[in]	eDeepMode	Der Überwachungstiefenmodus.
[in]	pCallBack	Das CallBack-Objekt, welches über seine Methode CallBack::notify(NotifyNote&) benachrichtigt wird. Wenn kein CallBack übergeben, wird notify(NotifyNote&) von this genommen; in diesem Fall sollte die Methode notify(NotifyNote&) in der jeweiligen abgeleiteten Klasse überschrieben sein.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Um die Überwachung aufzuheben muss die korrespondierende Methode unsetWatch(TdWatchNotifyMode, EnDeepMode, CallBack*) const mit gleichen Parameterwerten genutzt werden.
Prinzipiell ist es möglich, einzelne Überwachungsmodi aufzuheben Es sollte dann darauf geachtet werden, dass alle einzelnen Überwachungsmodi auch angewendet werden, damit keine Überwachung im Speicher verbleibt bis das Programm beendet wird.

Achtung: Grundsätzlich darf pCallBack nicht zerstört werden, bevor die Überwachung aufgehoben wurde!

Siehe auch: Beobachten und benachrichtigen.

Erneute Implementation in glo::Persistent.

◆ store()

virtual int glo::BasePersistent::store ( EnDeepMode eDeepMode = DM_SHALLOW )

virtual

Das Objekt bzw. dessen persistenten Attribute, werden in der Datenbank gespeichert.

Parameter

[in] eDeepMode Der Speichertiefenmodus.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Das Objekt muss der Datenbank bekannt bzw. dort angemeldet sein.

Siehe auch: BasePersistent::assign(Base&)

Erneute Implementation in glo::Persistent.

◆ takeOverRecord()

virtual void glo::BasePersistent::takeOverRecord ( Record * pRecord )

virtual

Übernimmt Record wenn ungleich NULL_PTR. Auf jeden Fall wird der ggf. eigene vorhandene Record in m_pRecord 'vergessen'.

Parameter

[in] pRecord Der zu übernehmende Record.

Erneute Implementation in glo::GenericPersistent und glo::Persistent.

◆ unlock() [1/2]

virtual int glo::BasePersistent::unlock ( const LockSpecification & rLockSpecification )

virtual

Das Objekt wird in der Datenbank freigegeben. Eine Sperrfreigabe muss mit den gleichen Parametern wie der vorherige Sperraufruf aufgerufen werden.

Parameter

[in] rLockSpecification Der urspüngliche Sperr- und Sperrtiefenmodus.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Hebt die Sperre auf, die durch die korrespondierende Methode lock(const LockSpecification&) const initiiet wurde, wenn der Parameter die selben Werte hat.
Letztendlich wird die Methode Persistent::unLock(EnLockMode,EnDeepMode) aufgerufen.

Siehe auch: Ein persistentes Objekt sperren.

◆ unlock() [2/2]

virtual int glo::BasePersistent::unlock	(	EnLockMode	eLockMode = LK_DELETEvWRITE,
		EnDeepMode	eDeepMode = DM_SHALLOW )

virtual

Das Objekt wird in der Datenbank freigegeben. Eine Sperrfreigabe muss mit den gleichen Parametern wie der vorherige Sperraufruf aufgerufen werden.

Parameter

[in]	eLockMode	Der urspüngliche Sperrmodus.
[in]	eDeepMode	Der urspüngliche Sperrtiefenmodus.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Hebt die Sperre auf, die durch die korrespondierende Methode lock(EnLockMode, EnDeepMode) const initiiet wurde, wenn die Parameter die selben Werte haben.

Siehe auch: Ein persistentes Objekt sperren.

Erneute Implementation in glo::Persistent.

◆ unsetWatch() [1/2]

virtual int glo::BasePersistent::unsetWatch ( const WatchSpecification & rWatchSpec )

virtual

Die Überwachung des Objekts in der Datenbank wird bendet. Eine Überwachungsbeendigung muss mit den gleichen Parametern wie die vorherige Überwachung aufgerufen werden.

Parameter

[in] rWatchSpec Die ursprüngliche Überwachungsspezifikation.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Hebt die Überwachung auf, die durch die korrespondierende Methode setWatch(const WatchSpecification&) const initiiet wurde, wenn die Parameter die selben Werte haben.
Prinzipiell ist es möglich, einzelne Überwachungsmodi aufzuheben Es sollte dann darauf geachtet werden, dass alle einzelnen Überwachungsmodi auch angewendet werden, damit keine Überwachung im Speicher verbleibt bis das Programm beendet wird.
Letztendlich wird die Methode Persistent::unsetWatch(TdWatchNotifyMode,EnDeepMode,CallBack*) aufgerufen.

Siehe auch: Beobachten und benachrichtigen.

◆ unsetWatch() [2/2]

virtual int glo::BasePersistent::unsetWatch	(	TdWatchNotifyMode	ulWatchMode,
		EnDeepMode	eDeepMode,
		CallBack *	pCallBack = 0 )

virtual

Die Überwachung des Objekts in der Datenbank wird beendet. Eine Überwachungsbeendigung muss mit den gleichen Parametern wie die vorherige Überwachung aufgerufen werden.

Parameter

[in]	ulWatchMode	Der ursprüngliche Überwachungsmodus. Erlaubte Überwachungsmodi: WNM_READ = lesen wird gemeldet WNM_WRITE = schreiben wird gemeldet WNM_DELETE = löschen wird gemeldet WNM_LOCK = sperren wird gemeldet WNM_UNLOCK = freigeben wird gemeldet
[in]	eDeepMode	Der ursprüngliche Überwachungstiefenmodus.
[in]	pCallBack	Das CallBack-Objekt, welches über seine Methode CallBack::notify(NotifyNote&) benachrichtigt wurde. Wenn kein CallBack übergeben, wird notify(NotifyNote&) von this genommen; in diesem Fall sollte die Methode notify(NotifyNote&) in der jeweiligen abgeleiteten Klasse überschrieben sein.

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an.

Zu beachten: Hebt die Überwachung auf, die durch die korrespondierende Methode setWatch(TdWatchNotifyMode, EnDeepMode, CallBack*) const initiiet wurde, wenn die Parameter die selben Werte haben.
Prinzipiell ist es möglich, einzelne Überwachungsmodi aufzuheben Es sollte dann darauf geachtet werden, dass alle einzelnen Überwachungsmodi auch angewendet werden, damit keine Überwachung im Speicher verbleibt bis das Programm beendet wird.

Siehe auch: Beobachten und benachrichtigen.

Erneute Implementation in glo::Persistent.

Freundbeziehungen und Funktionsdokumentation

◆ PrivateBase

friend class PrivateBase

friend

Wegen Zugriff auf div. Methoden

Dokumentation der Datenelemente

◆ m_bSpyaction

bool glo::BasePersistent::m_bSpyaction

protected

Wenn false, wird das Objekt im Destruktor der Unterklassen (siehe auch dort) nicht aus Objektspy entfernt (ggf. sollte dort nicht vorhanden sein).
Wird z.B. von der PrivateBase beim Nachinstanziieren eines eingebetteten Objektes auf false gesetzt.
Voreinstellung = true.

◆ m_LocalCriticalSection

eut::CriticalSection glo::BasePersistent::m_LocalCriticalSection

protected

Damit mehrere Threads auf BasePersistent::remember() und BasePersistent::forget() zugreifen können, wird der Zugriff mit dieser CriticalSection synchronisiert.

◆ m_pRecord

Record* glo::BasePersistent::m_pRecord

protected

Der Datensatz des Objekts, wird ggf. aus mehreren Datensätzen in diesen zusammengeführt.

◆ m_uiReferenceCount

unsigned int glo::BasePersistent::m_uiReferenceCount

protected

Der Referenzzähler. Sie auch Klassenbeschreibung von BasePersistent.

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

GloBasePersistent.h

Öffentliche Methoden

Geschützte Methoden

Geschützte Attribute

Freundbeziehungen

Weitere Geerbte Elemente

Ausführliche Beschreibung

Beschreibung der Konstruktoren und Destruktoren

◆ BasePersistent() [1/2]

◆ ~BasePersistent()

◆ BasePersistent() [2/2]

Dokumentation der Elementfunktionen

◆ activate()

◆ assign()

◆ deleteInBase()

◆ forget()

◆ getAllPersAttributeNames()

◆ getAllPersAttributeNamesSortByID()

◆ getAllPersAttributes() [1/2]

◆ getAllPersAttributes() [2/2]

◆ getAllPersAttributesSortByID() [1/2]

◆ getAllPersAttributesSortByID() [2/2]

◆ getAllPersAttributesSortByName() [1/2]

◆ getAllPersAttributesSortByName() [2/2]

◆ getClassInfo()

◆ getCreateDate()

◆ getGloClassID()

◆ getLastChangeDate()

◆ getLinkCount()

◆ getObjID()

◆ getPersAttribute() [1/4]

◆ getPersAttribute() [2/4]

◆ getPersAttribute() [3/4]

◆ getPersAttribute() [4/4]

◆ getProcessingPossibilities()

◆ getRecord() [1/2]

◆ getRecord() [2/2]

◆ getTypeAsString()

◆ insertInObjectSpy()

◆ isAssigned()

◆ isDeletedInBase()

◆ isLocked() [1/2]

◆ isLocked() [2/2]

◆ isPossible() [1/2]

◆ isPossible() [2/2]

◆ isStored()

◆ lock() [1/2]

◆ lock() [2/2]

◆ operator!=()

◆ operator=()

◆ operator==()

◆ refresh()

◆ remember()

◆ removeBase()

◆ removeInObjectSpy()

◆ setCreateDate()

◆ setSpyaction()

◆ setWatch() [1/2]

◆ setWatch() [2/2]

◆ store()

◆ takeOverRecord()

◆ unlock() [1/2]

◆ unlock() [2/2]

◆ unsetWatch() [1/2]

◆ unsetWatch() [2/2]

Freundbeziehungen und Funktionsdokumentation

◆ PrivateBase

Dokumentation der Datenelemente

◆ m_bSpyaction

◆ m_LocalCriticalSection

◆ m_pRecord

◆ m_uiReferenceCount