ILS_W_RELATION

ILS_W_RELATION_1

Category

Dynamic view-related macro (server side)

Description

This macro declares a simple server relation as being accessible at runtime. This relation can be of type IlsOwns or IlsUses. It differs from the relations declared with the macros ILS_OWNS_1 or ILS_USES_1 in that its modifier is user-defined.

This macro can be enclosed only between the following pairs of macros:

ILS_OBJECT_BEGIN/ILS_OBJECT_END

ILS_ENTITY_BEGIN/ILS_ENTITY_END

ILS_MVVIEW_BEGIN/ILS_MVVIEW_END

or their derivatives.

Header File

#include <ilserver/rtmodel.h>

Synopsis

ILS_W_RELATION_1(originType,targetType,relation,setTarget)

Arguments

This macro takes the following arguments:

originType is the class where the relation is declared.

targetType is the target class.

relation is the name of the relation.

setTarget is the target modifier. Its signature is the following:

IlsBoolean ownerType::setTarget(targetType*);

It can vary under the following conditions:

The function is a member of the class originType or of a parent class.

It converts to IlsBoolean.

It can be invoked with an argument of type targetType*.

When the modifier returns IlsFalse and the rollback mode is enabled by the component, the current transaction is rolled back by the server and a rollback transaction is sent to the component that requested the modification. See the “Transaction Control” sections in the IlsMvComponent and IlsMvServer class descriptions for more information.