android 网络通信api,Android网络通信框架LiteHttp 第十二节：通过注解完成API请求

Android网络通信框架LiteHttp 第十二节：通过注解完成API请求

litehttp2.x版本系列教程

QQ群： 大群 47357508，二群 42960650

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

第十二节：LiteHttp之通过注解完成API请求

本节强烈推荐通过 RichParamModel 方式构建请求，它大概是长这样子：

@HttpUri(loginUrl)

classLoginParamextendsHttpRichParamModel{

publicStringname="lucy";

publicStringpassword="123456";

}

liteHttp.executeAsync(newUserRichParam());

表示请求 loginUrl 这个地址，并传递 name 和 password 参数，返回用户 User 对象。

关于注解，还得从头说起：

在java模型自动转化那一节我们讲过，lite-http 可以把java对象转换为http请求的参数，需要该java类继承 HttpParamModel，实际上 HttpParamModel 还有一个拓展子类 HttpRichParamModel，拓展顾名思义是一个基于原来的增强，开发者连Request都不用写了，直接继承 HttpRichParamModel 通过注解来完成整个http请求的参数约定。

1. 简单参数 HttpParamModel

先看这段代码：

// Usage of Annotation

publicStringuserUrl="http://litesuits.com/mockdata/user_get";

@HttpUri(userUrl)

@HttpMethod(HttpMethods.Get)

@HttpID(1)

@HttpCacheMode(CacheMode.CacheFirst)

@HttpCacheExpire(value=1,unit=TimeUnit.MINUTES)

classUserAnnoParamimplementsHttpParamModel{

publiclongid=110;

privateStringkey="aes";

}

liteHttp.executeAsync(newJsonRequest(newUserAnnoParam(),User.class){}

.setHttpListener(newHttpListener(){

@Override

publicvoidonSuccess(Useruser,Responseresponse){

HttpUtil.showTips(activity,"UserAnnoParam",user.toString());

}

}));

所见即所得，通过这些注解：@HttpUri(userUrl)

@HttpMethod(HttpMethods.Get)

@HttpID(1)

@HttpCacheMode(CacheMode.CacheFirst)

@HttpCacheExpire(value = 1, unit = TimeUnit.MINUTES)

上面一段代码，完成了这样一次请求配置：请求地址为 userUrl

请求方式为 GET

请求ID为 1

请求优先使用缓存

请求缓存时间为1分钟

2. 扩展版参数HttpRichParamModel

再看一下拓展的参数类如何工作：

// Best Practice: HTTP Rich Param Model (It is simpler and More Useful)

@HttpUri(userUrl)

classUserRichParamextendsHttpRichParamModel{

publiclongid=110;

privateStringkey="aes";

}

// 一句话调用即可

liteHttp.executeAsync(newUserRichParam());

可见，最后一句执行时连 Request 都没有创建，直接将参数投入执行。定义RichParam，可指定URL、参数、响应体三个关键事物：

请求地址： uerUrl

请求参数： id=110 & key=aes

请求响应： User

更多注解方式有：@HttpSchemeHost("http://litesuits.com") // 定义scheme

@HttpUri("/mockdata/user_get") // 定义uri 或者 path

@HttpMethod(HttpMethods.Get) // 请求方式

@HttpCharSet("UTF-8") // 请求编码

@HttpTag("custom tag") // 打TAG

@HttpCacheMode(CacheMode.CacheFirst) // 缓存模式

@HttpCacheKey("custom-cache-key-name-by-myself") // 缓存文件名字

@HttpCacheExpire(value = 1, unit = TimeUnit.MINUTES) // 缓存时间

@HttpID(2) // 请求ID

@HttpMaxRetry(3) // 重试次数

@HttpMaxRedirect(5) // 重定向次数

此外，继承Rich Param的参数类还可以复写下面方法：createHeaders ： 创建header

createQueryBuilder： 设置参数构建器

createHttpListener： 创建监听器

createHttpBody： 创建数据体

createHttpBody是为POST、PUT等方式创建数据体，GET、DELETE等不需要，因其参数直接拼接到URL。

3. 最佳实践

最后，通过这句：liteHttp.executeAsync(new UserRichParam());

可见 RichParamModel 是可以直接抛入执行的，这就将其和 Request 基本提升到了同一级别。

在我的 App 里，我是直接用 RichParamModel 的，因为它更直观简单，并且 RichParamModel 可以通过 set 方法设置监听器等参数，所以我也建议开发者使用这个进行请求配置。

强烈推荐通过 RichParamModel 方式构建请求。