javax.servlet.sip
Interface SipApplicationSessionListener

All Superinterfaces:

java.util.EventListener

public interface SipApplicationSessionListener
extends java.util.EventListener

Implementations of this interface can receive notifications about invalidated and/or activated SipApplicationSession objects in the SIP application they are part of. To receive notification events, the implementation class must be configured in the deployment descriptor for the servlet application.

Method Summary

void	sessionCreated(SipApplicationSessionEvent ev) Notification that a session was created.
void	sessionDestroyed(SipApplicationSessionEvent ev) Notification that a session was invalidated.
void	sessionExpired(SipApplicationSessionEvent ev) Notification that an application session has expired.
void	sessionReadyToInvalidate(SipApplicationSessionEvent ev) Notification that a SipApplicationSession is in the ready-to-invalidate state.

Method Detail

sessionCreated

void sessionCreated(SipApplicationSessionEvent ev)

Notification that a session was created.

Parameters:

ev - the notification event

sessionDestroyed

void sessionDestroyed(SipApplicationSessionEvent ev)

Notification that a session was invalidated. Either it timed out or it was explicitly invalidated. It is not possible to extend the application sessions lifetime.

Parameters:

ev - the notification event

sessionExpired

void sessionExpired(SipApplicationSessionEvent ev)

Notification that an application session has expired. The application may request an extension of the lifetime of the application session by invoking SipApplicationSession.setExpires(int).

Parameters:

ev - the notification event

sessionReadyToInvalidate

void sessionReadyToInvalidate(SipApplicationSessionEvent ev)

Notification that a SipApplicationSession is in the ready-to-invalidate state. The container will invalidate this session upon completion of this callback unless the listener implementation calls SipApplicationSessionEvent.getApplicationSession().setInvalidateWhenReady(false)

Parameters:

ev - the notification event

Since:

1.1

See Also:

SipApplicationSession.isReadyToInvalidate()