org.mobicents.javax.servlet.sip
Interface SipSessionExt

public interface SipSessionExt

Interface Extension that adds extra features to the JSR 289 SipSession interface.
It adds the following capabilities :

• Allows for applications to set the outbound interface based on SipURI, to allow routing based on transport protocol as well.

Since:

1.4

Author:

jean.deruelle@gmail.com

Method Summary

void	setOutboundInterface(SipURI outboundInterface) In multi-homed environment this method can be used to select the outbound interface to use when sending requests for this SipSession.

Method Detail

setOutboundInterface

void setOutboundInterface(SipURI outboundInterface)

In multi-homed environment this method can be used to select the outbound interface to use when sending requests for this SipSession. The specified address must be the address of one of the configured outbound interfaces. The set of SipURI objects which represent the supported outbound interfaces can be obtained from the servlet context attribute named javax.servlet.sip.outboundInterfaces. Invocation of this method also impacts the system headers generated by the container for this message, such as the the Via and the Contact header. The supplied IP address, port and transport are used to construct these system headers.

Parameters:

outboundInterface - the sip uri representing the outbound interface to use when sending requests out

Throws:

java.lang.NullPointerException - on null sip uri

java.lang.IllegalArgumentException - if the sip uri is not understood by the container as one of its outbound interface