哈囉大家好，這裡是覺得pom.xml越來越肥的小編過路君子

為了使用某一些功能，而導入一個 jar 包，結果為了使用另一功能，又再次導入其他的 jar 包......

有時候我們會需要主動地給予進入網站的每個人一個 Cookie 值，而這件事情既可以使用 javascript 做，當然也可以由我們後端來進行。

換句話說，除了使用 document.cookie 以外，還有另一個使用檔頭的 Set-Cookie 來設置的方式。

而我們今天的主題就是如何操作 Wicket 來設置 cookie。

首先，我們先在 pom.xml 底下添加以下訊息：

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

然後我們就可以給予或是取得客戶端的 cookie 了。

給予客戶端新的 cookie 值

那一般由伺服器端給予的 cookie 都會寫在檔頭的 Set-Cookie 裡，而客戶端一旦接收到就會自行地將其記錄下來。

所以現在問題就變成了如何讓 Wicket 在檔頭裡面夾帶我們所想要讓客戶端設定的 cookie。

import javax.servlet.http.Cookie;
import org.apache.wicket.request.http.WebResponse;
import org.apache.wicket.request.cycle.RequestCycle;

public class index extends WebPage
{
    public index()
    {
        String cookieValue = "abc123";

        /* 創建新的 cookie */
        Cookie cookie = new Cookie("cookieName", cookieValue);

        WebResponse webResponse = (WebResponse)RequestCycle.get().getResponse();    //取得當前回應檔頭
        webResponse.addCookie(cookie);    //將剛剛我們創建新的 cookie 添加進回應檔頭內
    }
}

那各位現在就可以回去瀏覽器，然後重新載入，觀察回應檔頭是否有出現我們所設定的 cookie。

這時，也可以直接使用 javascript 調用。

讀取客戶端現有的 cookie 值

當客戶端取得 cookie 的時候，之後都會將值帶給伺服器，所以這時伺服器也可以去讀取客戶端的 cookie 了。

import javax.servlet.http.Cookie;
import org.apache.wicket.request.http.WebRequest;
import org.apache.wicket.request.cycle.RequestCycle;

public class index extends WebPage
{
    public index()
    {
        /* 取得收到的請求籤頭資訊 */
        WebRequest request = (WebRequest) RequestCycle.get().getRequest();

        /* 取得名為 cookieName 的 cookie 值 */
        Cookie cookie = request.getCookie("cookieName");
        String cookieValue = cookie.getValue()
    }
}

我們就以取得剛剛設定的 cookieName 為例，現在 "abc123" 就已經被儲存在 cookieValue 這個變數裡面囉。

結合Session使用

通常我們不會將所有的資訊全部傳送給客戶端，只會使用 Cookie 紀錄該用戶的 Session ID，之後用戶便可以透過該 Session ID 來持續向伺服器獲取個人訊息。

換句話說，我們今天要製作一個自動登入功能的時候，就會給客戶端一個特殊的 ID，每次客戶端只要拿這個 ID 就可以直接入場，那沒有怎麼辦？給客戶端一個呀，對不對。

import javax.servlet.http.Cookie;
import org.apache.wicket.request.http.WebRequest;
import org.apache.wicket.request.http.WebResponse;
import org.apache.commons.lang3.RandomStringUtils;
import org.apache.wicket.request.cycle.RequestCycle;

public class index extends WebPage
{
    public index()
    {
        Cookie cookie;
        try
        {
            /* 嘗試讀取客戶端是否擁有 Session ID */
            WebRequest request = (WebRequest) RequestCycle.get().getRequest();
            cookie = request.getCookie("ID");
        }
        catch(Exception error)
        {
            /* 產生 57 碼長的隨機 ID */
            String ID = RandomStringUtils.randomAlphanumeric(57);

            /* 將新產生的 ID 交給客戶端 */
            cookie = new Cookie("ID", ID);
            WebResponse webResponse = (WebResponse)RequestCycle.get().getResponse();
            webResponse.addCookie(cookie);
        }
    }
}

這樣就是一個簡單讀取客戶端是否具有一組特殊 ID 的方式，那其中例如 Session 的添加以及 Session ID 的驗證，也可以順手完成。

那隨機產生 ID 小編是使用第三方的 jar 包來達成，各位可以依照喜好或習慣選擇產生方式，相關的 dependency 資訊如下：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.12.0</version>
</dependency>

修改客戶端現有的 Cookie 值

除了更新 Cookie 值以外，還可以設定其他屬性，例如逾時（ maximum age ）等......

詳細資訊可以參考：javax.servlet.http.Cookie。

import javax.servlet.http.Cookie;
import org.apache.wicket.request.http.WebRequest;
import org.apache.wicket.request.http.WebResponse;
import org.apache.wicket.request.cycle.RequestCycle;

public class index extends WebPage
{
    public index()
    {
        /* 取得籤頭中的 Cookie */
        WebRequest request = (WebRequest) RequestCycle.get().getRequest();
        Cookie cookie = request.getCookie("ID");

        /* 更新名為 ID 的 cookie 值 */
        cookie.setValue("another");

        /* 將更新後的 Cookie 值告訴客戶端並請求更新 */
        WebResponse webResponse = (WebResponse)RequestCycle.get().getResponse();
        webResponse.addCookie(cookie);
    }
}

一定要做回送的動作，要不客戶端永遠都不知道我們已經更新了 cookie 值。

後記

後來小編解決過多的 jar 檔的方式就是 —— 沒辦法解決。

所以寫了一個文件檔來解釋所用的所有 jar 檔，還附上了相關 API 的網址，這樣至少以後忘記的時候可以查看一下。

END