org.eclipse.jetty.server.session

Class JDBCSessionIdManager

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.server.session.AbstractSessionIdManager

org.eclipse.jetty.server.session.JDBCSessionIdManager

All Implemented Interfaces:

SessionIdManager, LifeCycle

public class JDBCSessionIdManager
extends AbstractSessionIdManager

JDBCSessionIdManager SessionIdManager implementation that uses a database to store in-use session ids, to support distributed sessions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JDBCSessionIdManager.DatabaseAdaptor DatabaseAdaptor Handles differences between databases.
protected class	JDBCSessionIdManager.Scavenger Scavenger
static class	JDBCSessionIdManager.SessionIdTableSchema SessionIdTableSchema
static class	JDBCSessionIdManager.SessionTableSchema SessionTableSchema

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_connectionUrl
protected String	_createSessionIdTable
protected String	_createSessionTable
protected DataSource	_datasource
protected JDBCSessionIdManager.DatabaseAdaptor	_dbAdaptor
protected int	_deleteBlockSize
protected String	_deleteId
protected String	_deleteSession
protected Driver	_driver
protected String	_driverClassName
protected String	_insertId
protected String	_insertSession
protected String	_jndiName
protected long	_lastScavengeTime
protected boolean	_ownScheduler
protected String	_queryId
protected long	_scavengeIntervalMs
protected JDBCSessionIdManager.Scavenger	_scavenger
protected Scheduler	_scheduler
protected String	_selectBoundedExpiredSessions
protected Server	_server
protected HashSet<String>	_sessionIds
protected JDBCSessionIdManager.SessionIdTableSchema	_sessionIdTableSchema
protected JDBCSessionIdManager.SessionTableSchema	_sessionTableSchema
protected Scheduler.Task	_task
protected String	_updateSession
protected String	_updateSessionAccessTime
protected String	_updateSessionNode
static int	MAX_INTERVAL_NOT_SET

Fields inherited from class org.eclipse.jetty.server.session.AbstractSessionIdManager

_random, _reseed, _weakRandom, _workerAttr, _workerName

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOP_ON_FAILURE, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
JDBCSessionIdManager(Server server)
JDBCSessionIdManager(Server server, Random random)

Method Summary

Modifier and Type	Method and Description
void	addSession(HttpSession session) Add a session to the list of known sessions for a given ID.
void	addSession(String id)
void	doStart() Start up the id manager.
void	doStop() Stop the scavenger.
String	getBlobType() Deprecated. see DbAdaptor.getBlobType
protected Connection	getConnection() Get a connection from the driver or datasource.
String	getConnectionUrl()
DataSource	getDataSource()
String	getDatasourceName()
JDBCSessionIdManager.DatabaseAdaptor	getDbAdaptor()
int	getDeleteBlockSize()
String	getDriverClassName()
String	getLongType() Deprecated. see DbAdaptor.getLogType
long	getScavengeInterval()
JDBCSessionIdManager.SessionIdTableSchema	getSessionIdTableSchema()
JDBCSessionIdManager.SessionTableSchema	getSessionTableSchema()
boolean	idInUse(String id)
void	invalidateAll(String id) Invalidate the session matching the id on all contexts.
void	removeSession(HttpSession session) Remove session from the list of known sessions for a given ID.
void	removeSession(String id)
void	renewSessionId(String oldClusterId, String oldNodeId, HttpServletRequest request) Change the existing session id.
void	setBlobType(String name) Deprecated. see DbAdaptor.setBlobType
void	setDatasource(DataSource ds)
void	setDatasourceName(String jndi)
void	setDbAdaptor(JDBCSessionIdManager.DatabaseAdaptor dbAdaptor)
void	setDeleteBlockSize(int bsize)
void	setDriverInfo(Driver driverClass, String connectionUrl) Configure jdbc connection information via a jdbc Driver
void	setDriverInfo(String driverClassName, String connectionUrl) Configure jdbc connection information via a jdbc Driver
void	setLongType(String longType) Deprecated. see DbAdaptor.setLongType
void	setScavengeInterval(long sec)
void	setSessionIdTableSchema(JDBCSessionIdManager.SessionIdTableSchema sessionIdTableSchema)
void	setSessionTableSchema(JDBCSessionIdManager.SessionTableSchema sessionTableSchema)

Methods inherited from class org.eclipse.jetty.server.session.AbstractSessionIdManager

getClusterId, getNodeId, getRandom, getReseed, getWorkerName, initRandom, newSessionId, newSessionId, setRandom, setReseed, setWorkerName

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, setStopTimeout, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Field Detail

MAX_INTERVAL_NOT_SET

public static final int MAX_INTERVAL_NOT_SET

See Also:

Constant Field Values

_sessionIds

protected final HashSet<String> _sessionIds

_server

protected Server _server

_driver

protected Driver _driver

_driverClassName

protected String _driverClassName

_connectionUrl

protected String _connectionUrl

_datasource

protected DataSource _datasource

_jndiName

protected String _jndiName

_deleteBlockSize

protected int _deleteBlockSize

_task

protected Scheduler.Task _task

_scheduler

protected Scheduler _scheduler

_scavenger

protected JDBCSessionIdManager.Scavenger _scavenger

_ownScheduler

protected boolean _ownScheduler

_lastScavengeTime

protected long _lastScavengeTime

_scavengeIntervalMs

protected long _scavengeIntervalMs

_createSessionIdTable

protected String _createSessionIdTable

_createSessionTable

protected String _createSessionTable

_selectBoundedExpiredSessions

protected String _selectBoundedExpiredSessions

_insertId

protected String _insertId

_deleteId

protected String _deleteId

_queryId

protected String _queryId

_insertSession

protected String _insertSession

_deleteSession

protected String _deleteSession

_updateSession

protected String _updateSession

_updateSessionNode

protected String _updateSessionNode

_updateSessionAccessTime

protected String _updateSessionAccessTime

_dbAdaptor

protected JDBCSessionIdManager.DatabaseAdaptor _dbAdaptor

_sessionIdTableSchema

protected JDBCSessionIdManager.SessionIdTableSchema _sessionIdTableSchema

_sessionTableSchema

protected JDBCSessionIdManager.SessionTableSchema _sessionTableSchema

Constructor Detail

JDBCSessionIdManager

public JDBCSessionIdManager(Server server)

JDBCSessionIdManager

public JDBCSessionIdManager(Server server,
                            Random random)

Method Detail

setDriverInfo

public void setDriverInfo(String driverClassName,
                          String connectionUrl)

Configure jdbc connection information via a jdbc Driver

Parameters:

driverClassName - the driver classname

connectionUrl - the driver connection url

setDriverInfo

public void setDriverInfo(Driver driverClass,
                          String connectionUrl)

Configure jdbc connection information via a jdbc Driver

Parameters:

driverClass - the driver class

connectionUrl - the driver connection url

setDatasource

public void setDatasource(DataSource ds)

getDataSource

public DataSource getDataSource()

getDriverClassName

public String getDriverClassName()

getConnectionUrl

public String getConnectionUrl()

setDatasourceName

public void setDatasourceName(String jndi)

getDatasourceName

public String getDatasourceName()

setBlobType

@Deprecated
public void setBlobType(String name)

Deprecated. see DbAdaptor.setBlobType

Parameters:

name - the name of the blob

getDbAdaptor

public JDBCSessionIdManager.DatabaseAdaptor getDbAdaptor()

setDbAdaptor

public void setDbAdaptor(JDBCSessionIdManager.DatabaseAdaptor dbAdaptor)

getBlobType

@Deprecated
public String getBlobType()

Deprecated. see DbAdaptor.getBlobType

Returns:

the blob type

getLongType

@Deprecated
public String getLongType()

Deprecated. see DbAdaptor.getLogType

Returns:

the long type

setLongType

@Deprecated
public void setLongType(String longType)

Deprecated. see DbAdaptor.setLongType

Parameters:

longType - the long type

getSessionIdTableSchema

public JDBCSessionIdManager.SessionIdTableSchema getSessionIdTableSchema()

setSessionIdTableSchema

public void setSessionIdTableSchema(JDBCSessionIdManager.SessionIdTableSchema sessionIdTableSchema)

getSessionTableSchema

public JDBCSessionIdManager.SessionTableSchema getSessionTableSchema()

setSessionTableSchema

public void setSessionTableSchema(JDBCSessionIdManager.SessionTableSchema sessionTableSchema)

setDeleteBlockSize

public void setDeleteBlockSize(int bsize)

getDeleteBlockSize

public int getDeleteBlockSize()

setScavengeInterval

public void setScavengeInterval(long sec)

getScavengeInterval

public long getScavengeInterval()

addSession

public void addSession(HttpSession session)

Description copied from interface: SessionIdManager

Add a session to the list of known sessions for a given ID.

Parameters:

session - The session

addSession

public void addSession(String id)

removeSession

public void removeSession(HttpSession session)

Description copied from interface: SessionIdManager

Remove session from the list of known sessions for a given ID.

Parameters:

session - the session to remove

removeSession

public void removeSession(String id)

idInUse

public boolean idInUse(String id)

Parameters:

id - The session ID without any cluster node extension

Returns:

True if the session ID is in use by at least one context.

invalidateAll

public void invalidateAll(String id)

Invalidate the session matching the id on all contexts.

Parameters:

id - The session ID without any cluster node extension

See Also:

SessionIdManager.invalidateAll(java.lang.String)

renewSessionId

public void renewSessionId(String oldClusterId,
                           String oldNodeId,
                           HttpServletRequest request)

Description copied from interface: SessionIdManager

Change the existing session id.

Specified by:

renewSessionId in interface SessionIdManager

Specified by:

renewSessionId in class AbstractSessionIdManager

Parameters:

oldClusterId - the old cluster id

oldNodeId - the old node id

request - the request containing the session

doStart

public void doStart()
             throws Exception

Start up the id manager. Makes necessary database tables and starts a Session scavenger thread.

Overrides:

doStart in class AbstractSessionIdManager

Throws:

Exception

doStop

public void doStop()
            throws Exception

Stop the scavenger.

Overrides:

doStop in class AbstractSessionIdManager

Throws:

Exception

getConnection

protected Connection getConnection()
                            throws SQLException

Get a connection from the driver or datasource.

Returns:

the connection for the datasource

Throws:

SQLException - if unable to get the connection