org.eclipse.jetty.server.session
类 AbstractSession

java.lang.Object
  org.eclipse.jetty.server.session.AbstractSession

所有已实现的接口：

HttpSession, AbstractSessionManager.SessionIf

直接已知子类：

HashedSession, JDBCSessionManager.Session

public abstract class AbstractSession
extends Object
implements AbstractSessionManager.SessionIf

Implements HttpSession from the javax.servlet package.

构造方法摘要

protected	AbstractSession(AbstractSessionManager abstractSessionManager, HttpServletRequest request)
protected	AbstractSession(AbstractSessionManager abstractSessionManager, long created, long accessed, String clusterId)

方法摘要

protected boolean	access(long time)
protected void	addAttributes(Map<String,Object> map)
void	bindValue(String name, Object value) If value implements HttpSessionBindingListener, call valueBound()
protected void	checkValid() asserts that the session is valid
void	clearAttributes()
protected void	complete()
protected void	cookieSet()
void	didActivate()
protected Object	doGet(String name)
protected void	doInvalidate()
protected Object	doPutOrRemove(String name, Object value)
long	getAccessed()
Object	getAttribute(String name) Returns the object bound with the specified name in this session, or null if no object is bound under the name.
protected Map<String,Object>	getAttributeMap()
Enumeration<String>	getAttributeNames() Returns an Enumeration of String objects containing the names of all the objects bound to this session.
int	getAttributes()
String	getClusterId()
long	getCookieSetTime()
long	getCreationTime() Returns the time when this session was created, measured in milliseconds since midnight January 1, 1970 GMT.
String	getId() Returns a string containing the unique identifier assigned to this session.
long	getLastAccessedTime() Returns the last time the client sent a request associated with this session, as the number of milliseconds since midnight January 1, 1970 GMT, and marked by the time the container received the request.
int	getMaxInactiveInterval() Returns the maximum time interval, in seconds, that the servlet container will keep this session open between client accesses.
Set<String>	getNames()
String	getNodeId()
int	getRequests()
ServletContext	getServletContext() Returns the ServletContext to which this session belongs.
AbstractSession	getSession()
HttpSessionContext	getSessionContext() 已过时。
Object	getValue(String name) 已过时。 As of Version 2.2, this method is replaced by getAttribute(java.lang.String)
String[]	getValueNames() 已过时。 As of Version 2.2, this method is replaced by getAttributeNames()
void	invalidate() Invalidates this session then unbinds any objects bound to it.
boolean	isIdChanged()
boolean	isNew() Returns true if the client does not yet know about the session or if the client chooses not to join the session.
boolean	isValid()
void	putValue(String name, Object value) 已过时。 As of Version 2.2, this method is replaced by setAttribute(java.lang.String, java.lang.Object)
void	removeAttribute(String name) Removes the object bound with the specified name from this session.
void	removeValue(String name) 已过时。 As of Version 2.2, this method is replaced by removeAttribute(java.lang.String)
void	setAttribute(String name, Object value) Binds an object to this session, using the name specified.
void	setIdChanged(boolean changed)
void	setLastAccessedTime(long time)
void	setMaxInactiveInterval(int secs) Specifies the time, in seconds, between client requests before the servlet container will invalidate this session.
void	setRequests(int requests)
protected void	timeout()
String	toString()
void	unbindValue(String name, Object value) If value implements HttpSessionBindingListener, call valueUnbound()
void	willPassivate()

从类 java.lang.Object 继承的方法

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

构造方法详细信息

AbstractSession

protected AbstractSession(AbstractSessionManager abstractSessionManager,
                          HttpServletRequest request)

AbstractSession

protected AbstractSession(AbstractSessionManager abstractSessionManager,
                          long created,
                          long accessed,
                          String clusterId)

方法详细信息

checkValid

protected void checkValid()
                   throws IllegalStateException

asserts that the session is valid

抛出：

IllegalStateException

getSession

public AbstractSession getSession()

指定者：

接口 AbstractSessionManager.SessionIf 中的 getSession

getAccessed

public long getAccessed()

getAttribute

public Object getAttribute(String name)

从接口 HttpSession 复制的描述

Returns the object bound with the specified name in this session, or null if no object is bound under the name.

指定者：

接口 HttpSession 中的 getAttribute

参数：

name - a string specifying the name of the object

返回：

the object with the specified name

getAttributes

public int getAttributes()

getAttributeNames

public Enumeration<String> getAttributeNames()

从接口 HttpSession 复制的描述

Returns an Enumeration of String objects containing the names of all the objects bound to this session.

指定者：

接口 HttpSession 中的 getAttributeNames

返回：

an Enumeration of String objects specifying the names of all the objects bound to this session

getNames

public Set<String> getNames()

getCookieSetTime

public long getCookieSetTime()

getCreationTime

public long getCreationTime()
                     throws IllegalStateException

从接口 HttpSession 复制的描述

Returns the time when this session was created, measured in milliseconds since midnight January 1, 1970 GMT.

指定者：

接口 HttpSession 中的 getCreationTime

返回：

a long specifying when this session was created, expressed in milliseconds since 1/1/1970 GMT

抛出：

IllegalStateException - if this method is called on an invalidated session

getId

public String getId()
             throws IllegalStateException

从接口 HttpSession 复制的描述

Returns a string containing the unique identifier assigned to this session. The identifier is assigned by the servlet container and is implementation dependent.

指定者：

接口 HttpSession 中的 getId

返回：

a string specifying the identifier assigned to this session

抛出：

IllegalStateException

getNodeId

public String getNodeId()

getClusterId

public String getClusterId()

getLastAccessedTime

public long getLastAccessedTime()
                         throws IllegalStateException

从接口 HttpSession 复制的描述

Returns the last time the client sent a request associated with this session, as the number of milliseconds since midnight January 1, 1970 GMT, and marked by the time the container received the request.

Actions that your application takes, such as getting or setting a value associated with the session, do not affect the access time.

指定者：

接口 HttpSession 中的 getLastAccessedTime

返回：

a long representing the last time the client sent a request associated with this session, expressed in milliseconds since 1/1/1970 GMT

抛出：

IllegalStateException - if this method is called on an invalidated session

setLastAccessedTime

public void setLastAccessedTime(long time)

getMaxInactiveInterval

public int getMaxInactiveInterval()

从接口 HttpSession 复制的描述

Returns the maximum time interval, in seconds, that the servlet container will keep this session open between client accesses. After this interval, the servlet container will invalidate the session. The maximum time interval can be set with the setMaxInactiveInterval method.

A return value of zero or less indicates that the session will never timeout.

指定者：

接口 HttpSession 中的 getMaxInactiveInterval

返回：

an integer specifying the number of seconds this session remains open between client requests

另请参见：

HttpSession.setMaxInactiveInterval(int)

getServletContext

public ServletContext getServletContext()

从接口 HttpSession 复制的描述

Returns the ServletContext to which this session belongs.

指定者：

接口 HttpSession 中的 getServletContext

返回：

The ServletContext object for the web application

getSessionContext

@Deprecated
public HttpSessionContext getSessionContext()
                                     throws IllegalStateException

已过时。

指定者：

接口 HttpSession 中的 getSessionContext

抛出：

IllegalStateException

getValue

@Deprecated
public Object getValue(String name)
                throws IllegalStateException

已过时。 As of Version 2.2, this method is replaced by getAttribute(java.lang.String)

指定者：

接口 HttpSession 中的 getValue

参数：

name - a string specifying the name of the object

返回：

the object with the specified name

抛出：

IllegalStateException - if this method is called on an invalidated session

getValueNames

@Deprecated
public String[] getValueNames()
                       throws IllegalStateException

已过时。 As of Version 2.2, this method is replaced by getAttributeNames()

指定者：

接口 HttpSession 中的 getValueNames

返回：

an array of String objects specifying the names of all the objects bound to this session

抛出：

IllegalStateException - if this method is called on an invalidated session

getAttributeMap

protected Map<String,Object> getAttributeMap()

addAttributes

protected void addAttributes(Map<String,Object> map)

access

protected boolean access(long time)

complete

protected void complete()

timeout

protected void timeout()
                throws IllegalStateException

抛出：

IllegalStateException

invalidate

public void invalidate()
                throws IllegalStateException

从接口 HttpSession 复制的描述

Invalidates this session then unbinds any objects bound to it.

指定者：

接口 HttpSession 中的 invalidate

抛出：

IllegalStateException - if this method is called on an already invalidated session

doInvalidate

protected void doInvalidate()
                     throws IllegalStateException

抛出：

IllegalStateException

clearAttributes

public void clearAttributes()

isIdChanged

public boolean isIdChanged()

isNew

public boolean isNew()
              throws IllegalStateException

从接口 HttpSession 复制的描述

Returns true if the client does not yet know about the session or if the client chooses not to join the session. For example, if the server used only cookie-based sessions, and the client had disabled the use of cookies, then a session would be new on each request.

指定者：

接口 HttpSession 中的 isNew

返回：

true if the server has created a session, but the client has not yet joined

抛出：

IllegalStateException - if this method is called on an already invalidated session

putValue

@Deprecated
public void putValue(String name,
                                Object value)
              throws IllegalStateException

已过时。 As of Version 2.2, this method is replaced by setAttribute(java.lang.String, java.lang.Object)

指定者：

接口 HttpSession 中的 putValue

参数：

name - the name to which the object is bound; cannot be null

value - the object to be bound; cannot be null

抛出：

IllegalStateException - if this method is called on an invalidated session

removeAttribute

public void removeAttribute(String name)

从接口 HttpSession 复制的描述

Removes the object bound with the specified name from this session. If the session does not have an object bound with the specified name, this method does nothing.

After this method executes, and if the object implements HttpSessionBindingListener, the container calls HttpSessionBindingListener.valueUnbound. The container then notifies any HttpSessionAttributeListeners in the web application.

指定者：

接口 HttpSession 中的 removeAttribute

参数：

name - the name of the object to remove from this session

removeValue

@Deprecated
public void removeValue(String name)
                 throws IllegalStateException

已过时。 As of Version 2.2, this method is replaced by removeAttribute(java.lang.String)

指定者：

接口 HttpSession 中的 removeValue

参数：

name - the name of the object to remove from this session

抛出：

IllegalStateException - if this method is called on an invalidated session

doPutOrRemove

protected Object doPutOrRemove(String name,
                               Object value)

doGet

protected Object doGet(String name)

setAttribute

public void setAttribute(String name,
                         Object value)

从接口 HttpSession 复制的描述

Binds an object to this session, using the name specified. If an object of the same name is already bound to the session, the object is replaced.

After this method executes, and if the new object implements HttpSessionBindingListener, the container calls HttpSessionBindingListener.valueBound. The container then notifies any HttpSessionAttributeListeners in the web application.

If an object was already bound to this session of this name that implements HttpSessionBindingListener, its HttpSessionBindingListener.valueUnbound method is called.

If the value passed in is null, this has the same effect as calling removeAttribute().

指定者：

接口 HttpSession 中的 setAttribute

参数：

name - the name to which the object is bound; cannot be null

value - the object to be bound

setIdChanged

public void setIdChanged(boolean changed)

setMaxInactiveInterval

public void setMaxInactiveInterval(int secs)

从接口 HttpSession 复制的描述

Specifies the time, in seconds, between client requests before the servlet container will invalidate this session.

An interval value of zero or less indicates that the session should never timeout.

指定者：

接口 HttpSession 中的 setMaxInactiveInterval

参数：

secs - An integer specifying the number of seconds

toString

public String toString()

覆盖：

类 Object 中的 toString

bindValue

public void bindValue(String name,
                      Object value)

If value implements HttpSessionBindingListener, call valueBound()

isValid

public boolean isValid()

cookieSet

protected void cookieSet()

getRequests

public int getRequests()

setRequests

public void setRequests(int requests)

unbindValue

public void unbindValue(String name,
                        Object value)

If value implements HttpSessionBindingListener, call valueUnbound()

willPassivate

public void willPassivate()

didActivate

public void didActivate()