AllSet, welcher Objekte aus der Datenbank liefert. Mehr ...

#include <GloTAllSet.h>

Klassendiagramm für glo::TAllSet< T >:

[Legende]

Öffentliche Methoden
	TAllSet ()

	TAllSet (Base &rBase, bool bWithSubClasses=true)

	TAllSet (Base &rBase, const std::string &rsFullIndexName)

virtual	~TAllSet ()

int	get (glo::ObjID &rObjID, std::shared_ptr< T > &rRetVal, EnSeekMode eMode)

int	get (glo::ObjID &rObjID, T *&prRetVal, EnSeekMode eMode)

int	get (std::shared_ptr< T > &rRetVal, const glo::ObjID &rObjID)

int	get (std::shared_ptr< T > &rRetVal, EnSeekMode eMode)

int	get (T *&prRetVal, EnSeekMode eMode)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsFullIndexName, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsFullIndexName, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsFullIndexName, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)

int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandVector, const std::string &rsRangeStartIndex, const std::string &rsRangeEndIndex)

int	getOndemand (glo::TOndemand< T > &rRetVal, EnSeekMode eMode)

int	getOndemand (glo::TOndemand< T > *&prRetVal, EnSeekMode eMode)

int	getOndemand (std::shared_ptr< glo::TOndemand< T > > &rRetVal, EnSeekMode eMode)

virtual int	getPersistent (std::shared_ptr< BasePersistent > &rRetVal, const glo::ObjID &rObjID)

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

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


virtual int	getPersistent (BasePersistent *&prRetVal, const glo::ObjID &rObjID)
	Liefert ein Objekt aus dem AllSet der Datenbank mit übergebener Objekt-ID.

int	get (T *&prRetVal, const glo::ObjID &rObjID)
	Liefert ein Objekt aus dem AllSet der Datenbank mit übergebener Objekt-ID.

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

	BaseAllSet (Base &rBase)

	BaseAllSet (Base &rBase, unsigned long ulClassID, bool bWithSubClasses=true)

	BaseAllSet (Base &rBase, unsigned long ulClassID, const std::string &rsFullIndexName)

virtual	~BaseAllSet ()

int	close ()

std::vector< AllSetIndexInfo >	getAvailableIndices ()

std::size_t	getAvailableIndicesSize ()

virtual Base *	getBase () const override

unsigned long	getClassID () const

std::string	getFullIndexName () const

unsigned long	getIndexClassID () const

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsFullIndexName, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsFullIndexName, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsFullIndexName, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)

int	getIndexedObjIds (std::vector< glo::ObjID > &rObjIDContainer, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)

std::string	getIndexName () const

int	getObjID (glo::ObjID &rObjID, EnSeekMode eMode)

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

virtual bool	inLot (const glo::ObjID &rObjID) const override

virtual bool	inSet (const glo::ObjID &rObjID) const

bool	isIndexAvailable (const BaseAllSet::IndexNameClassIdTuple &rIndexNameClassIdTuple)

bool	isIndexAvailable (const std::string &rsFullIndexName)

bool	isIndexAvailable (unsigned long ulClassID, const std::string &rsIndexName)

int	open ()

bool	readWithSubClasses () const

int	removeIndexFilter ()

virtual int	setBase (Base &rBase)

virtual int	setBase (Base *pBase) override

virtual int	setCurrentObject (const glo::ObjID &rObjID) override

int	setFullIndexName (const std::string &rsFullIndexName)

int	setIndex (const BaseAllSet::IndexNameClassIdTuple &rIndexNameClassIdTuple)

int	setIndexFilter (const std::string &rsIndexFilter)

int	setIndexFilter (const std::string &rsIndexFilter, EnComparisionOp eComparisionOp)

int	setIndexFilter (const std::string &rsRangeStartIndexFilter, const std::string &rsRangeEndIndexFilter)

virtual int	setPosition (std::size_t nPosition) override

void	setReadWithSubClasses (bool bWithSubClasses)

virtual std::size_t	size () const override

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

virtual	~AbstractBaseLot ()

virtual int	setCurrentObject (const BasePersistent &rObject)

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

virtual	~CallBack ()

virtual void	notify (NotifyNote &rNote)

CallBack &	operator= (const CallBack &rT)

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

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

Private Methoden
	TAllSet (const TAllSet &)

TAllSet< T > &	operator= (const TAllSet &)

void	transferObjIListIntoOndemandVector (const std::vector< glo::ObjID > &rSourceContainer, std::vector< glo::TOndemand< T > > &rTargetVevtor)

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

Geschützte Methoden geerbt von glo::BaseAllSet
void	setAllSetOpen (bool bOpen)

int	setAvailableIndices ()

virtual void	setClassID (unsigned long ulClassID)

void	setClassIDFromTemplate (unsigned long ulClassID)

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

void	deinit ()

void	init ()

Ausführliche Beschreibung

template<class T>
class glo::TAllSet< T >

AllSet, welcher Objekte aus der Datenbank liefert.

Im AllSets sind alle Instanzen eines Objekttyps in der Datenbank.

Wenn ein Objekt dieser Klasse instanziiert und geöffnet wird (geht nur mit gültiger Datenbank), wird vom Manager ein Iterator angelegt, mittels dem durch den internen AllSet iteriert werden kann. Im Destruktor wird der Manager benachrichtigt, welcher den Iterator wieder zerstört.

In einem AllSet sind alle Objekte der entsprechenden Klasse. Somit auch Objekte, welche von der Klasse des AllSet's abgeleitet sind. Wird nun ein Objekt einer abgeleiteten Klasse aus dem (Oberklassen) AllSet "geholt", wird automatisch das Objekt der Unterklasse(n) instantiiert.

Stichworte dafür; "dynamic_cast" und "Class-ID".

Achtung: Das bedeutet, dass ein TAllSet immer vor der Base aus dem Speicher entfernt werden muss.

int main( int argc, char* argv[] )
{
  int                     t_iErr = 0;
  FirstGloBaseObjCreator  t_ObjCreator;
  glo::Base               t_Base( "LOCAL", "WindowsWatcher", t_ObjCreator );
 
  t_iErr = t_Base.openBase();
  if ( ! t_iErr )
  {
    std::shared_ptr<FirstClass>   t_spShowPersObject;
    glo::TAllSet<FirstClass>      t_AllSet( t_Base );
 
    t_iErr = t_AllSet.get( t_spShowPersObject, glo::START );
    if ( ! t_iErr )
    {
      do
      {
        std::cout << "From AllSet ObjId: "
                  << t_spShowPersObject->getObjID().toString()
                  << "\n" ;
        t_iErr = t_AllSet.get( t_spShowPersObject, glo::NEXT );
      } while ( ! t_iErr );
    }
    t_iErr = ( t_iErr == glo::ERR_RANGE ? 0 : t_iErr );
    t_Base.closeBase();
  }
  return t_iErr;
}

Indexe
Es kann ein AllSet auch mit einem Index instantiiert werden bzw. es kann ein Index gesetzt werden (siehe setFullIndexName(const std::string&) ), wenn der Index im Schema definiert ist. Es wird beim Iterieren durch die Objekte dann die Sortierung des gewählten Indexes genutzt.

Wenn ein Index gesetzt ist, ist es möglich beim Iterieren, die Ausgabe zu filtern (siehe setIndexFilter( const std::string & rsIndexFilter ), setIndexFilter( const std::string & rsIndexFilter, EnComparisionOp eComparisionOp )
und
setIndexFilter( const std::string & rsRangeStartIndexFilter, const std::string & rsRangeEndIndexFilter ).

Beobachten und benachrichtigen
Ein AllSet kann mit seinen Objekten beobachtet, und entsprechende Beobachter benachrichtigt werden (siehe auch TAllSet< T >::setWatch (...) und TAllSet< T >::unsetWatch (...).

Achtung: Ein TAllSet muss immer vor der Base aus dem Speicher entfernt werden.

Copyright: © 2010 Helmut Jakoby

Autor: Helmut Jakoby

Beschreibung der Konstruktoren und Destruktoren

◆ TAllSet() [1/4]

template<class T >

glo::TAllSet< T >::TAllSet ( )

Standard-Konstruktor.

◆ TAllSet() [2/4]

template<class T >

glo::TAllSet< T >::TAllSet	(	Base &	rBase,
		bool	bWithSubClasses = true )

Konstruktor mit Parameterübergabe.

Parameter

[in]	rBase	Es wird die maßgebliche Datenbank mitgegeben.
[in]	bWithSubClasses	Wenn false, werden nur Objekte des Template-Typs ohne Unterklassen berücksichtigt.

Ausnahmebehandlung

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

◆ TAllSet() [3/4]

template<class T >

glo::TAllSet< T >::TAllSet	(	Base &	rBase,
		const std::string &	rsFullIndexName )

Konstruktor mit Parameterübergabe.

Parameter

[in]	rBase	Es wird die maßgebliche Datenbank mitgegeben.
[in]	rsFullIndexName	Ein AllSet kann nach einem Index sortiert sein. Der Index Name muss mit vollständigen Klassennamen übergeben werden (z.B. "mynamespace::MyClassName.IndexName").

Ausnahmebehandlung

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

◆ ~TAllSet()

template<class T >

glo::TAllSet< T >::~TAllSet ( )

virtual

Destruktor.

◆ TAllSet() [4/4]

template<class T >

glo::TAllSet< T >::TAllSet ( const TAllSet< T > & )

private

Der Copy-Konstruktor steht nicht zur Verfügung.

Dokumentation der Elementfunktionen

◆ get() [1/6]

template<class T >

int glo::TAllSet< T >::get	(	glo::ObjID &	rObjID,
		std::shared_ptr< T > &	rRetVal,
		EnSeekMode	eMode )

Liefert eine Objekt-ID und wenn möglich ein Objekt in einem std::shared_ptr aus dem AllSet der Datenbank in Bezug auf eMode. Damit kann auch über lesegesperrte Objekte iteriert werden (es wird dann nur die Objekt-ID geliefert).

Parameter

[in,out]	rObjID	Die Objekt-ID.
[in,out]	rRetVal	Bei keinem Fehler das geholte Objekt.
[in]	eMode	Der Suchmodus.

Parameterbeispiele:

glo::START = liefert erstes Element
glo::END = liefert letztes Element
glo::CURRENT = liefert aktuelles Element
glo::NEXT = liefert nächstes Element
glo::PREVIOUS = liefert vorheriges Element

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an. Eine Rückgabe == glo::ERR_RANGE zeigt das Ende des AllSets an. Bei einer Rückgabe == ERR_OBJECT_LOCKED wird zwar kein Objekt geliefert, aber die Objekt-ID des gesperrten Objekts.

◆ get() [2/6]

template<class T >

int glo::TAllSet< T >::get	(	glo::ObjID &	rObjID,
		T *&	prRetVal,
		EnSeekMode	eMode )

Liefert eine Objekt-ID und wenn möglich ein Objekt aus dem AllSet der Datenbank in Bezug auf eMode. Damit kann auch über lesegesperrte Objekte iteriert werden (es wird dann nur die Objekt-ID geliefert).

Parameter

[in,out]	rObjID	Die Objekt-ID.
[in,out]	prRetVal	Bei keinem Fehler das geholte Objekt.
[in]	eMode	Der Suchmodus.

Parameterbeispiele:

glo::START = liefert erstes Element
glo::END = liefert letztes Element
glo::CURRENT = liefert aktuelles Element
glo::NEXT = liefert nächstes Element
glo::PREVIOUS = liefert vorheriges Element

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an. Eine Rückgabe == glo::ERR_RANGE zeigt das Ende des AllSets an. Bei einer Rückgabe == ERR_OBJECT_LOCKED wird zwar kein Objekt geliefert, aber die Objekt-ID des gesperrten Objekts.

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

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Betracht zu ziehen und die Methode get(glo::ObjID&, std::shared_ptr<T>&, EnSeekMode) zu nutzen.

◆ get() [3/6]

template<class T >

int glo::TAllSet< T >::get	(	std::shared_ptr< T > &	rRetVal,
		const glo::ObjID &	rObjID )

Liefert ein Objekt in einem std::shared_ptr aus dem AllSet der Datenbank mit übergebener Objekt-ID.

Parameter

[in,out]	rRetVal	Bei keinem Fehler ist das geholte Objekt im std::shared_ptr.
[in]	rObjID	Die Objekt-ID.

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

◆ get() [4/6]

template<class T >

int glo::TAllSet< T >::get	(	std::shared_ptr< T > &	rRetVal,
		EnSeekMode	eMode )

Liefert ein Objekt in einem std::shared_ptr aus dem AllSet der Datenbank in Bezug auf eMode.

Parameter

[in,out]	rRetVal	Bei keinem Fehler ist das geholte Objekt im std::shared_ptr.
[in]	eMode	Der Suchmodus.

Parameterbeispiele:

glo::START = liefert erstes Element
glo::END = liefert letztes Element
glo::CURRENT = liefert aktuelles Element
glo::NEXT = liefert nächstes Element
glo::PREVIOUS = liefert vorheriges Element

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an. Eine Rückgabe == glo::ERR_RANGE zeigt das Ende des AllSets an.

◆ get() [5/6]

template<class T >

int glo::TAllSet< T >::get	(	T *&	prRetVal,
		const glo::ObjID &	rObjID )

Liefert ein Objekt aus dem AllSet der Datenbank mit übergebener Objekt-ID.

Parameter

[in,out]	prRetVal	Bei keinem Fehler das geholte Objekt.
[in]	rObjID	Die Objekt-ID.

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

Achtung: Wenn prRetVal gültig, muss dieses Objekt von der aufrufenden Instanz aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Betracht zu ziehen und die Methode getPersistent(std::shared_ptr<BasePersistent>&, const glo::ObjID&) bzw. get( std::shared_ptr<T> & rRetVal, const glo::ObjID & rObjID ) zu nutzen.

◆ get() [6/6]

template<class T >

int glo::TAllSet< T >::get	(	T *&	prRetVal,
		EnSeekMode	eMode )

Liefert ein Objekt aus dem AllSet der Datenbank in Bezug auf eMode.

Parameter

[in,out]	prRetVal	Bei keinem Fehler das geholte Objekt.
[in]	eMode	Der Suchmodus.

Parameterbeispiele:

glo::START = liefert erstes Element
glo::END = liefert letztes Element
glo::CURRENT = liefert aktuelles Element
glo::NEXT = liefert nächstes Element
glo::PREVIOUS = liefert vorheriges Element

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an. Eine Rückgabe == glo::ERR_RANGE zeigt das Ende des AllSets an.

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

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Betracht zu ziehen und die Methode get(std::shared_ptr<T>&, EnSeekMode) zu nutzen.

◆ getIndexedOndemands() [1/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsFullIndexName,
		const std::string &	rsIndexSearchValue,
		EnComparisionOp	eComparisionOp )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter. Es können Ergebnisse mittels des Parameters eComparisionOp definiert werden. Wenn z.B. Parameter sIndex den Wert "123" und Parameter eComparisionOp den Wert glo::LESS hat, werden alle Objekte mit dem Index kleiner 123 geliefert.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsFullIndexName	Die Indexbezeichnung des zu durchsuchenden Index. Der Index Name muss mit vollständigen Klassennamen übergeben werden (z.B. "mynamespace::MyClassName.IndexName").
[in]	rsIndexSearchValue	Der Indexwert.
[in]	eComparisionOp	Der Vergleichsoperator. Wenn z.B. rsIndex den Wert "123" und eComparisionOp den Wert glo::LESS hat, werden alle Objekte mit dem Index kleiner 123 geliefert.

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

Zu beachten: Es werden ggf. vorhandene Platzhalter '*' und '?' im Parameter rsIndexSearchValue NICHT berücksichtigt.; Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getIndexedOndemands() [2/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsFullIndexName,
		const std::string &	rsIndexSearchValue,
		EnQueryType	eQuerryType )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebenen Parameter.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsFullIndexName	Die Indexbezeichnung des zu durchsuchenden Index. Der Index Name muss mit vollständigen Klassennamen übergeben werden (z.B. "mynamespace::MyClassName.IndexName").
[in]	rsIndexSearchValue	Der Indexausdruck kann die Platzhalter '*' und '?' enthalten, welche bei der Auswertung berücksichtigt werden oder wenn Parameter eQueryType == eOQL, wird der String als OQL-Ausdruck interpretiert.
[in]	eQuerryType	Der Abfragetyp.

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

Zu beachten: Es muss im AllSet der IndexName bekannt sein.
Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getIndexedOndemands() [3/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsFullIndexName,
		const std::string &	rsRangeStartIndexSearchValue,
		const std::string &	rsRangeEndIndexSearchValue )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter. Es können Ergebnisse mittesl Bereichsangabe definiert werden. Wenn z.B. Parameter sIndex den Wert "123" und Parameter sRangeEndIndex den Wert "155" hat, werden alle Objekte mit dem Index grösser/gleich 123 und kleiner/gleich 155 geliefert.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsFullIndexName	Die Indexbezeichnung des zu durchsuchenden Index. Der Index Name muss mit vollständigen Klassennamen übergeben werden (z.B. "mynamespace::MyClassName.IndexName").
[in]	rsRangeStartIndexSearchValue	Der Start-Indexwert.
[in]	rsRangeEndIndexSearchValue	Der End-Indexwert.

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

Zu beachten: Es werden ggf. vorhandene Platzhalter '*' und '?' im Parameter rsIndexSearchValue NICHT berücksichtigt.; Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getIndexedOndemands() [4/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsIndexName,
		unsigned long	ulIndexClassID,
		const std::string &	rsIndexSearchValue,
		EnComparisionOp	eComparisionOp )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter. Es können Ergebnisse mittels des Parameters eComparisionOp definiert werden. Wenn z.B. Parameter sIndex den Wert "123" und Parameter eComparisionOp den Wert glo::LESS hat, werden alle Objekte mit dem Index kleiner 123 geliefert.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsIndexName	Die Indexbezeichnung des zu durchsuchenden Index. Der Index Name muss mit vollständigen Klassennamen übergeben werden (z.B. "mynamespace::MyClassName.IndexName").
[in]	ulIndexClassID	Die ID der Klasse, welche mit dem 'rsIndexName' indiziert ist. Damit ist es möglich, den Index einer Oberklasse zu nutzen.
[in]	rsIndexSearchValue	Der Indexwert.
[in]	eComparisionOp	Der Vergleichsoperator. Wenn z.B. rsIndex den Wert "123" und eComparisionOp den Wert glo::LESS hat, werden alle Objekte mit dem Index kleiner 123 geliefert.

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

Zu beachten: Es werden ggf. vorhandene Platzhalter '*' und '?' im Parameter rsIndexSearchValue NICHT berücksichtigt.; Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getIndexedOndemands() [5/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsIndexName,
		unsigned long	ulIndexClassID,
		const std::string &	rsIndexSearchValue,
		EnQueryType	eQuerryType )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebenen Parameter.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsIndexName	Die Indexbezeichnung des zu durchsuchenden Index. Der Index Name muss mit vollständigen Klassennamen übergeben werden (z.B. "mynamespace::MyClassName.IndexName").
[in]	ulIndexClassID	Die ID der Klasse, welche mit dem 'rsIndexName' indiziert ist. Damit ist es möglich, den Index einer Oberklasse zu nutzen.
[in]	rsIndexSearchValue	Der Indexausdruck kann die Platzhalter '*' und '?' enthalten, welche bei der Auswertung berücksichtigt werden oder wenn Parameter eQueryType == eOQL, wird der String als OQL-Ausdruck interpretiert.
[in]	eQuerryType	Der Abfragetyp.

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

Zu beachten: Es muss im AllSet der IndexName bekannt sein.
Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getIndexedOndemands() [6/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsIndexName,
		unsigned long	ulIndexClassID,
		const std::string &	rsRangeStartIndexSearchValue,
		const std::string &	rsRangeEndIndexSearchValue )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter. Es können Ergebnisse mittesl Bereichsangabe definiert werden. Wenn z.B. Parameter sIndex den Wert "123" und Parameter sRangeEndIndex den Wert "155" hat, werden alle Objekte mit dem Index grösser/gleich 123 und kleiner/gleich 155 geliefert.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsIndexName	Die Indexbezeichnung des zu durchsuchenden Index. Der Index Name muss mit vollständigen Klassennamen übergeben werden (z.B. "mynamespace::MyClassName.IndexName").
[in]	ulIndexClassID	Die ID der Klasse, welche mit dem 'rsIndexName' indiziert ist. Damit ist es möglich, den Index einer Oberklasse zu nutzen.
[in]	rsRangeStartIndexSearchValue	Der Start-Indexwert.
[in]	rsRangeEndIndexSearchValue	Der End-Indexwert.

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

Zu beachten: Es werden ggf. vorhandene Platzhalter '*' und '?' im Parameter rsIndexSearchValue NICHT berücksichtigt.; Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getIndexedOndemands() [7/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsIndexSearchValue,
		EnComparisionOp	eComparisionOp )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter. Es können Ergebnisse mittels des Parameters eComparisionOp definiert werden. Wenn z.B. Parameter sIndex den Wert "123" und Parameter eComparisionOp den Wert glo::LESS hat, werden alle Objekte mit dem Index kleiner 123 geliefert.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsIndexSearchValue	Der Indexwert.
[in]	eComparisionOp	Der Vergleichsoperator. Wenn z.B. rsIndex den Wert "123" und eComparisionOp den Wert glo::LESS hat, werden alle Objekte mit dem Index kleiner 123 geliefert.

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

Zu beachten: Es werden ggf. vorhandene Platzhalter '*' und '?' im Parameter rsIndexSearchValue NICHT berücksichtigt.
Es muss im AllSet der IndexName gesetzt sein.
Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getIndexedOndemands() [8/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsIndexSearchValue,
		EnQueryType	eQuerryType )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsIndexSearchValue	Der Indexausdruck kann die Platzhalter '*' und '?' enthalten, welche bei der Auswertung berücksichtigt werden oder wenn Parameter eQueryType == eOQL, wird der String als OQL-Ausdruck interpretiert. Zu beachten; OQL ist noch nicht implementiert!
[in]	eQuerryType	Der Abfragetyp.

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

Zu beachten: Es muss im AllSet der IndexName gesetzt sein.
Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getIndexedOndemands() [9/9]

template<class T >

int glo::TAllSet< T >::getIndexedOndemands	(	std::vector< glo::TOndemand< T > > &	rOndemandVector,
		const std::string &	rsRangeStartIndex,
		const std::string &	rsRangeEndIndex )

Liefert einen Vector von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter. Es können Ergebnisse mittesl Bereichsangabe definiert werden. Wenn z.B. Parameter sIndex den Wert "123" und Parameter sRangeEndIndex den Wert "155" hat, werden alle Objekte mit dem Index grösser/gleich 123 und kleiner/gleich 155 geliefert.

Parameter

[in,out]	rOndemandVector	In diesem Vector werden die gefundenen glo::TOndemand's geliefert.
[in]	rsRangeStartIndex	Der Start-Indexwert.
[in]	rsRangeEndIndex	Der End-Indexwert.

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

Zu beachten: Es muss im AllSet der IndexName gesetzt sein.
Indexe werden erst nach dem Öffnen des AllSets ermittelt.

Siehe auch: setFullIndexName(const std::string&)

◆ getOndemand() [1/3]

template<class T >

int glo::TAllSet< T >::getOndemand	(	glo::TOndemand< T > &	rRetVal,
		EnSeekMode	eMode )

Liefert ein Objekt im übergebenen glo::TOndemand aus dem AllSet der Datenbank in Bezug auf eMode.

Parameter

[in,out]	rRetVal	Bei keinem Fehler das geholte Objekt im übergebenen glo::TOndemand.
[in]	eMode	Der Suchmodus.

Parameterbeispiele:

glo::START = liefert erstes Element
glo::END = liefert letztes Element
glo::CURRENT = liefert aktuelles Element
glo::NEXT = liefert nächstes Element
glo::PREVIOUS = liefert vorheriges Element

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an. Eine Rückgabe == glo::ERR_RANGE zeigt das Ende des AllSets an.

◆ getOndemand() [2/3]

template<class T >

int glo::TAllSet< T >::getOndemand	(	glo::TOndemand< T > *&	prRetVal,
		EnSeekMode	eMode )

Liefert einem neuen glo::TOndemand-Objekt aus dem AllSet der Datenbank in Bezug auf eMode.

Parameter

[in,out]	prRetVal	Bei keinem Fehler das geholte Objekt in einem neuen glo::TOndemand.
[in]	eMode	Der Suchmodus.

Parameterbeispiele:

glo::START = liefert erstes Element
glo::END = liefert letztes Element
glo::CURRENT = liefert aktuelles Element
glo::NEXT = liefert nächstes Element
glo::PREVIOUS = liefert vorheriges Element

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an. Eine Rückgabe == glo::ERR_RANGE zeigt das Ende des AllSets an.

Achtung: Wenn prRetVal gültig, muss dieses Objekt von der aufrufenden Instanz aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Betracht zu ziehen und die Methode getOndemand(std::shared_ptr< glo::TOndemand<T> >&, EnSeekMode) oder getOndemand(glo::TOndemand<T>&, EnSeekMode) zu nutzen.

◆ getOndemand() [3/3]

template<class T >

int glo::TAllSet< T >::getOndemand	(	std::shared_ptr< glo::TOndemand< T > > &	rRetVal,
		EnSeekMode	eMode )

Liefert ein glo::TOndemand-Objekt in einem std::shared_ptr aus dem AllSet der Datenbank in Bezug auf eMode.

Parameter

[in,out]	rRetVal	Bei keinem Fehler das geholte Objekt in einem std::shared_ptr.
[in]	eMode	Der Suchmodus.

Parameterbeispiele:

glo::START = liefert erstes Element
glo::END = liefert letztes Element
glo::CURRENT = liefert aktuelles Element
glo::NEXT = liefert nächstes Element
glo::PREVIOUS = liefert vorheriges Element

Rückgabe: Eine Rückgabe < 0 zeigt einen Fehler an. Eine Rückgabe == glo::ERR_RANGE zeigt das Ende des AllSets an.

◆ getPersistent() [1/2]

template<class T >

int glo::TAllSet< T >::getPersistent	(	BasePersistent *&	prRetVal,
		const glo::ObjID &	rObjID )

virtual

Liefert ein Objekt aus dem AllSet der Datenbank mit übergebener Objekt-ID.

Parameter

[in,out]	prRetVal	Bei keinem Fehler das geholte Objekt.
[in]	rObjID	Die Objekt-ID.

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

Achtung: Wenn prRetVal gültig, muss dieses Objekt von der aufrufenden Instanz aus dem Speicher entfernt werden.

Zu beachten: Es wird empfohlen, wenn möglich, die Verwendung von std::shared_ptr in Betracht zu ziehen und die Methode getPersistent(std::shared_ptr<BasePersistent>&, const glo::ObjID&) bzw. get( std::shared_ptr<T> & rRetVal, const glo::ObjID & rObjID ) zu nutzen.

Implementiert glo::AbstractBaseLot.

◆ getPersistent() [2/2]

template<class T >

int glo::TAllSet< T >::getPersistent	(	std::shared_ptr< BasePersistent > &	rRetVal,
		const glo::ObjID &	rObjID )

virtual

Liefert ein Objekt mit übergebener Objekt-ID aus dem Container.

Parameter

[in,out]	rRetVal	Bei keinem Fehler das geholte Objekt.
[in]	rObjID	Die Objekt-ID.

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

Erneute Implementation von glo::AbstractBaseLot.

◆ operator=()

template<class T >

TAllSet< T > & glo::TAllSet< T >::operator= ( const TAllSet< T > & )

private

Der Zuweisungsoperator steht nicht zur Verfügung.

◆ setWatch()

template<class T >

int glo::TAllSet< T >::setWatch	(	TdWatchNotifyMode	ulWatchMode,
		CallBack *	pCallBack = 0 )

virtual

Der AllSet wird in der Datenbank überwacht.

Parameter

[in]	ulWatchMode	Der Überwachungsmodus. Erlaubte Überwachungsmodi: WNM_WRITE = schreiben wird gemeldet WNM_WRITE_TRANSACTION = wie WNM_WRITE, wird in einer Transaktion ausgelöst WNM_DELETE = löschen wird gemeldet WNM_DELETE_TRANSACTION = wie WNM_DELETE, wird in einer Transaktion ausgelöst WNM_LOCK = sperren wird gemeldet WNM_UNLOCK = freigeben wird gemeldet WNM_INSERT = einfügen eines neuen Objektes im AllSet wird gemeldet WNM_INSERT_TRANSACTION = wie WNM_INSERT, wird in einer Transaktion ausgelöst
[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, CallBack*) mit gleichen Parameterwerten genutzt werden.

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

Siehe auch: Beobachten und benachrichtigen.

Implementiert glo::BaseAllSet.

◆ transferObjIListIntoOndemandVector()

template<class T >

void glo::TAllSet< T >::transferObjIListIntoOndemandVector	(	const std::vector< glo::ObjID > &	rSourceContainer,
		std::vector< glo::TOndemand< T > > &	rTargetVevtor )

private

Überträgt die glo::ObjID's aus der übergebenen rSourceContainer als glo::TOndemand's in den übergebenen rTargetVevtor.

Parameter

[in]	rSourceContainer	Die Liste mite den glo::ObjID's.
[in,out]	rTargetVevtor	Der resultierende Vector von glo::TOndemand's.

◆ unsetWatch()

template<class T >

int glo::TAllSet< T >::unsetWatch	(	TdWatchNotifyMode	ulWatchMode,
		CallBack *	pCallBack = 0 )

virtual

Die Überwachung des AllSets in der referenzierten Datenbank wird aufgehoben.

Parameter

[in]	ulWatchMode	Der Überwachungsmodus. Erlaubte Überwachungsmodi: WNM_WRITE = schreiben wird gemeldet WNM_WRITE_TRANSACTION = wie WNM_WRITE, wird in einer Transaktion ausgelöst WNM_DELETE = löschen wird gemeldet WNM_DELETE_TRANSACTION = wie WNM_DELETE, wird in einer Transaktion ausgelöst WNM_LOCK = sperren wird gemeldet WNM_UNLOCK = freigeben wird gemeldet WNM_INSERT = einfügen eines neuen Objektes im AllSet wird gemeldet WNM_INSERT_TRANSACTION = wie WNM_INSERT, wird in einer Transaktion ausgelöst
[in]	pCallBack	Das CallBack-Objekt, welches über seine Methode CallBack::notify(NotifyNote&) benachrichtigt werden sollte.

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

Zu beachten: Hebt die Überwachung auf, die durch die korrespondierende Methode setWatch(TdWatchNotifyMode, CallBack*) initiiet wurde, wenn die Parameter die selben Werte haben.

Siehe auch: Beobachten und benachrichtigen.

Implementiert glo::BaseAllSet.

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

GloTAllSet.h

Öffentliche Methoden

Private Methoden

Weitere Geerbte Elemente

Ausführliche Beschreibung

Beschreibung der Konstruktoren und Destruktoren

◆ TAllSet() [1/4]

◆ TAllSet() [2/4]

◆ TAllSet() [3/4]

◆ ~TAllSet()

◆ TAllSet() [4/4]

Dokumentation der Elementfunktionen

◆ get() [1/6]

◆ get() [2/6]

◆ get() [3/6]

◆ get() [4/6]

◆ get() [5/6]

◆ get() [6/6]

◆ getIndexedOndemands() [1/9]

◆ getIndexedOndemands() [2/9]

◆ getIndexedOndemands() [3/9]

◆ getIndexedOndemands() [4/9]

◆ getIndexedOndemands() [5/9]

◆ getIndexedOndemands() [6/9]

◆ getIndexedOndemands() [7/9]

◆ getIndexedOndemands() [8/9]

◆ getIndexedOndemands() [9/9]

◆ getOndemand() [1/3]

◆ getOndemand() [2/3]

◆ getOndemand() [3/3]

◆ getPersistent() [1/2]

◆ getPersistent() [2/2]

◆ operator=()

◆ setWatch()

◆ transferObjIListIntoOndemandVector()

◆ unsetWatch()