SessionImpl (tiny-码云(gitee.com))

java.lang.Object
- org.tinygroup.weblayer.webcontext.session.impl.SessionImpl

All Implemented Interfaces:

Serializable, javax.servlet.http.HttpSession, Session
```
public class SessionImpl
extends Object
implements javax.servlet.http.HttpSession, Serializable, Session
```
实现了HttpSession接口。
注意，每个request均会创建独立的session对象，此对象本身不是线程安全的，不能被多线程同时访问。但其后备的session store是线程安全的。

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`SessionImpl(String sessionID, SessionWebContext webContext, boolean isNew, boolean create)` 创建一个session对象。

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`protected void`	`assertAttributeNameForModification(String methodName, String attrName)` 检查将要更改的attr name是否合法。
`protected void`	`assertModel(String methodName)` 确保model已经被取得，即session已被初始化。
`protected void`	`assertValid(String methodName)` 确保session处于valid状态。
`void`	`clear()` 清除一个session。
`void`	`commit(boolean commitHeaders)` 提交session的内容，删除的、新增的、修改的内容被保存。
`Object`	`getAttribute(String name)` 取得指定名称的attribute值。
`Enumeration<String>`	`getAttributeNames()` 取得所有attributes的名称。
`long`	`getCreationTime()` 取得session的创建时间。
`String`	`getId()` 取得session ID。
`long`	`getLastAccessedTime()` 取得最近访问时间。
`int`	`getMaxInactiveInterval()` 取得session的最大不活动期限，超过此时间，session就会失效。
`javax.servlet.ServletContext`	`getServletContext()` 取得当前session所属的servlet context。
`javax.servlet.http.HttpSessionContext`	`getSessionContext()` Deprecated. no replacement
`String`	`getSessionID()` 取得session ID。
`SessionModel`	`getSessionModel()` 取得当前的model。
`SessionWebContext`	`getSessionWebContext()` 取得创建该session的request context。
`Object`	`getValue(String name)` Deprecated. use getAttribute instead
`String[]`	`getValueNames()` Deprecated. use getAttributeNames instead
`void`	`invalidate()` 使一个session作废。
`boolean`	`isExpired()` 判断session有没有过期。
`boolean`	`isInvalidated()` 判断当前session是否非法。
`boolean`	`isNew()` 当前session是否为新的？
`void`	`putValue(String name, Object value)` Deprecated. use setAttribute instead
`void`	`removeAttribute(String name)` 删除一个attribute。
`void`	`removeValue(String name)` Deprecated. use removeAttribute instead
`void`	`setAttribute(String name, Object value)` 设置指定名称的attribute值。
`void`	`setMaxInactiveInterval(int maxInactiveInterval)` 设置session的最大不活动期限，超过此时间，session就会失效。
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - SessionImpl
```
public SessionImpl(String sessionID,
                   SessionWebContext webContext,
                   boolean isNew,
                   boolean create)
```
    创建一个session对象。
- Method Detail
  - getSessionWebContext
```
public SessionWebContext getSessionWebContext()
```
    取得创建该session的request context。
    
    Returns:
    
    request context
  - getSessionModel
```
public SessionModel getSessionModel()
```
    取得当前的model。
    
    Returns:
    
    model对象
  - getId
```
public String getId()
```
    取得session ID。
    
    Specified by:
    
    getId in interface javax.servlet.http.HttpSession
    
    Returns:
    
    session ID
  - getCreationTime
```
public long getCreationTime()
```
    取得session的创建时间。
    
    Specified by:
    
    getCreationTime in interface javax.servlet.http.HttpSession
    
    Specified by:
    
    getCreationTime in interface Session
    
    Returns:
    
    创建时间戮
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
  - getLastAccessedTime
```
public long getLastAccessedTime()
```
    取得最近访问时间。
    
    Specified by:
    
    getLastAccessedTime in interface javax.servlet.http.HttpSession
    
    Specified by:
    
    getLastAccessedTime in interface Session
    
    Returns:
    
    最近访问时间戮
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
  - getMaxInactiveInterval
```
public int getMaxInactiveInterval()
```
    取得session的最大不活动期限，超过此时间，session就会失效。
    
    Specified by:
    
    getMaxInactiveInterval in interface javax.servlet.http.HttpSession
    
    Specified by:
    
    getMaxInactiveInterval in interface Session
    
    Returns:
    
    不活动期限的秒数
  - setMaxInactiveInterval
```
public void setMaxInactiveInterval(int maxInactiveInterval)
```
    设置session的最大不活动期限，超过此时间，session就会失效。
    
    Specified by:
    
    setMaxInactiveInterval in interface javax.servlet.http.HttpSession
    
    Parameters:
    
    maxInactiveInterval - 不活动期限的秒数
  - getSessionID
```
public String getSessionID()
```
    Description copied from interface: Session
    
    取得session ID。
    
    Specified by:
    
    getSessionID in interface Session
    
    Returns:
    
    session ID
  - isExpired
```
public boolean isExpired()
```
    Description copied from interface: Session
    
    判断session有没有过期。
    
    Specified by:
    
    isExpired in interface Session
    
    Returns:
    
    如果过期了，则返回true
  - getServletContext
```
public javax.servlet.ServletContext getServletContext()
```
    取得当前session所属的servlet context。
    
    Specified by:
    
    getServletContext in interface javax.servlet.http.HttpSession
    
    Returns:
    
    ServletContext对象
  - getAttribute
```
public Object getAttribute(String name)
```
    取得指定名称的attribute值。
    
    Specified by:
    
    getAttribute in interface javax.servlet.http.HttpSession
    
    Parameters:
    
    name - attribute名称
    
    Returns:
    
    attribute的值
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
  - getAttributeNames
```
public Enumeration<String> getAttributeNames()
```
    取得所有attributes的名称。
    
    Specified by:
    
    getAttributeNames in interface javax.servlet.http.HttpSession
    
    Returns:
    
    attribute名称列表
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
  - setAttribute
```
public void setAttribute(String name,
                         Object value)
```
    设置指定名称的attribute值。
    
    Specified by:
    
    setAttribute in interface javax.servlet.http.HttpSession
    
    Parameters:
    
    name - attribute名称
    
    value - attribute的值
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
    
    IllegalArgumentException - 如果指定的attribute名称不被支持
  - removeAttribute
```
public void removeAttribute(String name)
```
    删除一个attribute。
    
    Specified by:
    
    removeAttribute in interface javax.servlet.http.HttpSession
    
    Parameters:
    
    name - 要删除的attribute名称
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
  - invalidate
```
public void invalidate()
```
    使一个session作废。
    
    Specified by:
    
    invalidate in interface javax.servlet.http.HttpSession
    
    Specified by:
    
    invalidate in interface Session
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
  - clear
```
public void clear()
```
    清除一个session。
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
  - isInvalidated
```
public boolean isInvalidated()
```
    判断当前session是否非法。
  - isNew
```
public boolean isNew()
```
    当前session是否为新的？
    
    Specified by:
    
    isNew in interface javax.servlet.http.HttpSession
    
    Returns:
    
    如果是新的，则返回true
    
    Throws:
    
    IllegalStateException - 如果session已经invalidated
  - assertModel
```
protected void assertModel(String methodName)
```
    确保model已经被取得，即session已被初始化。
    
    Parameters:
    
    methodName - 当前正要执行的方法
  - assertValid
```
protected void assertValid(String methodName)
```
    确保session处于valid状态。
    
    Parameters:
    
    methodName - 当前正要执行的方法
  - assertAttributeNameForModification
```
protected void assertAttributeNameForModification(String methodName,
                                                  String attrName)
```
    检查将要更改的attr name是否合法。
  - commit
```
public void commit(boolean commitHeaders)
```
    提交session的内容，删除的、新增的、修改的内容被保存。
  - getSessionContext
```
@Deprecated
public javax.servlet.http.HttpSessionContext getSessionContext()
```
    Deprecated. no replacement
    
    Specified by:
    
    getSessionContext in interface javax.servlet.http.HttpSession
  - getValue
```
@Deprecated
public Object getValue(String name)
```
    Deprecated. use getAttribute instead
    
    Specified by:
    
    getValue in interface javax.servlet.http.HttpSession
  - getValueNames
```
@Deprecated
public String[] getValueNames()
```
    Deprecated. use getAttributeNames instead
    
    Specified by:
    
    getValueNames in interface javax.servlet.http.HttpSession
  - putValue
```
@Deprecated
public void putValue(String name,
                                 Object value)
```
    Deprecated. use setAttribute instead
    
    Specified by:
    
    putValue in interface javax.servlet.http.HttpSession
  - removeValue
```
@Deprecated
public void removeValue(String name)
```
    Deprecated. use removeAttribute instead
    
    Specified by:
    
    removeValue in interface javax.servlet.http.HttpSession
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class SessionImpl

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

SessionImpl

Method Detail

getSessionWebContext

getSessionModel

getId

getCreationTime

getLastAccessedTime

getMaxInactiveInterval

setMaxInactiveInterval

getSessionID

isExpired

getServletContext

getAttribute

getAttributeNames

setAttribute

removeAttribute

invalidate

clear

isInvalidated

isNew

assertModel

assertValid

assertAttributeNameForModification

commit

getSessionContext

getValue

getValueNames

putValue

removeValue

toString