glo::TAllSet< T > Template-Klassenreferenz

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

#include <GloTAllSet.h>

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

Öffentliche Methoden
	TAllSet ()
	TAllSet (Base &rBase, bool bWithSubClasses=true)
	TAllSet (Base &rBase, const char *pszFullIndexName)
	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	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.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsFullIndexName, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebenen Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsFullIndexName, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebenen Parameter.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebenen Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsIndexSearchValue, EnQueryType eQuerryType)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebenen Parameter.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsFullIndexName, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsFullIndexName, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsIndexSearchValue, EnComparisionOp eComparisionOp)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsRangeStartIndex, const std::string &rsRangeEndIndex)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsRangeStartIndex, const std::string &rsRangeEndIndex)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsFullIndexName, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsFullIndexName, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (std::vector< glo::TOndemand< T > > &rOndemandContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
int	getIndexedOndemands (glo::TOndemandList< T > &rOndemandContainer, const std::string &rsIndexName, unsigned long ulIndexClassID, const std::string &rsRangeStartIndexSearchValue, const std::string &rsRangeEndIndexSearchValue)
	Liefert einen Container von glo::TOndemand's aus dem AllSet in Bezug auf die übergebene Parameter.
Ö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.

Öffentliche, statische Methoden
static unsigned long	getStaticGloClassID ()

Private Methoden
	TAllSet (const TAllSet &)
TAllSet< T > &	operator= (const TAllSet &)
void	transferObjIListIntoOndemandContainer (const std::vector< glo::ObjID > &rSourceContainer, std::vector< glo::TOndemand< T > > &rTargetConteiner)
	Überträgt die glo::ObjID's aus der übergebenen rSourceContainer als glo::TOndemand's in den übergebenen rTargetVevtor.
void	transferObjIListIntoOndemandContainer (const std::vector< glo::ObjID > &rSourceContainer, glo::TOndemandList< T > &rTargetConteiner)
	Überträgt die glo::ObjID's aus der übergebenen rSourceContainer als glo::TOndemand's in den übergebenen 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 ).

Ein AllSet kann auch Ergebnismengen liefern, welch wie beim Filtern eingeschränkt sein können (siehe
getIndexedObjIds( std::vector< glo::ObjID > & t_ObjIDContainer, const std::string & rsIndexSearchValue, EnQueryType eQuerryType ),
getIndexedObjIds( std::vector< glo::ObjID > & t_ObjIDContainer, const std::string & rsIndexSearchValue, EnComparisionOp eComparisionOp ),
getIndexedObjIds( std::vector< glo::ObjID > & t_ObjIDContainer, const std::string & rsRangeStartIndexSearchValue, const std::string & rsRangeEndIndexSearchValue ),
getIndexedOndemands( std::vector< glo::TOndemand<T> > & rOndemandContainer, const std::string & rsIndex, EnQueryType eQuerryType ),
getIndexedOndemands( std::vector< glo::TOndemand<T> > & rOndemandContainer, const std::string & rsIndex, EnComparisionOp eComparisionOp )
und
getIndexedOndemands( std::vector< glo::TOndemand<T> > & rOndemandContainer, const std::string & rsRangeStartIndex, const std::string & rsRangeEndIndex ).

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/5]

template<class T>

glo::TAllSet< T >::TAllSet

(

)

Standard-Konstruktor.

Benutzt glo::CallBack::m_strDebugInfo und SUPER.

Wird benutzt von TAllSet(), operator=(), setWatch() und unsetWatch().

TAllSet() [2/5]

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.

Benutzt glo::BaseAllSet::Base, glo::CallBack::m_strDebugInfo und SUPER.

TAllSet() [3/5]

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 als std:.string mit vollständigen Klassennamen übergeben werden (z.B. "mynamespace::MyClassName.IndexName").

Ausnahmebehandlung

eut::ErrorNException

Bei einem Fehler wird eine Exception geworfen.

Benutzt glo::BaseAllSet::Base, glo::CallBack::m_strDebugInfo und SUPER.

TAllSet() [4/5]

template<class T>

glo::TAllSet< T >::TAllSet	(	Base &	rBase,
		const char *	pszFullIndexName )

Konstruktor mit Parameterübergabe.

Parameter

[in]	rBase	Es wird die maßgebliche Datenbank mitgegeben.
[in]	pszFullIndexName	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.

Benutzt glo::BaseAllSet::Base, glo::CallBack::m_strDebugInfo und SUPER.

~TAllSet()

template<class T>

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

virtual

Destruktor.

TAllSet() [5/5]

template<class T>

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

private

Der Copy-Konstruktor steht nicht zur Verfügung.

Benutzt TAllSet().

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.

Benutzt get().

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.

Benutzt glo::END, glo::BasePersistent::forget(), glo::BaseAllSet::getBase(), glo::NEXT, glo::BaseAllSet::open(), glo::PREVIOUS und glo::START.

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.

Benutzt get().

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.

Benutzt get().

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.

Benutzt glo::ERR_WRONG_TYPE, glo::BasePersistent::forget(), glo::BaseAllSet::getBase() und glo::BaseAllSet::open().

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.

Benutzt get().

Wird benutzt von get(), get(), get() und get().

getIndexedOndemands() [1/18]

template<class T>

int glo::TAllSet< T >::getIndexedOndemands	(	glo::TOndemandList< T > &	rOndemandContainer,
		const std::string &	rsFullIndexName,
		const std::string &	rsIndexSearchValue,
		EnComparisionOp	eComparisionOp )

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [2/18]

template<class T>

int glo::TAllSet< T >::getIndexedOndemands	(	glo::TOndemandList< T > &	rOndemandContainer,
		const std::string &	rsFullIndexName,
		const std::string &	rsIndexSearchValue,
		EnQueryType	eQuerryType )

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

Parameter

[in,out]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [3/18]

template<class T>

int glo::TAllSet< T >::getIndexedOndemands	(	glo::TOndemandList< T > &	rOndemandContainer,
		const std::string &	rsFullIndexName,
		const std::string &	rsRangeStartIndexSearchValue,
		const std::string &	rsRangeEndIndexSearchValue )

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [4/18]

template<class T>

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

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [5/18]

template<class T>

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

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

Parameter

[in,out]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [6/18]

template<class T>

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

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [7/18]

template<class T>

int glo::TAllSet< T >::getIndexedOndemands	(	glo::TOndemandList< T > &	rOndemandContainer,
		const std::string &	rsIndexSearchValue,
		EnComparisionOp	eComparisionOp )

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [8/18]

template<class T>

int glo::TAllSet< T >::getIndexedOndemands	(	glo::TOndemandList< T > &	rOndemandContainer,
		const std::string &	rsIndexSearchValue,
		EnQueryType	eQuerryType )

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

Parameter

[in,out]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [9/18]

template<class T>

int glo::TAllSet< T >::getIndexedOndemands	(	glo::TOndemandList< T > &	rOndemandContainer,
		const std::string &	rsRangeStartIndex,
		const std::string &	rsRangeEndIndex )

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [10/18]

template<class T>

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

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [11/18]

template<class T>

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

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

Parameter

[in,out]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [12/18]

template<class T>

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

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [13/18]

template<class T>

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

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [14/18]

template<class T>

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

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

Parameter

[in,out]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [15/18]

template<class T>

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

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [16/18]

template<class T>

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

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [17/18]

template<class T>

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

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

Parameter

[in,out]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

getIndexedOndemands() [18/18]

template<class T>

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

Liefert einen Container 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]	rOndemandContainer	In diesem Container 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&)

Benutzt glo::BaseAllSet::getIndexedObjIds() und transferObjIListIntoOndemandContainer().

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.

Benutzt getOndemand().

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.

Benutzt glo::END, glo::BaseAllSet::getBase(), glo::ObjID::getClassID(), getOndemand(), glo::NEXT, glo::BaseAllSet::open(), glo::PREVIOUS und glo::START.

Wird benutzt von getOndemand(), getOndemand() und getOndemand().

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.

Benutzt getOndemand().

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.

Benutzt glo::ERR_NO_BASE und glo::BaseAllSet::getBase().

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.

getStaticGloClassID()

template<class T>

static unsigned long glo::TAllSet< T >::getStaticGloClassID ( )

inlinestatic

Gibt die Klassen-ID des Templates zurück.

Rückgabe

Die Klassen-ID

operator=()

template<class T>

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

private

Der Zuweisungsoperator steht nicht zur Verfügung.

Benutzt TAllSet().

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.

Benutzt TAllSet(), glo::ERR_BASE_NOT_OPEN, glo::BaseAllSet::getBase(), glo::BaseAllSet::getClassID() und glo::BaseAllSet::open().

transferObjIListIntoOndemandContainer() [1/2]

template<class T>

void glo::TAllSet< T >::transferObjIListIntoOndemandContainer ( const std::vector< glo::ObjID > & rSourceContainer, glo::TOndemandList< T > & rTargetConteiner )

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]	rTargetConteiner	Der resultierende Vector von glo::TOndemand's.

Benutzt glo::OndemandList::appendOndemand() und glo::BaseAllSet::getBase().

transferObjIListIntoOndemandContainer() [2/2]

template<class T>

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

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]	rTargetConteiner	Der resultierende Vector von glo::TOndemand's.

Benutzt glo::BaseAllSet::getBase().

Wird benutzt von getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands(), getIndexedOndemands() und getIndexedOndemands().

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.

Benutzt TAllSet(), glo::ERR_BASE_NOT_OPEN, glo::ERR_NO_BASE, glo::BaseAllSet::getBase() und glo::BaseAllSet::getClassID().

---

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

• GloTAllSet.h