【Java基礎知識】Servlet學習之Servlet API - javax.servlet軟件包（三）

4、Cookie類

public class Cookie implements Cloneable

儲存在用戶本地客戶端上的數據，可以由用戶客戶端計算機暫時或永久保存的數據信息。

(1)構造函數

public Cookie(String name, String value)

用一個“key-value鍵值對”定義一個Cookie對象。

(2)Cookie相關方法

public void setComment(String purpose)

設置Cookie注釋，用來描述Cookie對象的作用。

public String getComment()

獲取Cookie對象的注釋，如果沒有設置注釋，則返回空值null。

public String getName()

獲取Cookie對象中存儲的key。

public void setValue(String newValue)

設置Cookie對象中的value值，以覆蓋舊值。

public String getValue()

獲取Cookie對象中存儲的value值。

public void setDomain(String pattern)

設置Cookie對象的有效域。這個屬性指定Cookie對象可以出現的區域。

例如：一個有效域以一個點開頭(.foo.com)，則意味著在指定的域名解析系統的區域中(可能是www.foo.com，而不是a.b.foo.com)的主機可以使用該Cookie對象。默認情況是，Cookie只能被保存它的客戶機使用。

public String getDomain()

獲取Cookie對象可以使用的區域，如果未定義，則返回空值null。

public void setMaxAge(int expiry)

設置Cookie對象在客戶機上保存的最長時間，單位：秒。在該生命期之后，Cookie對象會被銷毀。

參數expiry可以是正整數、負整數、0。

若expiry為0，則表示從客戶機上立即刪除這個Cookie對象;若expiry為正整數，則表示將Cookie對象保存在客戶機上的最長時間為指定的秒數;若expiry為負整數，則將Cookie對象保存在客戶端瀏覽器內存中，當瀏覽器關閉時，Cookie對象就會被刪除。

默認情況下，Cookie對象的Max-Age屬性值為-1。

public int getMaxAge()

獲取Cookie對象的最大生命周期。如果未設置，則返回-1。

public void setPath(String uri)

設置Cookie對象的訪問路徑，只有以給定String開頭的路徑，才能使用該Cookie對象。

public String getPath()

獲取允許使用Cookie對象的所有有效URL路徑，如果沒有設置，則返回空值null。

public void setSecure(boolean flag)

設置Cookie對象是否通過安全通道(例如：HTTPS、SSL)傳輸，默認為:false。

public boolean getSecure()

如果Cookie對象通過安全通道傳輸，則返回true，否則,返回false。

public void setVersion(int v)

設置 Cookie版本號。

public int getVersion()

獲取Cookie版本號。