灵活而智能的HTTP框架 LiteHttp

来源：互联网发布：网络下单系统编辑：程序博客网时间：2024/05/18 16:54

简介

LiteHttp是一款简单、智能、灵活的HTTP框架库，它在请求和响应层面做到了全自动构建和解析，主要用于Android快速开发。借助LiteHttp你只需要一行代码即可完美实现http连接，它全面支持GET, POST, PUT, DELETE, HEAD, TRACE, OPTIONS 和 PATCH八种基本类型。LiteHttp能将Java Model转化为http请求参数，也能将响应的json语句智能转化为Java Model，这种全自动解析策略将节省你大量的构建请求、解析响应的时间。并且，你能自己继承重新实现Dataparser这个抽象类并设置给Request，来将http原始的inputstream转化为任何你想要的东西。

引言

http://litesuits.github.io/guide/http/get-start.html

LiteHttp引言，一个案例告诉你它的强大之处。

功能及特点

单线程，所有方法都基于一个线程，绝不会跨线程，多线程的事情交给它自带的AsyncExecutor 或者更专业的框架库来解决。
灵活的架构，你可以轻松的替换Json自动化库、参数构建方式甚至默认的apache http client连接方式。
轻量级，微小的的开销，core jar包仅约86kb。
多种请求类型全面支持：get, post, head, put, delete, trace, options, patch.
多文件上传，不需要额外的类库支持。
内置的Dataparser支持文件和位图下载，你也可以自由的扩展DataParser来把原始的http inputstream转化为你想要的东西。
基于json的全自动对象转化：框架帮你完成Java Object Model 和 Http Parameter之间的转化，完成Http Response与Java Object Model的转化。
自动重定向，基于一定的次数，不会造成死循环。
自动gizp压缩，帮你完成request编码和response解码以使http连接更加快速.
通过网络探测完成智能重试，对复杂的、信号不良的的移动网络做特殊的优化。
禁用一种或多种网络, 比如2G，3G。
简明且统一的异常处理体系：清晰、准确的抛出客户端、网络、服务器三种异常。
内置的AsyncExecutor可以让你轻松实现异步和并发的http请求，如果你喜欢，随意使用你自己的AsyncTask或Thread来完成异步，推荐使用更强大、高效的专业并发库。

架构图

一个良好的项目结构：

App Architecture

底层是业务无关的框架库，用之四海而皆准。
中层是针对业务的三方库，以及主要逻辑实现，全部业务都在这里。
上层是Activity、Fragment、Views&Widget等视图渲染和业务调用。
这样一个结构，使得你的代码快速在phone和pad以及tv之间迁移，且让你整个更为清晰。那么LiteHttp就位于这个结构的底层。

LiteHttp结构模型：

LiteHttp Architecture

基本用法

基础请求

?
1
2
3
LiteHttpClient client = LiteHttpClient.getInstance(context);
Response res = client.execute(newRequest("http://baidu.com"));
String html = res.getString();

异步请求

?
1
2
3
4
5
6
7
8
9
10
11
12
HttpAsyncExcutor asyncExcutor = newHttpAsyncExcutor();
asyncExcutor.execute(client, newRequest(url), newHttpResponseHandler() {
    @Override
    protectedvoid onSuccess(Response res, HttpStatus status, NameValuePair[] headers) {
        // do some thing on UI thread
    }
 
    @Override
    protectedvoid onFailure(Response res, HttpException e) {
        // do some thing on UI thread
    }
});

Java Model 作为参数的请求

?
1
2
3
// build a request url as :  http://a.com?name=jame&id=18
Man man = newMan("jame",18);
Response resonse = client.execute(newRequest("http://a.com",man));

man class:

?
1
2
3
4
5
6
7
8
9
publicclass Man implementsHttpParam{
    privateString name;
    privateint id;
       privateint age;
    publicMan(String name, intid){
        this.name = name;
        this.id= id;
    }
}

全自动Json转化

?
1
2
String url = "http://litesuits.github.io/mockdata/user?id=18";
User man = client.get(url, null, User.class);

User Class:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
publicclass User extendsApiResult {
    //全部声明public是因为写sample方便，不过这样性能也好，
    //即使private变量LiteHttp也能自动赋值，开发者可自行斟酌修饰符。
    publicUserInfo data;
 
    publicstatic class UserInfo {
        publicString name;
        publicint age;
        publicArrayList<String> girl_friends;
    }
}
 
publicabstract class ApiResult {
    publicString api;
    publicString v;
    publicResult result;
 
    publicstatic class Result {
        publicint code;
        publicString message;
    }
}

User JSON Structure:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
    "api": "com.xx.get.userinfo",
    "v": "1.0",
    "result": {
        "code": 200,
        "message": "success"
    },
    "data": {
        "age": 18,
        "name": "qingtianzhu",
        "girl_friends": [
            "xiaoli",
            "fengjie",
            "lucy"
        ]
    }
}

多文件上传

?
1
2
3
4
5
6
7
8
9
       String url = "http://192.168.2.108:8080/LiteHttpServer/ReceiveFile";
    FileInputStream fis = newFileInputStream(newFile("sdcard/1.jpg"));
    Request req = newRequest(url);
    req.setMethod(HttpMethod.Post)
        .setParamModel(newBaiDuSearch())
        .addParam("lite", newFile("sdcard/lite.jpg"), "image/jpeg")
        .addParam("feiq", newFile("sdcard/feiq.exe"), "application/octet-stream");
    if(fis != null) req.addParam("meinv", fis, "sm.jpg", "image/jpeg");
    Response res = client.execute(req);

文件和位图下载

?
1
2
3
4
5
// one way
File file = client.execute(imageUrl, newFileParser("sdcard/lite.jpg"), HttpMethod.Get);
// other way
Response res = client.execute(newRequest(imageUrl).setDataParser(newBitmapParser()));
Bitmap bitmap = res.getBitmap();

0 0