org.mobicents.javax.servlet

Interface ContainerListener

All Superinterfaces:

EventListener

public interface ContainerListener
extends EventListener

Causes applications to be notified of various events occuring the Container.

Method Summary

Methods

Modifier and Type	Method and Description
void	onCongestionControlStarted(CongestionControlEvent event) As soon as congestion starts in the underlying source, it calls this method to notify about it.
void	onCongestionControlStopped(CongestionControlEvent event) As soon as congestion abates in the underlying source, it calls this method to notify about it.
SipServletResponse	onRequestThrottled(SipServletRequest request, CongestionControlEvent event) When a request that comes in is not passed up to the application because of congestion control.

Method Detail

onCongestionControlStarted

void onCongestionControlStarted(CongestionControlEvent event)

As soon as congestion starts in the underlying source, it calls this method to notify about it. Notification is only one-time till the congestion abates in which case CongestionListener#onCongestionControlStopped(CongestionEvent) is called

Parameters:

source - The underlying source which is facing congestion

onCongestionControlStopped

void onCongestionControlStopped(CongestionControlEvent event)

As soon as congestion abates in the underlying source, it calls this method to notify about it. Notification is only one-time till the congestion starts again in which case CongestionListener#onCongestionStart(String) is called

Parameters:

source - The underlying source

onRequestThrottled

SipServletResponse onRequestThrottled(SipServletRequest request,
                                    CongestionControlEvent event)

When a request that comes in is not passed up to the application because of congestion control.

Parameters:

request - the request that wasn't passed up to the application because of congestion control

event - giving details on what triggered the throttling

Returns:

a SipServletResponse that should be sent back to the originator of the request. If null, then the container will generate the response automatically