OkHttp学习系列二：谈谈Android中使用的坑

近期，对一个Eclipse下开发的Android应用进行重构，原先使用的网络框架是AsyncHttpClient。众所周知，HttpClient已经在Android 6.0中已经被官方remove了。官方推荐咱们使用的 HttpURLConnection。当然如果你执意或者不得已要用它，可以通过在build.gradle中加入下面的代码获取。

android {    
    useLibrary 'org.apache.http.legacy'
}

话题跑偏了。。。我是来说坑的。

回调方法不会自动到主线程中运行

就如上一篇OkHttp学习系列一：入门和简单使用所说的，OkHttp的设计是适合Java和Android程序的，但不是专门为Android应用设计。所以关于Android中的两个原则，它是不关心的。哪两个呢？

1. 不能在主线程（UI主线程）发起网络；
2. UI操作应该在UI线程中执行；

查看OkHttp3的源码发现：使用enqueue方法进行网络访问时，OkHttp会在线程池中调用异步任务进行网络访问和回调，所以原则1是满足的。但是下面的代码还是有问题，报了异常：CalledFromWrongThreadException。为什么？

OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder().url("http://lshare.me").build();
client.newCall(request).enqueue(new Callback() {
    @Override
    public void onResponse(Call call, Response response) throws IOException {
        Toast.makeText(TroubleDetailActivity.this,"Success",Toast.LENGTH_SHORT).show();
    }
    @Override
    public void onFailure(Call call, IOException e) {
    }
});

因为Toast涉及UI，必须在UI线程中执行，而OkHttp不会自动到主线程中执行回调方法的，违反原则2。so，下面才是正确姿势。

OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder().url("http://lshare.me").build();
client.newCall(request).enqueue(new Callback() {
    @Override
    public void onResponse(Call call, Response response) throws IOException {
        runOnUiThread(new Runnable() {//这是Activity的方法，会在主线程执行任务
            @Override
            public void run() {
                Toast.makeText(TroubleDetailActivity.this, "Success", Toast.LENGTH_SHORT).show();
            }
        });
    }
    @Override
    public void onFailure(Call call, IOException e) {
    }
});

没有帮我缓存并发送Cookie给服务器

使用上面的代码访问网络，会发现本来已经在登录页面登录成功了，然而在向服务器请求数据时，服务器告诉我：你这家伙还没登录啊。我醉了，明明登录成功了。仔细一想，会不会Cookie没有带过去，服务器可是只认Cookie不认人的，虽然我还是有那么点帅。用Fiddle抓包一看，吓死本宝宝了，果然没有发送过去。于是，赶紧Google了一下，看到网上说的：

1. OkHttp 3.0开始，默认不保存Cookie，要自己使用CookieJar来保存Cookie。我用的就是3.0，命中。
2. 使用Builder来构建OkHttpClient才能设置CookieJar。我是直接new的，命中；
3. 使用下面的代码可以帮你自动管理Cookie。下面的代码摘自OkHttp3之Cookies管理及持久化

OkHttpClient client = new OkHttpClient.Builder()
    .cookieJar(new CookieJar() {
        private final HashMap<HttpUrl, List<Cookie>> cookieStore = new HashMap<>();
        @Override
        public void saveFromResponse(HttpUrl url, List<Cookie> cookies) {
            cookieStore.put(url.host(), cookies);
        }
        @Override
        public List<Cookie> loadForRequest(HttpUrl url) {
            List<Cookie> cookies = cookieStore.get(url.host());
            return cookies != null ? cookies : new ArrayList<Cookie>();
        }
    })
    .build();

第3个说法就有问题了，首先这个cookieStore的key究竟是HttpUrl呢，还是String。因为代码中，创建时使用HttpUrl，而get和put时却是传入url.host()`，而这是个String，不科学！博主走心了。

尝试下，使用HttpUrl作为key，修改put和get，传入url，用fiddler抓包，发现问题依旧。又用了String作为key，修改cookieStore的定义，改key为String，用fiddler再次试了下。好激动，居然成啦！

//记录下正确姿势
OkHttpClient mHttpClient = new OkHttpClient.Builder().cookieJar(new CookieJar() {
    private final HashMap<String, List<Cookie>> cookieStore = new HashMap<>();
    //Tip：這裡key必須是String
    @Override
    public void saveFromResponse(HttpUrl url, List<Cookie> cookies) {
        cookieStore.put(url.host(), cookies);
    }
    @Override
    public List<Cookie> loadForRequest(HttpUrl url) {
        List<Cookie> cookies = cookieStore.get(url.host());
        return cookies != null ? cookies : new ArrayList<Cookie>();
    }
}).build();

为什么？

为什么不能用HttpUrl？看起来代码似乎没有什么不妥啊

看下HttpUrl的源代码，官方给我这个案例。说明了一个HttpUrl由scheme、host、pathSegment、queryParameter四部分组成。

HttpUrl url = new HttpUrl.Builder()
      .scheme("https")
      .host("www.google.com")
       .addPathSegment("search")
      .addQueryParameter("q", "polar bears")
      .build();

这不很明显吗？我们在登录页面发送的url和获取主页面数据时请求的url是不同的。我们使用前一次的url保存cookie在hashMap中，在请求主页面数据时OkHttp用新的url从hashMap取不到cookie，所以服务器不认你了，以为你没有登录。而url.host()是每次都一样的，这是重点！

更新日志：

• 3月26日：感谢@_醉生梦死 对本文的修正。