org.objectweb.jonathan.apis.protocols
Interface Session_Low

public interface Session_Low

Session_Low is the type of sessions used to forward messages coming from the network to their actual recipient; Session_Low is also the type of interfaces represented by session identifiers.

Sessions represent handles on particular communication channels: A session object is dynamically created by a protocol, and lets messages be sent and received through the communication channel it represents, using that protocol. Sessions have higher and lower interfaces, respectively used to send messages down and up a protocol stack.

Session_Low is also the type of interfaces exported to protocols, and designated by session identifiers.

Method Summary

void	send(JonathanException exception, Session_High session) Sends an exception up a protocol stack.
void	send(UnMarshaller message, Session_High session) Sends a message up a protocol stack.

Method Detail

send

void send(UnMarshaller message,
          Session_High session)
          throws JonathanException

Sends a message up a protocol stack.

This method is used to send an incoming message to its recipient. The provided session parameter represents the sender, and may possibly be used to send a reply if necessary. This session parameter may be null.

When this method is used, the target object must make sure that the provided message will be closed, as well as and the session (if not null).

Parameters:

message - the message to send up;

session - the sending session.

Throws:

JonathanException - if the sending fails.

send

void send(JonathanException exception,
          Session_High session)

Sends an exception up a protocol stack.

This method is used to warn the target session that an exception has occurred on an incoming message. The provided session parameter represents the sender, and may possibly be used to send a reply if necessary. This session parameter may be null.

When this method is used, the target object must make sure that the provided session will be closed(if not null).

Parameters:

exception - the exception that occurred;

session - the sending session.