LiteHttp 第八节：处理异常和取消请求

官网： http://litesuits.com

QQ群： 大群 47357508，二群 42960650

本系列文章面向android开发者，展示开源网络通信框架LiteHttp的主要用法，并讲解其关键功能的运作原理，同时传达了一些框架作者在日常开发中的一些最佳实践和经验。

本系列文章目录总览： http://blog.csdn.net/ko33600/article/details/49367409

1. 处理异常

异步请求处理异常只需要在HttpListener的onFailure中着手即可，使用异常处理器：

liteHttp.executeAsync(
new StringRequest("httpa://invalid-url").setHttpListener(
new HttpListener<String>() {
@Override
public void onFailure(HttpException exception, Response<String> response) {

new HttpExceptionHandler() {
@Override
protected void onClientException(HttpClientException e, ClientException type) {
}

@Override
protected void onNetException(HttpNetException e, NetException type) {
}

@Override
protected void onServerException(HttpServerException e, ServerException type, HttpStatus status) {
}
}.handleException(exception);

}
}));

2. 异常处理的最佳实践方式

下面介绍如何通过继承或者组合的方式来拓展、增强lite-http。

2.1 自定义异常处理器

推荐通过继承的手法来拓展，自建一个更强大的HttpExceptHandler来统一处理各类异常：

// Best Practices of Exception Handling

public class MyHttpExceptHandler extends HttpExceptionHandler {
private Activity activity;

public MyHttpExceptHandler(Activity activity) {
this.activity = activity;
}

@Override
protected void onClientException(HttpClientException e, ClientException type) {
switch (e.getExceptionType()) {
case UrlIsNull:
break;
case ContextNeeded:
// some action need app context
break;
case PermissionDenied:
break;
case SomeOtherException:
break;
}
HttpUtil.showTips(activity, "LiteHttp2.0", "Client Exception:\n" + e.toString());
activity = null;
}

@Override
protected void onNetException(HttpNetException e, NetException type) {
switch (e.getExceptionType()) {
case NetworkNotAvilable:
break;
case NetworkUnstable:
// maybe retried but fail
break;
case NetworkDisabled:
break;
default:
break;
}
HttpUtil.showTips(activity, "LiteHttp2.0", "Network Exception:\n" + e.toString());
activity = null;
}

@Override
protected void onServerException(HttpServerException e, ServerException type,
HttpStatus status) {
switch (e.getExceptionType()) {
case ServerInnerError:
// status code 5XX error
break;
case ServerRejectClient:
// status code 4XX error
break;
case RedirectTooMuch:
break;
default:
break;
}
HttpUtil.showTips(activity, "LiteHttp2.0", "Server Exception:\n" + e.toString());
activity = null;
}
}

可以看到，增强版的 异常处理器 细分了各种异常，并且弹窗提示用户，开发者可根据产品调整细节。

2.2 自定义监听器

如果很多场景下都需要这个异常处理器来处理，那么推荐通过继承的手法来拓展HttpListener：

class MyHttpListener<T> extends HttpListener<T> {
private Activity activity;

public MyHttpListener(Activity activity) {
this.activity = activity;
}

// disable listener when activity is null or be finished.
@Override
public boolean disableListener() {
return activity == null || activity.isFinishing();
}

// handle by this by call super.onFailure()
@Override
public void onFailure(HttpException e, Response response) {
// handle exception
new MyHttpExceptHandler(activity).handleException(e);
}
}

liteHttp.executeAsync(new StringRequest("httpa://invalid-url")
.setHttpListener(new MyHttpListener<String>(activity){
@Override
public void onFailure(HttpException e, Response response) {
super.onFailure(e, response);
// 通过调用父类的处理方法，来调用 MyHttpExceptHandler 来处理异常。
}
}));

经过拓展的 监听器 有两点机智的地方：

默认使用自定义的 异常处理器 统一处理异常

通过复写 disableListener 方法，使得在 Activity 为 null 或者 finish的情况下 监听器 的回调不再触发

不仅仅统一处理，而且可以避免页面已销毁而请求终于也成功导致各种异常的尴尬。这相当于和 Activity 的生命周期绑定了，实际开发中很实用。

3. 正确地取消请求

lite-http框架设计之初就考虑到了请求可能随时被取消，因此及时地获取和判断请求是否取消，以及获取线程的状态。当请求被取消，或者线程被中断，那么lite-http将在最短时间内结束本次请求。

取消请求的第一种方式：

StringRequest stringRequest = new StringRequest(url);

liteHttp.executeAsync(stringRequest);
SystemClock.sleep(100);

// one correct way is cancel this request
stringRequest.cancel();

取消请求的第二种方式，中断线程：

StringRequest stringRequest = new StringRequest(url);

FutureTask futureTask = liteHttp.performAsync(stringRequest);
SystemClock.sleep(100);

// other correct way is interrupt this thread or task.
futureTask.cancel(true);

如果是同步的请求，直接调用 Thread 的 interrupt() 即可。