org.objectweb.jonathan.protocols.api
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
.
send
public 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).
exception
- the exception that occurred;session
- the sending session.
send
public 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).
message
- the message to send up;session
- the sending session.