org.mobicents.servlet.sip.core.session

Class SipManagerDelegate

java.lang.Object

org.mobicents.servlet.sip.core.session.SipManagerDelegate

Direct Known Subclasses:

SipStandardManagerDelegate

public abstract class SipManagerDelegate
extends Object

This class handles the management of sip sessions and sip application sessions for a given container (context) It is a delegate since it is used by many manager implementations classes (Standard and clustered ones)

Author:

Jean Deruelle

Field Summary

Fields

Modifier and Type	Field and Description
protected SipContext	container
protected int	maxActiveSipApplicationSessions The maximum number of active Sip Application Sessions allowed, or -1 for no limit.
protected int	maxActiveSipSessions The maximum number of active Sip Sessions allowed, or -1 for no limit.
protected int	rejectedSipApplicationSessions Number of sip application session creations that failed due to maxActiveSipApplicationSessions.
protected int	rejectedSipSessions Number of sip session creations that failed due to maxActiveSipSessions.
protected int	sipApplicationSessionCounter
protected ConcurrentHashMap<SipApplicationSessionKey,MobicentsSipApplicationSession>	sipApplicationSessions
protected ConcurrentHashMap<String,MobicentsSipApplicationSession>	sipApplicationSessionsByAppGeneratedKey
protected SipFactoryImpl	sipFactoryImpl
protected int	sipSessionCounter
protected ConcurrentHashMap<SipSessionKey,MobicentsSipSession>	sipSessions

Constructor Summary

Constructors

Constructor and Description
SipManagerDelegate()

Method Summary

Methods

Modifier and Type	Method and Description
void	changeSessionKey(SipSessionKey oldKey, SipSessionKey newKey)
protected MobicentsSipSession	createDerivedSipSession(MobicentsSipSession parentSipSession, SipSessionKey sessionKey) clone the parent sip session given in parameter except its attributes (they will be shared) and add it to the internal map of derived sessions identifying it by its ToTag
protected MobicentsSipApplicationSession	createSipApplicationSession(SipApplicationSessionKey key)
protected MobicentsSipSession	createSipSession(SipSessionKey key, boolean create, SipFactoryImpl sipFactoryImpl, MobicentsSipApplicationSession sipApplicationSessionImpl)
void	dumpSipApplicationSessions()
void	dumpSipSessions()
MobicentsSipApplicationSession	findSipApplicationSession(javax.servlet.http.HttpSession httpSession) Retrieves the sip application session holding the converged http session in parameter
int	getActiveSipApplicationSessions() Returns the number of active sessions
int	getActiveSipSessions() Returns the number of active sessions
Iterator<MobicentsSipApplicationSession>	getAllSipApplicationSessions() Retrieve all sip application sessions currently hold by the session manager
Iterator<MobicentsSipSession>	getAllSipSessions() Retrieve all sip sessions currently hold by the session manager
SipContext	getContainer()
int	getExpiredSipApplicationSessions() Gets the number of sessions that have expired.
int	getExpiredSipSessions() Gets the number of sessions that have expired.
int	getMaxActiveSipApplicationSessions() Return the maximum number of active Sessions allowed, or -1 for no limit.
int	getMaxActiveSipSessions() Return the maximum number of active Sessions allowed, or -1 for no limit.
protected abstract MobicentsSipApplicationSession	getNewMobicentsSipApplicationSession(SipApplicationSessionKey key, SipContext sipContext)
protected abstract MobicentsSipSession	getNewMobicentsSipSession(SipSessionKey key, SipFactoryImpl sipFactoryImpl, MobicentsSipApplicationSession mobicentsSipApplicationSession)
double	getNumberOfSipApplicationSessionCreationPerSecond()
int	getNumberOfSipApplicationSessions() Retrieve all sip application sessions currently hold by the session manager
double	getNumberOfSipSessionCreationPerSecond()
int	getNumberOfSipSessions() Retrieve all sip sessions currently hold by the session manager
int	getRejectedSipApplicationSessions() Number of sip session creations that failed due to maxActiveSipSessions
int	getRejectedSipSessions() Number of sip session creations that failed due to maxActiveSipSessions
MobicentsSipApplicationSession	getSipApplicationSession(SipApplicationSessionKey key, boolean create) Retrieve a sip application session from its key.
int	getSipApplicationSessionAverageAliveTime() Gets the average time (in seconds) that expired sessions had been alive.
int	getSipApplicationSessionCounter() Total sessions created by this manager.
int	getSipApplicationSessionMaxAliveTime() Gets the longest time (in seconds) that an expired session had been alive.
SipFactoryImpl	getSipFactoryImpl()
MobicentsSipSession	getSipSession(SipSessionKey key, boolean create, SipFactoryImpl sipFactoryImpl, MobicentsSipApplicationSession sipApplicationSessionImpl) Retrieve a sip session from its key.
int	getSipSessionAverageAliveTime() Gets the average time (in seconds) that expired sessions had been alive.
int	getSipSessionCounter() Total sessions created by this manager.
int	getSipSessionMaxAliveTime() Gets the longest time (in seconds) that an expired session had been alive.
void	removeAllSessions() Remove the sip sessions and sip application sessions
MobicentsSipApplicationSession	removeSipApplicationSession(MobicentsSipApplicationSessionKey key) Removes a sip application session from the manager by its key
MobicentsSipSession	removeSipSession(MobicentsSipSessionKey key) Removes a sip session from the manager by its key
protected void	scheduleExpirationTimer(MobicentsSipApplicationSession sipApplicationSession)
void	setContainer(SipContext container)
void	setExpiredSipApplicationSessions(int expiredSipApplicationSessions) Sets the number of sessions that have expired.
void	setExpiredSipSessions(int expiredSipSessions) Sets the number of sessions that have expired.
void	setMaxActiveSipApplicationSessions(int max) Set the maximum number of actives Sip Application Sessions allowed, or -1 for no limit.
void	setMaxActiveSipSessions(int max) Set the maximum number of actives Sip Sessions allowed, or -1 for no limit.
void	setRejectedSipApplicationSessions(int rejectedSipApplicationSessions)
void	setRejectedSipSessions(int rejectedSipSessions)
void	setSipApplicationSessionAverageAliveTime(int sipApplicationSessionAverageAliveTime) Sets the average time (in seconds) that expired sessions had been alive.
void	setSipApplicationSessionCounter(int sipApplicationSessionCounter)
void	setSipApplicationSessionMaxAliveTime(int sipApplicationSessionMaxAliveTime) Sets the longest time (in seconds) that an expired session had been alive.
void	setSipFactoryImpl(SipFactoryImpl sipFactoryImpl)
void	setSipSessionAverageAliveTime(int sipSessionAverageAliveTime) Sets the average time (in seconds) that expired sessions had been alive.
void	setSipSessionCounter(int sipSessionCounter)
void	setSipSessionMaxAliveTime(int sipSessionMaxAliveTime) Sets the longest time (in seconds) that an expired session had been alive.
protected MobicentsSipSession	setToTag(SipSessionKey key, MobicentsSipSession sipSession)
void	updateStats()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

sipApplicationSessions

protected ConcurrentHashMap<SipApplicationSessionKey,MobicentsSipApplicationSession> sipApplicationSessions

sipApplicationSessionsByAppGeneratedKey

protected ConcurrentHashMap<String,MobicentsSipApplicationSession> sipApplicationSessionsByAppGeneratedKey

sipSessions

protected ConcurrentHashMap<SipSessionKey,MobicentsSipSession> sipSessions

sipFactoryImpl

protected SipFactoryImpl sipFactoryImpl

container

protected SipContext container

maxActiveSipSessions

protected int maxActiveSipSessions

The maximum number of active Sip Sessions allowed, or -1 for no limit.

maxActiveSipApplicationSessions

protected int maxActiveSipApplicationSessions

The maximum number of active Sip Application Sessions allowed, or -1 for no limit.

rejectedSipSessions

protected int rejectedSipSessions

Number of sip session creations that failed due to maxActiveSipSessions.

rejectedSipApplicationSessions

protected int rejectedSipApplicationSessions

Number of sip application session creations that failed due to maxActiveSipApplicationSessions.

sipSessionCounter

protected int sipSessionCounter

sipApplicationSessionCounter

protected int sipApplicationSessionCounter

Constructor Detail

SipManagerDelegate

public SipManagerDelegate()

Method Detail

getSipFactoryImpl

public SipFactoryImpl getSipFactoryImpl()

Returns:

the SipFactoryImpl

setSipFactoryImpl

public void setSipFactoryImpl(SipFactoryImpl sipFactoryImpl)

Parameters:

sipFactoryImpl - the SipFactoryImpl to set

getContainer

public SipContext getContainer()

Returns:

the container

setContainer

public void setContainer(SipContext container)

Parameters:

container - the container to set

removeSipSession

public MobicentsSipSession removeSipSession(MobicentsSipSessionKey key)

Removes a sip session from the manager by its key

Parameters:

key - the identifier for this session

Returns:

the sip session that had just been removed, null otherwise

removeSipApplicationSession

public MobicentsSipApplicationSession removeSipApplicationSession(MobicentsSipApplicationSessionKey key)

Removes a sip application session from the manager by its key

Parameters:

key - the identifier for this session

Returns:

the sip application session that had just been removed, null otherwise

getSipApplicationSession

public MobicentsSipApplicationSession getSipApplicationSession(SipApplicationSessionKey key,
                                                      boolean create)

Retrieve a sip application session from its key. If none exists, one can enforce the creation through the create parameter to true.

Parameters:

key - the key identifying the sip application session to retrieve

create - if set to true, if no session has been found one will be created

Returns:

the sip application session matching the key

createSipApplicationSession

protected MobicentsSipApplicationSession createSipApplicationSession(SipApplicationSessionKey key)

scheduleExpirationTimer

protected void scheduleExpirationTimer(MobicentsSipApplicationSession sipApplicationSession)

getSipSession

public MobicentsSipSession getSipSession(SipSessionKey key,
                                boolean create,
                                SipFactoryImpl sipFactoryImpl,
                                MobicentsSipApplicationSession sipApplicationSessionImpl)

Retrieve a sip session from its key. If none exists, one can enforce the creation through the create parameter to true. the sip factory cannot be null if create is set to true.

Parameters:

key - the key identifying the sip session to retrieve

create - if set to true, if no session has been found one will be created

sipFactoryImpl - needed only for sip session creation.

sipApplicationSessionImpl - to associate the SipSession with if create is set to true, if false it won't be used

Returns:

the sip session matching the key

Throws:

IllegalArgumentException - if create is set to true and sip Factory is null

createSipSession

protected MobicentsSipSession createSipSession(SipSessionKey key,
                                   boolean create,
                                   SipFactoryImpl sipFactoryImpl,
                                   MobicentsSipApplicationSession sipApplicationSessionImpl)

setToTag

protected MobicentsSipSession setToTag(SipSessionKey key,
                           MobicentsSipSession sipSession)

changeSessionKey

public void changeSessionKey(SipSessionKey oldKey,
                    SipSessionKey newKey)

createDerivedSipSession

protected MobicentsSipSession createDerivedSipSession(MobicentsSipSession parentSipSession,
                                          SipSessionKey sessionKey)

clone the parent sip session given in parameter except its attributes (they will be shared) and add it to the internal map of derived sessions identifying it by its ToTag

Parameters:

parentSipSession - the parent sip session holding the newly created derived session

sessionKey - the key of the new derived session to create

Returns:

the newly created derived session

getAllSipSessions

public Iterator<MobicentsSipSession> getAllSipSessions()

Retrieve all sip sessions currently hold by the session manager

Returns:

an iterator on the sip sessions

getNumberOfSipApplicationSessions

public int getNumberOfSipApplicationSessions()

Retrieve all sip application sessions currently hold by the session manager

Returns:

an iterator on the sip sessions

getNumberOfSipSessions

public int getNumberOfSipSessions()

Retrieve all sip sessions currently hold by the session manager

Returns:

an iterator on the sip sessions

getAllSipApplicationSessions

public Iterator<MobicentsSipApplicationSession> getAllSipApplicationSessions()

Retrieve all sip application sessions currently hold by the session manager

Returns:

an iterator on the sip sessions

findSipApplicationSession

public MobicentsSipApplicationSession findSipApplicationSession(javax.servlet.http.HttpSession httpSession)

Retrieves the sip application session holding the converged http session in parameter

Parameters:

convergedHttpSession - the converged session to look up

Returns:

the sip application session holding a reference to it or null if none references it

dumpSipSessions

public void dumpSipSessions()

dumpSipApplicationSessions

public void dumpSipApplicationSessions()

removeAllSessions

public void removeAllSessions()

Remove the sip sessions and sip application sessions

getNewMobicentsSipSession

protected abstract MobicentsSipSession getNewMobicentsSipSession(SipSessionKey key,
                                            SipFactoryImpl sipFactoryImpl,
                                            MobicentsSipApplicationSession mobicentsSipApplicationSession)

getNewMobicentsSipApplicationSession

protected abstract MobicentsSipApplicationSession getNewMobicentsSipApplicationSession(SipApplicationSessionKey key,
                                                                  SipContext sipContext)

getMaxActiveSipSessions

public int getMaxActiveSipSessions()

Return the maximum number of active Sessions allowed, or -1 for no limit.

setMaxActiveSipSessions

public void setMaxActiveSipSessions(int max)

Set the maximum number of actives Sip Sessions allowed, or -1 for no limit.

Parameters:

max - The new maximum number of sip sessions

getMaxActiveSipApplicationSessions

public int getMaxActiveSipApplicationSessions()

Return the maximum number of active Sessions allowed, or -1 for no limit.

setMaxActiveSipApplicationSessions

public void setMaxActiveSipApplicationSessions(int max)

Set the maximum number of actives Sip Application Sessions allowed, or -1 for no limit.

Parameters:

max - The new maximum number of sip application sessions

getRejectedSipSessions

public int getRejectedSipSessions()

Number of sip session creations that failed due to maxActiveSipSessions

Returns:

The count

setRejectedSipSessions

public void setRejectedSipSessions(int rejectedSipSessions)

getRejectedSipApplicationSessions

public int getRejectedSipApplicationSessions()

Number of sip session creations that failed due to maxActiveSipSessions

Returns:

The count

setRejectedSipApplicationSessions

public void setRejectedSipApplicationSessions(int rejectedSipApplicationSessions)

setSipSessionCounter

public void setSipSessionCounter(int sipSessionCounter)

getSipSessionCounter

public int getSipSessionCounter()

Total sessions created by this manager.

Returns:

sessions created

getActiveSipSessions

public int getActiveSipSessions()

Returns the number of active sessions

Returns:

number of sessions active

getSipSessionMaxAliveTime

public int getSipSessionMaxAliveTime()

Gets the longest time (in seconds) that an expired session had been alive.

Returns:

Longest time (in seconds) that an expired session had been alive.

setSipSessionMaxAliveTime

public void setSipSessionMaxAliveTime(int sipSessionMaxAliveTime)

Sets the longest time (in seconds) that an expired session had been alive.

Parameters:

sessionMaxAliveTime - Longest time (in seconds) that an expired session had been alive.

getSipSessionAverageAliveTime

public int getSipSessionAverageAliveTime()

Gets the average time (in seconds) that expired sessions had been alive.

Returns:

Average time (in seconds) that expired sessions had been alive.

setSipSessionAverageAliveTime

public void setSipSessionAverageAliveTime(int sipSessionAverageAliveTime)

Sets the average time (in seconds) that expired sessions had been alive.

Parameters:

sessionAverageAliveTime - Average time (in seconds) that expired sessions had been alive.

setSipApplicationSessionCounter

public void setSipApplicationSessionCounter(int sipApplicationSessionCounter)

getSipApplicationSessionCounter

public int getSipApplicationSessionCounter()

Total sessions created by this manager.

Returns:

sessions created

getActiveSipApplicationSessions

public int getActiveSipApplicationSessions()

Returns the number of active sessions

Returns:

number of sessions active

getSipApplicationSessionMaxAliveTime

public int getSipApplicationSessionMaxAliveTime()

Gets the longest time (in seconds) that an expired session had been alive.

Returns:

Longest time (in seconds) that an expired session had been alive.

setSipApplicationSessionMaxAliveTime

public void setSipApplicationSessionMaxAliveTime(int sipApplicationSessionMaxAliveTime)

Sets the longest time (in seconds) that an expired session had been alive.

Parameters:

sessionMaxAliveTime - Longest time (in seconds) that an expired session had been alive.

getSipApplicationSessionAverageAliveTime

public int getSipApplicationSessionAverageAliveTime()

Gets the average time (in seconds) that expired sessions had been alive.

Returns:

Average time (in seconds) that expired sessions had been alive.

setSipApplicationSessionAverageAliveTime

public void setSipApplicationSessionAverageAliveTime(int sipApplicationSessionAverageAliveTime)

Sets the average time (in seconds) that expired sessions had been alive.

Parameters:

sessionAverageAliveTime - Average time (in seconds) that expired sessions had been alive.

getExpiredSipSessions

public int getExpiredSipSessions()

Gets the number of sessions that have expired.

Returns:

Number of sessions that have expired

setExpiredSipSessions

public void setExpiredSipSessions(int expiredSipSessions)

Sets the number of sessions that have expired.

Parameters:

expiredSessions - Number of sessions that have expired

getExpiredSipApplicationSessions

public int getExpiredSipApplicationSessions()

Gets the number of sessions that have expired.

Returns:

Number of sessions that have expired

setExpiredSipApplicationSessions

public void setExpiredSipApplicationSessions(int expiredSipApplicationSessions)

Sets the number of sessions that have expired.

Parameters:

expiredSessions - Number of sessions that have expired

getNumberOfSipApplicationSessionCreationPerSecond

public double getNumberOfSipApplicationSessionCreationPerSecond()

getNumberOfSipSessionCreationPerSecond

public double getNumberOfSipSessionCreationPerSecond()

updateStats

public void updateStats()