Servlet--HttpSession接口，HttpSessionContext接口，Cookie类

HttpSession接口

定义

public interface HttpSession


这个接口被 Servlet 引擎用来实现在 HTTP 客户端和 HTTP 会话两者的关联。这种关联可能在多外连接和请求中持续一段给定的时间。session 用来在无状态的 HTTP 协议下越过多个请求页面来维持状态和识别用户。一个 session 可以通过 cookie 或重写 URL 来维持。

方法

1、getCreationTime

public long getCreationTime();

返回建立 session 的时间，这个时间表示为自 1970-1-1 日（GMT）以来的毫秒数。

2、getId

public String getId();

返回分配给这个 session 的标识符。一个 HTTP session 的标识符是一个由服务器来建立和维持的唯一的字符串。

3、getLastAccessedTime

public long getLastAccessedTime();

返回客户端最后一次发出与这个 session 有关的请求的时间， 如果这个 session 是新建立的，返回-1。这个时间表示为自 1970-1-1 日（GMT）以来的毫秒数。

4、getMaxInactiveInterval

public int getMaxInactiveInterval();

返加一个秒数，这个秒数表示客户端在不发出请求时，session 被 Servlet 引擎维持的最长时间。在这个时间之后，Servlet 引擎可能被 Servlet 引擎终止。如果这个 session 不会被终

止，这个方法返回-1。当 session 无效后再调用这个方法会抛出一个 IllegalStateException。

5、getValue

public Object getValue(String name);

返回一个以给定的名字绑定到 session 上的对象。如果不存在这样的绑定，返回空值。当 session 无效后再调用这个方法会抛出一个 IllegalStateException。

6、getValueNames

public String[] getValueNames();

以一个数组返回绑定到 session 上的所有数据的名称。当 session 无效后再调用这个方法会抛出一个 IllegalStateException。

7、invalidate

public void invalidate();

这个方法会终止这个 session。所有绑定在这个 session 上的数据都会被清除。并通过HttpSessionBindingListener 接口的 valueUnbound 方法发出通告。

8、isNew

public boolean isNew();

返回一个布尔值以判断这个 session 是不是新的。 如果一个 session 已经被服务器建立但是还没有收到相应的客户端的请求，这个 session 将被 认为是新的。这意味着，这个客户端

还没有加入会话或没有被会话公认。在他发出下一个请求时还不能返回适当的 session 认证信息。当 session 无效后再调用这个方法会抛出一个 IllegalStateException。

9、putValue

public void putValue(String name, Object value);

以给定的名字，绑定给定的对象到 session 中。已存在的同名的绑定会被重置。这时会调用 HttpSessionBindingListener 接口的 valueBound 方法。当 session 无效后再调用这个方法会抛出一个 IllegalStateException。

10、removeValue

public void removeValue(String name);

取消给定名字的对象在 session 上的绑定。如果未找到给定名字的绑定的对象，这个方法什么出不做。 这时会调用 HttpSessionBindingListener 接口的 valueUnbound 方法。当 session 无效后再调用这个方法会抛出一个 IllegalStateException。

11、setMaxInactiveInterval

public int setMaxInactiveInterval(int interval);

设置一个秒数，这个秒数表示客户端在不发出请求时，session 被 Servlet 引擎维持的最长时间。以下这个方法将被取消\

12、getSessionContext

public HttpSessionContextgetSessionContext();


返回 session 在其中得以保持的环境变量。 这个方法和其他所有 HttpSessionContext 的方法一样被取消了。

HttpSessionContext接口

定义

此接口将被取消

public interface HttpSessionContext

这个对象是与一组 HTTP session 关联的单一的实体。

这个接口由于安全的原因被取消， 它出现在目前的版本中仅仅是为了兼容性的原因。 这个接口的方法将模拟以前的版本的定义返回相应的值。

方法

1、getSession

public HttpSession getSession(String sessionId);

当初用来返回与这个 session id 相关的 session。现在返回空值。

2、getIds

public Enumeration getIds();

当初用来返回这个环境下所有 session id 的列表。现在返回空的列表。

Cookie 类

定义

public class Cookie implements Cloneable

这个类描述了一个 cookie，有关 cookie 的定义你可以参照 Netscape Communications

Corporation 的说明，也可以参照 RFC 2109。

构造函数

public Cookie(String name, String value);

用一个 name-value 对定义一个 cookie。这个 name 必须能被 HTTP/1.1 所接受。以字符$开头的 name 被 RFC 2109 保留。给定的 name 如果不能被 HTTP/1.1 所接受，该方法抛出一个 IllegalArgumentException 。

方法

1、getComment

public String getComment();

返回描述这个 cookie 目的的说明，如果未定义这个说明，返回空值。

2、getDomain

public String getDomain();

返回这个 cookie 可以出现的区域，如果未定义区域，返回空值。

3、getMaxAge

public int getMaxAge();

这个方法返回这个 cookie 指定的最长存活时期。如果未定义这个最长存活时期，该方

法返回-1。

4、getName

public String getName();

该方法返回 cookie 名。

5、getPath

public String getPath();

返回这个 cookie 有效的所有 URL 路径的前缀，如果未定义，返回空值。

6、getSecure

public boolean getSecure();

如果这个 cookie 只通过安全通道传输返回真，否则返回假。

7、getValue

public String getValue();

该方法返回 cookie 的值。

8、getVersion

public int getVersion();

返回 cookie 的版本。版本 1 由 RFC 2109 解释。版本 0 由 Netscape CommunicationsCorporation 的说明解释。新构造的 cookie 默认使用版本 0。

9、setComment

public void setComment(String purpose);

如果一个用户将这个 cookie 提交给另一个用户，必须通过这个说明描述这个 cookie 的目的。版本 0 不支持这个属性。

10、setDomain

public void setDomain(String pattern);

这个方法设置 cookie 的有效域的属性。这个属性指定了 cookie 可以出现的区域。一个有效域以一个点开头（.foo.com） ，这意味着在指定的域 名解析系统的区域中（可能是www.foo.com 但不是 a.b.foo.com）的主机可以看到这个 cookie。默认情况是，cookie 只能返回保 存它的主机。

11、setMaxAge

public void setMaxAge(int expiry);

这个方法设定这个 cookie 的最长存活时期。在该存活时期之后，cookie 会被终目。负数表示这个 cookie 不会生效，0 将从客户端删除这个 cookie。

12、setPath

public void setPath(String uri);

这个方法设置 cookie 的路径属性。客户端只能向以这个给定的路径 String 开头的路径返回 cookie。

13、setSecure

public void setSecure(boolean flag);

指出这个 cookie 只能通过安全通道（例如 HTTPS）发送。只有当产生这个 cookie 的服务器使用安全协议发送这个 cookie 值时才能这样设置。

14、setValue

public void setValue(String newValue);

设置这个 cookie 的值，对于二进制数据采用 BASE64 编码。版本 0 不能使用空格、{}、()、= 、，、 “”、/、?、@ 、 ：以及； 。

15、setVersion

public void setVersion(int v);

设置 cookie 的版本号

HttpSessionBindingEvent类

定义

public class HttpSessionBindingEventextends EventObject

这 个 事 件 是 在 监 听 到 HttpSession 发 生 绑 定 和 取 消 绑 定 的 情 况 时 连 通HttpSessionBindingListener 的。这可能是一个 session 被终止或被认定无效的结果。事件源是 HttpSession.putValue 或 HttpSession.removeValue。

构造函数

public HttpSessionBindingEvent(HttpSession session, String name);

通过引起这个事件的 Session 和发生绑定或取消绑定的对象名构造一个新的HttpSessionBindingEvent。

方法

1、getName

public String getName();

返回发生绑定和取消绑定的对象的名字。

2、getSession

public HttpSession getSession();

返回发生绑定和取消绑定的 session 的名字。