Set of uses relations. More...

#include <ilserver/model.h>

Inheritance diagram for IlsUsesSet< UserType, UsedType, KeyType, KeyManager >:

Public Types
typedef IlsSetRelationIterator< Myself >	Iterator
	Non const iterator.

typedef IlsUsesSet< UserType, UsedType, KeyType, KeyManager >	Myself
	`Myself` is the type of the instantiated template class.

Public Member Functions
	IlsUsesSet (UserType &user, IlsRelationId identifier=IlsDefaultRelationId, IlsActivity activity=IlsModel::GetDefaultActivity(), IlsCardinality mincard=0, IlsCardinality maxcard=ILS_UNLIMITED_MAXCARD, Initial &targets=(*new Initial()), IlsBoolean check_card=IlsTrue)
	Constructor. More...

virtual	~IlsUsesSet ()
	This destructor breaks all the relations in the set.

Myself &	clear ()

virtual void	cut (Partial &, ILS_CUT_DIRECTIVE d=ILS_ALL)

UsedTypeP	get (CKeyTypeR identifier)

IlsActivity	getActivity () const

UsedType **	getAdded (int &)
	During a notification phase, this member function returns an array of pointers to the elements that have been added to the set since the last notification phase. More...

unsigned int	getCount ()
	Returns the number of objects in the set at a given time.

virtual IlsViewed *	getIdentifiedElement (const IlsString &id) const
	This virtual member function is used to retrieve an identified object from the relation. More...

UsedType **	getRemoved (int &)
	During a notification phase, this member function returns an array of pointers to the elements that have been removed from the set since the last notification phase. More...

UserType &	getUser () const

virtual IlsBoolean	hasElement (IlsViewed &) const
	This virtual member function returns `IlsTrue` if the element is a target of the relation or `IlsFalse` otherwise.

IlsBoolean	isIn (CKeyTypeR identifier)
	Indicates whether the set contains the object associated with the key specified.

Myself &	operator<< (CUsedTypePR v)

Myself &	operator>> (CUsedTypePR v)

UsedTypeP	operator[] (CKeyTypeR identifier)
	This operation is identical to the member function `get()`.

Myself &	put (CUsedTypePR)

Myself &	suppress (CKeyTypeR identifier, ILS_CUT_DIRECTIVE=ILS_ALL)

Public Member Functions inherited from IlsSetRelation
IlsActivity	getActivity () const

unsigned int	getCount () const
	Returns the number of objects in the set at a given time.

IlsRelationId	getIdentifier () const
	Returns the relation identifier.

IlsCardinality	getMaxCard () const
	Returns the maximal cardinality specified for the set.

IlsCardinality	getMinCard () const
	Returns the minimal cardinality specified for the set.

IlsBoolean	isCountModified ()

IlsBoolean	isModified ()
	Indicates whether the set has been modified.

Static Public Member Functions
static Initial &	NewInitial ()

Detailed Description

template<class UserType, class UsedType, class KeyType, class KeyManager>
class IlsUsesSet< UserType, UsedType, KeyType, KeyManager >

Set of uses relations.

Template Parameters

UserType	Class that contains the relation,
UsedType	Class of the targets of the relation.
KeyType	The type of the key used to store objects in a set and retrieve objects from a set.
KeyManager	A class that specifies how to handle keys.

Library: server

Rogue Wave Server lets you declare use relations among object classes. Use relations are relations in which one particular object can be used by any number of other objects. The user object can also use one or more other objects. One-to-many relations can be defined as list-relations or as set-relations. Unlike list-relations, target objects in set-relations are not listed in sequential order but are grouped together in a non-ordered set and are directly accessible using a key. Such relations are declared within the user class as instances of the class template IlsUsesSet.

See also: IlsEntity, IlsHashKeyManager, IlsObject, IlsOwnsSet, IlsUsesList, IlsUsesSet::Iterator.

Constructor & Destructor Documentation

◆ IlsUsesSet()

template<class UserType , class UsedType , class KeyType , class KeyManager >

IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::IlsUsesSet	(	UserType &	user,
		IlsRelationId	identifier = `IlsDefaultRelationId`,
		IlsActivity	activity = `IlsModel::GetDefaultActivity()`,
		IlsCardinality	mincard = `0`,
		IlsCardinality	maxcard = `ILS_UNLIMITED_MAXCARD`,
		Initial &	targets = `(*new Initial())`,
		IlsBoolean	check_card = `IlsTrue`
	)

Constructor.

Parameters

user	A reference to the user object.
identifier	A relation identifier of type `IlsRelationId`. This argument defaults to `IlsDefaultRelationId`. It is generally used to invert relations.
activity	Specifies whether the relation is active or not. A relation is active if its modification sets off the recomputation of derived data members. The default value is the one returned by the member function `IlsModel::GetDefaultActivity()`, which is `ILS_INACTIVE` by default.
mincard	The minimal cardinality of the list. This argument is optional and defaults to zero.
maxcard	The maximal cardinality of the list. This argument is optional and defaults to `ILS_UNLIMITED_MAXCARD`.
targets	A list of objects. Its creates an empty list when set to its default value.
check_card	The argument `check_card` specifies whether cardinalities should be checked at construction.

Member Function Documentation

◆ clear()

template<class UserType , class UsedType , class KeyType , class KeyManager >

Myself& IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::clear ( )

\short Clears the list.

Exceptions

IlsMinCardViolated	If the minimal cardinality is different from zero. The number of objects left in the set will be equal to the minimal cardinality specified.
IlsUpdateForbidden	If the member function `isUpdatedAllowed()` returns `IlsFalse` for the type in which the relation is declared.

◆ cut()

template<class UserType , class UsedType , class KeyType , class KeyManager >

virtual void IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::cut	(	Partial &	,
		ILS_CUT_DIRECTIVE	d = `ILS_ALL`
	)

virtual

This static member function is called when a cut is applied to one of the used objects.

◆ get()

template<class UserType , class UsedType , class KeyType , class KeyManager >

UsedTypeP IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::get ( CKeyTypeR identifier )

\short Returns the object associated with the key

specified; otherwise, it returns 0.

◆ getActivity()

template<class UserType , class UsedType , class KeyType , class KeyManager >

IlsActivity IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::getActivity ( ) const

\short Returns \c ILS_ACTIVE if the relation has
been set as active. Otherwise, it returns \c ILS_INACTIVE.

For details, see the constructor.

◆ getAdded()

template<class UserType , class UsedType , class KeyType , class KeyManager >

UsedType** IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::getAdded ( int & )

During a notification phase, this member function returns an array of pointers to the elements that have been added to the set since the last notification phase.

It returns an empty array if no object has been added to the
set-relation.

The argument accepts the size of the array as a return value.

You must explicitly destroy this array when you no longer need it. To do so, use delete with square brackets [].

◆ getIdentifiedElement()

template<class UserType , class UsedType , class KeyType , class KeyManager >

virtual IlsViewed* IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::getIdentifiedElement ( const IlsString & id ) const

virtual

This virtual member function is used to retrieve an identified object from the relation.

The member function IlsViewed::getKeyIdentifier() is used to retrieve the identifier of the relation element.

Note: On all subclasses of this class, the complexity of this method is always linear, in terms of the number of elements in the relation, even for set relations.

Reimplemented from IlsViewedRel.

◆ getRemoved()

template<class UserType , class UsedType , class KeyType , class KeyManager >

UsedType** IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::getRemoved ( int & )

During a notification phase, this member function returns an array of pointers to the elements that have been removed from the set since the last notification phase.

It returns an empty array if no object has been removed from the set-relation. The argument accepts the size of the array as a return value.

You must explicitly destroy this array when you no longer need it. To do so, use delete with square brackets [].

◆ getUser()

template<class UserType , class UsedType , class KeyType , class KeyManager >

UserType& IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::getUser ( ) const

\short Returns a reference to the user object.

It is useful especially in the case of derived relations.

◆ NewInitial()

template<class UserType , class UsedType , class KeyType , class KeyManager >

static Initial& IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::NewInitial ( )

static

\short Builds an empty set which is used

by the constructor as the default value of the argument targets.

◆ operator<<()

template<class UserType , class UsedType , class KeyType , class KeyManager >

Myself& IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::operator<< ( CUsedTypePR v )

\short Adds an object to the set.

\short Puts an object in the set.

A set cannot contain two objects associated with the same key.

Exceptions

IlsMaxCardViolated	If the maximal cardinality has been reached.
IlsUpdateForbidden	If the member function `isUpdateAllowed()` returns `IlsFalse` for the type in which the relation is declared.
IlsUnownedUse	If the specified object is neither an owned object nor an entity, and if the member function `IlsModel::IsIntegrityChecked()` returns `IlsTrue`.

◆ operator>>()

template<class UserType , class UsedType , class KeyType , class KeyManager >

Myself& IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::operator>> ( CUsedTypePR v )

\short Removes an object from the set.

\short Removes the object associated with the key

specified according to the cut instruction specified.

Exceptions

IlsUpdateForbidden	If the member function `isUpdatedAllowed()` returns `IlsFalse` for the type in which the relation is declared.
IlsMinCardViolated	If the minimal cardinality has been reached.
IlsNotFound	If no object is associated with the key specified.

◆ put()

template<class UserType , class UsedType , class KeyType , class KeyManager >

Myself& IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::put ( CUsedTypePR )

\short Puts an object in the set.

A set cannot contain two objects associated with the same key.

Exceptions

IlsMaxCardViolated	If the maximal cardinality has been reached.
IlsUpdateForbidden	If the member function `isUpdateAllowed()` returns `IlsFalse` for the type in which the relation is declared.
IlsUnownedUse	If the specified object is neither an owned object nor an entity, and if the member function `IlsModel::IsIntegrityChecked()` returns `IlsTrue`.

◆ suppress()

template<class UserType , class UsedType , class KeyType , class KeyManager >

Myself& IlsUsesSet< UserType, UsedType, KeyType, KeyManager >::suppress	(	CKeyTypeR	identifier,
		ILS_CUT_DIRECTIVE	= `ILS_ALL`
	)

\short Removes the object associated with the key

specified according to the cut instruction specified.

Exceptions

IlsUpdateForbidden	If the member function `isUpdatedAllowed()` returns `IlsFalse` for the type in which the relation is declared.
IlsMinCardViolated	If the minimal cardinality has been reached.
IlsNotFound	If no object is associated with the key specified.

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

template<class UserType, class UsedType, class KeyType, class KeyManager> class IlsUsesSet< UserType, UsedType, KeyType, KeyManager >

Constructor & Destructor Documentation

◆ IlsUsesSet()

Member Function Documentation

◆ clear()

◆ cut()

◆ get()

◆ getActivity()

◆ getAdded()

◆ getIdentifiedElement()

◆ getRemoved()

◆ getUser()

◆ NewInitial()

◆ operator<<()

◆ operator>>()

◆ put()

◆ suppress()

template<class UserType, class UsedType, class KeyType, class KeyManager>
class IlsUsesSet< UserType, UsedType, KeyType, KeyManager >