com.tailf.dp

Interface DpServiceCallback

All Known Implementing Classes:

ServiceCallbackProxy

public interface DpServiceCallback

This interface is used for the service callbacks.

See Also:

Dp.registerAnnotatedCallbacks(Object)

Field Summary

Fields

Modifier and Type	Field and Description
static int	M_CREATE Flags for the mask
static int	M_DELETE
static int	M_POST_MODIFICATION
static int	M_PRE_LOCK_CREATE
static int	M_PRE_MODIFICATION
static int	M_UPDATE

Method Summary

Methods

Modifier and Type	Method and Description
Properties	create(ServiceContext context, NavuNode service, NavuNode root, Properties opaque) Create callback method.
int	mask() Mask of flags for each method that is supported by this callback: M_CREATE M_UPDATE M_DELETE M_PRE_MODIFICATION M_POST_MODIFICATION
Properties	postModification(ServiceContext context, ServiceOperationType operation, ConfPath path, Properties opaque) Post modification callback If registered this method will be called after a CREATE, UPDATE or DELETE of the service.
Properties	preLockCreate(ServiceContext context, NavuNode service, NavuNode root, Properties opaque) pre lock create callback method.
Properties	preModification(ServiceContext context, ServiceOperationType operation, ConfPath path, Properties opaque) Pre modification callback If registered this method will be called before a CREATE, UPDATE or DELETE of the service.
String	servicepoint() The name of the servicepoint

Field Detail

M_CREATE

static final int M_CREATE

Flags for the mask

See Also:

Constant Field Values

M_DELETE

static final int M_DELETE

See Also:

Constant Field Values

M_POST_MODIFICATION

static final int M_POST_MODIFICATION

See Also:

Constant Field Values

M_PRE_LOCK_CREATE

static final int M_PRE_LOCK_CREATE

See Also:

Constant Field Values

M_PRE_MODIFICATION

static final int M_PRE_MODIFICATION

See Also:

Constant Field Values

M_UPDATE

static final int M_UPDATE

See Also:

Constant Field Values

Method Detail

create

Properties create(ServiceContext context,
                NavuNode service,
                NavuNode root,
                Properties opaque)
                  throws DpCallbackException

Create callback method. This method is called when a service instance committed due to a create or update event. This method returns a opaque as a Properties object that can be null. If not null it is stored persistently by Ncs. This object is then delivered as argument to new calls of the create method for this service (fastmap algorithm). This way the user can store and later modify persistent data outside the service model that might be needed.

Parameters:

context - - The current ServiceContext object

service - - The NavuNode references the service node.

root - - This NavuNode references the ncs root.

opaque - - Parameter contains a Properties object. This object may be used to transfer additional information between consecutive calls to the create callback. It is always null in the first call. I.e. when the service is first created.

Returns:

Properties the returning opaque instance

Throws:

DpCallbackException

mask

int mask()

Mask of flags for each method that is supported by this callback:

• M_CREATE
• M_UPDATE
• M_DELETE
• M_PRE_MODIFICATION
• M_POST_MODIFICATION

postModification

Properties postModification(ServiceContext context,
                          ServiceOperationType operation,
                          ConfPath path,
                          Properties opaque)
                            throws DpCallbackException

Post modification callback If registered this method will be called after a CREATE, UPDATE or DELETE of the service. This is also called with a service context that is of the original transaction. This implies that changes written into this transaction will stay persistent outside of the fastmap algorithm. I.e. will be left untouched by the fastmap algorithm. This can be useful e.g. for allocations that should be stored and existing also when the service instance is removed.

Parameters:

context - - The current ServiceContext object

operation - - Type of operation (CREATE,UPDATE,DELETE)

path - - ConfPath object referring to the services path

opaque - - Parameter contains a Properties object. This object may be used to transfer additional information between consecutive calls to the create callback. It is always null in the first call. I.e. when the service is first created.

Returns:

Properties - the returning opaque instance

Throws:

DpCallbackException

preLockCreate

Properties preLockCreate(ServiceContext context,
                       NavuNode service,
                       NavuNode root,
                       Properties opaque)
                         throws DpCallbackException

pre lock create callback method. This method is called when a service instance committed due to a create or update event in the same way as the create() callback. The difference being that this method is called outside of the transaction lock of the current transaction making it parallel to other pre_lock_create() service calls. Care must be taken by the programmer so that the preLockCreate() is designed in a thread safe manner. This method returns a opaque as a Properties object that can be null. If not null it is stored persistently by Ncs. This object is then delivered as argument to new calls of the create method for this service (fastmap algorithm). This way the user can store and later modify persistent data outside the service model that might be needed.

Parameters:

context - - The current ServiceContext object

service - - The NavuNode references the service node.

root - - This NavuNode references the ncs root.

opaque - - Parameter contains a Properties object. This object may be used to transfer additional information between consecutive calls to the create callback. It is always null in the first call. I.e. when the service is first created.

Returns:

Properties the returning opaque instance

Throws:

DpCallbackException

preModification

Properties preModification(ServiceContext context,
                         ServiceOperationType operation,
                         ConfPath path,
                         Properties opaque)
                           throws DpCallbackException

Pre modification callback If registered this method will be called before a CREATE, UPDATE or DELETE of the service. This is also called with a service context that is of the original transaction. This implies that changes written into this transaction will stay persistent outside of the fastmap algorithm. I.e. will be left untouched by the fastmap algorithm. This can be useful e.g. for allocations that should be stored and existing also when the service instance is removed.

Parameters:

context - - The current ServiceContext object

operation - - Type of operation (CREATE,UPDATE,DELETE)

path - - ConfPath object referring to the services path

opaque - - Parameter contains a Properties object. This object may be used to transfer additional information between consecutive calls to the create callback. It is always null in the first call. I.e. when the service is first created.

Returns:

Properties - the returning opaque instance

Throws:

DpCallbackException

servicepoint

String servicepoint()

The name of the servicepoint