jade.mtp
Interface InChannel

All Known Subinterfaces:

MTP

public interface InChannel

This interface is the receiver's view of an MTP.

Nested Class Summary

static interface

InChannel.Dispatcher Callback interface to be notified of message arrivals over this Message Transport Protocol.

Method Summary

TransportAddress	activate(InChannel.Dispatcher disp, Profile p) Activates an MTP handler for incoming messages on a default address.
void	activate(InChannel.Dispatcher disp, TransportAddress ta, Profile p) Activates an MTP handler for incoming messages on a specific address.
void	deactivate() Deactivates all the MTP handlers.
void	deactivate(TransportAddress ta) Deactivates the MTP handler listening at a given transport address.

Method Detail

activate

TransportAddress activate(InChannel.Dispatcher disp,
                          Profile p)
                          throws MTPException

Activates an MTP handler for incoming messages on a default address.

Returns:

A TransportAddress, corresponding to the chosen default address.

Throws:

MTPException - Thrown if some MTP initialization error occurs.

activate

void activate(InChannel.Dispatcher disp,
              TransportAddress ta,
              Profile p)
              throws MTPException

Activates an MTP handler for incoming messages on a specific address.

Parameters:

ta - A TransportAddress object, representing the transport address to listen to.

Throws:

MTPException - Thrown if some MTP initialization error occurs.

deactivate

void deactivate(TransportAddress ta)
                throws MTPException

Deactivates the MTP handler listening at a given transport address.

Parameters:

ta - The TransportAddress object the handle to close is listening to.

Throws:

MTPException - Thrown if some MTP cleanup error occurs.

deactivate

void deactivate()
                throws MTPException

Deactivates all the MTP handlers.

Throws:

MTPException - Thrown if some MTP cleanup error occurs.