WebViewCookie

引言：網(wǎng)頁(yè)需要設(shè)置登錄狀態(tài)等情形何陆。開發(fā)使用過(guò)程中自我經(jīng)驗(yàn)簡(jiǎn)單記錄晨汹。

時(shí)間：2017年03月13日20:53:12

作者：JustDo23

01. 設(shè)置方式

同步的問(wèn)題很常見(jiàn)，網(wǎng)上搜到的解決方法基本類似甲献。

  /**
   * 給WebView同步Cookie
   *
   * @param context 上下文
   * @param url     可以使用[domain][host]
   */
  private void syncCookie(Context context, String url) {
    CookieSyncManager.createInstance(context);
    CookieManager cookieManager = CookieManager.getInstance();
    cookieManager.setAcceptCookie(true);
    cookieManager.removeSessionCookie();// 移除舊的[可以省略]
    List<HttpCookie> cookies = new PersistentCookieStore(context).getCookies();// 獲取Cookie[可以是其他的方式獲取]
    for (int i = 0; i < cookies.size(); i++) {
      HttpCookie cookie = cookies.get(i);
      String value = cookie.getName() + "=" + cookie.getValue();
      cookieManager.setCookie(url, value);
    }
    CookieSyncManager.getInstance().sync();// To get instant sync instead of waiting for the timer to trigger, the host can call this.
  }

這里簡(jiǎn)單說(shuō)明：

• 參數(shù)中的 URL 在使用過(guò)程中基本是域名宰缤。例如 https://www.baidu.com/ 就可以使 www.baidu.com
• Cookie 列表的獲取根據(jù)自己項(xiàng)目的存儲(chǔ)方式不同而不同。例如使用 SharedPreferences 和 HashMap
• 注意使用 for 循環(huán) 進(jìn)行 setCookie(String url, String value) 調(diào)用晃洒。網(wǎng)上有博客表示使用分號(hào)手動(dòng)拼接的 value 值會(huì)導(dǎo)致 Cookie 不能完整設(shè)置或者無(wú)效
• 注意 value 的值是使用 key=value 的完整形式。文檔提示 the cookie as a string, using the format of the 'Set-Cookie' HTTP response header
• CookieSyncManager 是個(gè)過(guò)時(shí)的類朦乏，Api21 中 WebView 可以自動(dòng)同步球及。
• CookieSyncManager.getInstance().sync(); 方法的替代方法是 cookieManager.flush();
• Cookie 同步方法要在 WebView 的 setting 設(shè)置完之后調(diào)用，否則無(wú)效呻疹。
• 調(diào)用 loadUrl(url); 前一句調(diào)用此方法進(jìn)行 Cookie 同步操作吃引。

/**
 * 獲取URL的域名
 */
private String getDomain(String url){
  url = url.replace("http://", "").replace("https://", "");
  if (url.contains("/")) {
    url = url.substring(0, url.indexOf('/'));
  }
  return url;
}

02. 保存Cookie

在這里記錄一下使用 SharedPreferences 保存整個(gè) Cookie 串并使用 HashMap 存儲(chǔ)鍵值對(duì)

/**
 * 獲取本地存儲(chǔ)的 Cookie 集合
 *
 * @return Cookie 鍵值對(duì)
 */
public Map<String, String> getCookieMap() {
    Map<String, String> cookieMap = new HashMap<>();
    String cookie = getCookie();// 從SharedPreferences中獲取整個(gè)Cookie串
    if (!TextUtils.isEmpty(cookie)) {
        String[] cookieArray = cookie.split(";");// 多個(gè)Cookie是使用分號(hào)分隔的
        for (int i = 0; i < cookieArray.length; i++) {
            int position = cookieArray[i].indexOf("=");// 在Cookie中鍵值使用等號(hào)分隔
            String cookieName = cookieArray[i].substring(0, position);// 獲取鍵
            String cookieValue = cookieArray[i].substring(position + 1);// 獲取值
            cookieMap.put(cookieName, NetCodeUtil.encodeURL(cookieValue));// 存至Map
            // 解碼使用 URLEncoder.encode(str, "UTF-8");
        }
    }
    return cookieMap;
}

注意：編解碼，從請(qǐng)求頭中獲取到的 Cookie 是經(jīng)過(guò) URL 編碼 的刽锤，解碼后可以獲取到姓名之類中文镊尺，在給 WebView 或者是其他請(qǐng)求設(shè)置 Cookie 的時(shí)候需要進(jìn)行編碼。

CookieUtil cookieUtil = new CookieUtil(this);// 將 Cookie 保存在了 SharedPreferences
Map<String, String> cookieMap = cookieUtil.getCookieMap();// 獲取鍵值對(duì)
for (Map.Entry<String, String> entry : cookieMap.entrySet()) {// 遍歷 Map
    String value = entry.getKey() + "=" + entry.getValue();// 鍵值對(duì)拼接成 value
    cookieManager.setCookie(url, value);// 設(shè)置 Cookie
}

03. 域名不同

使用 WebView 加載 A接口 獲取到展示的界面并思，界面需要填充的數(shù)據(jù)會(huì)自動(dòng)請(qǐng)求 B接口庐氮。這兩接口域名不相同，之前服務(wù)器升級(jí)的時(shí)候搞了一個(gè)新的域名宋彼。抓包發(fā)現(xiàn) AB兩個(gè)接口 域名不同 A為舊 B為新弄砍。

• 嘗試對(duì)兩個(gè)域名設(shè)置 Cookie 測(cè)試發(fā)現(xiàn)不沒(méi)有效果
• 嘗試將兩個(gè)接口的域名設(shè)置為相同的測(cè)試發(fā)現(xiàn)兩個(gè)接口都攜帶了 Cookie

進(jìn)行了一番搜索之后，發(fā)現(xiàn)有在強(qiáng)調(diào)输涕，只有cookie的domain和path與請(qǐng)求的URL匹配才會(huì)發(fā)送這個(gè)cookie音婶。

/**
 * Sets a cookie for the given URL. Any existing cookie with the same host,
 * path and name will be replaced with the new cookie. The cookie being set
 * will be ignored if it is expired.
 *
 * @param url the URL for which the cookie is to be set
 * @param value the cookie as a string, using the format of the 'Set-Cookie'
 *              HTTP response header
 */
public abstract void setCookie(String url, String value);

注釋中寫到，具有相同的 host 和 path 和 name 的任何現(xiàn)有的 Cookie 將會(huì)被替換為新的 Cookie莱坎。

04. Cookie保存位置

項(xiàng)目中使用 WebView 其實(shí)會(huì)自動(dòng)將 Cookie 保存在本地?cái)?shù)據(jù)庫(kù)中衣式。保存是路徑為 data/data/package_name/app_WebView/Cookies 雖然不是 .db 結(jié)尾的，實(shí)際就是一個(gè) .db 文件

參考文檔

1. 安卓學(xué)習(xí)筆記---AndroidWebview里設(shè)置Cookie遇到的坑

升級(jí)

引言：實(shí)際使用中遇到問(wèn)題并進(jìn)行更新。

時(shí)間：2018年04月19日21:03:12

作者：JustDo23

01. 針對(duì)一級(jí)域名

• 不用對(duì)每個(gè)具體的 Url 進(jìn)行設(shè)置 Cookie
• 針對(duì)項(xiàng)目使用的一級(jí)域名進(jìn)行設(shè)置 Cookie
• 選擇合適的時(shí)機(jī)進(jìn)行刷新

public void synCookies(Context context) {
  if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
    CookieSyncManager.createInstance(context);
  }
  CookieManager cookieManager = CookieManager.getInstance();
  cookieManager.setAcceptCookie(true);// 允許接受 Cookie
  if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
    cookieManager.removeSessionCookie();// 移除
  } else {
    cookieManager.removeSessionCookies(null);// 移除
  }
  List<HttpCookie> cookies = UserModle.getInstance(this).getCookies();
  for (int i = 0; i < cookies.size(); i++) {
    HttpCookie cookie = cookies.get(i);
    String value = cookie.getName() + "=" + cookie.getValue();
    cookieManager.setCookie(".baidu.com", value);
  }
  cookieManager.setCookie(".baidu.com", "Domain=.baidu.com");
  cookieManager.setCookie(".baidu.com", "Path=/");
  if (Build.VERSION.SDK_INT < Build.VERSION_CODES.LOLLIPOP) {
    CookieSyncManager.getInstance().sync();
  } else {
    cookieManager.flush();
  }
}

02. UserAgent

• 每次設(shè)置 UserAgent 會(huì)導(dǎo)致 WebView 重新加載
• 根據(jù)需要進(jìn)行設(shè)置
• 注意各個(gè)添加分號(hào)

String original = webView.getSettings().getUserAgentString();// 獲取 WebView 的 UserAgent
original += " Version:" + versionName + ";";// 替換
webView.getSettings().setUserAgentString(original);// 設(shè)置新的 UserAgent

03. 參考

1. 選擇性參考