ch.epfl.lsr.apex
Interface APEXProcess

All Known Subinterfaces:

APEXEndpointProcess, APEXRelayProcess

public interface APEXProcess

The APEXProcess the general interface for every APEX using application.

Author:

Marc Stoecklin

Method Summary

void	debug(String debugMessage) In order to debug services and processes, a set of debug messages is sent to the process.
void	notification(int code, Object specification) An process needs to redefine in order to maintain and react on different event of the APEXManager.

Method Detail

notification

public void notification(int code,
                         Object specification)

An process needs to redefine in order to maintain and react on different event of the APEXManager. The different possibilities are identified with a integer code and a Object gives addtional information for every specific event (see documentation of each code number in the APEX class), e.g.:

• APEX.NOTIFICATION_INIT: returns status messages on initialization.
• APEX.NOTIFICATION_ATTACH: a new attachment is successfully accomplished: attached an APEXEndpointAddress.
• APEX.NOTIFICATION_REMOVEATTACHMENT: an APEXEndpointAddress attachment or a binding has been released (disconnection detected).
• APEX.NOTIFICATION_BIND: a new binding is successfully accomplished: bound a String.
• APEX.NOTIFICATION_TERMINATE: one or more endpoints have been released (e.g. due to server which is down): the set of endpoints is given in a HashSet.
• APEX.NOTIFICATION_MESSAGE_IN: a new message is incident at the manager.
• APEX.NOTIFICATION_MESSAGE_SENT: a message has successfully been sent to the next hop.
• APEX.NOTIFICATION_MESSAGE_DISCARDED: a message has been discarded on sending (e.g. if the next hop is not available).

Parameters:

code - a three-digit code which specifies the event, APEX.NOTIFICATION_...

specification - an object which specifies the content of the event

See Also:

APEX

debug

public void debug(String debugMessage)

In order to debug services and processes, a set of debug messages is sent to the process. It is the choice of the programmer of the process if he wants them to be logged or not.

Parameters:

debugMessage - a new message