近期，对一个Eclipse下开发的Android应用进行重构，原先使用的网络框架是AsyncHttpClient。众所周知，HttpClient已经在Android 6.0中已经被官方remove了。官方推荐咱们使用的 HttpURLConnection。当然如果你执意或者不得已要用它，可以通过在build.gradle中加入下面的代码获取。
android {
useLibrary 'org.apache.http.legacy'
}
话题跑偏了。。。我是来说坑的。
回调方法不会自动到主线程中运行
就如上一篇OkHttp学习系列一：入门和简单使用所说的，OkHttp的设计是适合Java和Android程序的，但不是专门为Android应用设计。所以关于Android中的两个原则，它是不关心的。哪两个呢？
- 不能在主线程（UI主线程）发起网络；
- 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了一下，看到网上说的：
- OkHttp 3.0开始，默认不保存Cookie，要自己使用
CookieJar来保存Cookie。我用的就是3.0，命中。 - 使用Builder来构建OkHttpClient才能设置
CookieJar。我是直接new的，命中； - 使用下面的代码可以帮你自动管理Cookie。下面的代码摘自OkHttp3之Cookies管理及持久化
OkHttpClient client = new OkHttpClient.Builder()
.cookieJar(new CookieJar() {
private final HashMap> cookieStore = new HashMap<>();
@Override
public void saveFromResponse(HttpUrl url, List cookies) {
cookieStore.put(url.host(), cookies);
}
@Override
public List loadForRequest(HttpUrl url) {
List cookies = cookieStore.get(url.host());
return cookies != null ? cookies : new ArrayList();
}
})
.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> cookieStore = new HashMap<>();
//Tip：這裡key必須是String
@Override
public void saveFromResponse(HttpUrl url, List cookies) {
cookieStore.put(url.host(), cookies);
}
@Override
public List loadForRequest(HttpUrl url) {
List cookies = cookieStore.get(url.host());
return cookies != null ? cookies : new ArrayList();
}
}).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日：感谢@_醉生梦死 对本文的修正。