Android network framework: LiteHttp
Tags : litehttp2.x-tutorials
Website : http://litesuits.com
1. What‘s lite-http ?
LiteHttp is a simple, intelligent and flexible HTTP framework for Android. With LiteHttp you can make HTTP request with only one line of code! It could convert a java model to the parameter and rander the response JSON as a java model intelligently.
2. Why choose lite-http ?
Simple, powerful, make HTTP request with only one line of code:
User user = liteHttp.get (url, User.class);
asynchronous download a file(execute on sub-thread,listen on ui-thread):
liteHttp.executeAsync(new FileRequest(url,path).setHttpListener(
new HttpListener<File>(true, true, true) {
@Override
public void onLoading(AbstractRequest<File> request, long total, long len) {
// loading notification
}
@Override
public void onSuccess(File file, Response<File> response) {
// successfully download
}
})
);
configure an asynchronous login request by annotation:
String loginUrl = "http://litesuits.com/mockdata/user_get";
// 1. URL : loginUrl
// 2. Parameter : name=value&password= value
// 3. Response : User
@HttpUri(loginUrl)
class LoginParam extends HttpRichParamModel<User> {
private String name;
private String password;
public LoginParam(String name, String password) {
this.name = name;
this.password = password;
}
}
liteHttp.executeAsync(new LoginParam("lucy", "123456"));
will be built as http://xxx?name=lucy&password=123456
more details, you can see lite-http introduction: LiteHttp Introduction: Why should developers choose LiteHttp ?
3. What are the fetures ?
-
Lightweight: tiny size overhead to your app. About 99kb for core jar. .
-
One-Thread-Based: all methods work on the same thread as the request was created.
-
Full support: GET, POST, PUT, DELETE, HEAD, TRACE, OPTIONS, PATCH.
-
Automatic: one line of code auto-complete translation between Model and Parameter, Json and Model.
-
Configurable: more flexible configuration options, up to 23+ items.
-
Polymorphic: more intuitive API, input and output is more clear.
-
Strong Concurrency: concurrent scheduler that comes with a strong, effective control of scheduling and queue control strategies.
-
Annotation Usage: convention over configuration. Parameters, Response, URL, Method, ID, TAG, etc. Can be configured.
-
Easy expansion: extend the abstract class DataParser to parse inputstream(network) to which you want..
-
Alternatively: interface-based, easy to replace the network connection implementations and Json serialization library.
-
Multilayer cache: hit Memory is more efficient! Multiple cache mode. Support for setting cache expire time.
-
Callback Flexible: callback can be on current or UI thread. listen the beginning, ending, success or failure, uploading, downloading, etc.
-
File Upload: support for single, multiple, large file uploads.
-
Downloads: support files, Bimtap download and progress notifications.
-
Network Disabled: disable one of a variety of network environments, such as specifying disabling 2G, 3G.
-
Statistics: time cost statistics and traffic statistics.
-
Exception system: a unified, concise, clear exception is thrown into three categories: client, network, server, and abnormalities can be accurately subdivided.
-
GZIP compression: automatic GZIP compression.
-
Automatic Retry: combined probe exception type and current network conditions, intelligent retry strategies.
-
Automatic redirection: based on the retry 30X state, and can set the maximum number of times to prevent excessive jump.
4. Overall architecture of lite-http
About App architecture, see my other article: [How to take high-quality Android project framework, the framework of the structure described in detail? ] 7
5. tutorials and analysis (◕‸◕)
Good ◝‿◜, huh:
[1. Initialization and preliminary usage] 8
[2. Simplified requests and non-safe method of use] 9
[3. Automatic model conversion] 10
[4. Custom DataParser and Json serialization library Replace] 11
[5. Files, bitmap upload and download] 12
[6. Disable network and traffic statistics] 13
[7. Retries and redirect] 14
[8. Exceptions handling and cancellation request] 15
[9. Multiple data transmission via POST(PUT)] 16
[10. Asynchronous concurrency and scheduling strategy] 17
[11. Global configuration and parameter settings Detailed] 18
[12. Annotation-Based request] 19
[13. Multilayer cache mechanism and usage] 20
[14. Detailed of callback listener] 21
[15. SmartExecutor: concurrent scheduler] 22
LiteHttp: Android网络通信框架
中文版 换个语种,再来一次
标签: litehttp2.x版本系列教程
QQ群: 大群 47357508 , 二群 42960650
本系列文章面向android开发者,展示开源网络通信框架LiteHttp的主要用法,并讲解其关键功能的运作原理,同时传达了一些框架作者在日常开发中的一些最佳实践和经验。
LiteHttp之开篇简介和大纲目录
1. lite-http是什么? (・̆⍛・̆)
LiteHttp是一款简单、智能、灵活的HTTP框架库,它在请求和响应层面做到了全自动构建和解析,主要用于Android快速开发。
2. 为什么选lite-http? (•́ ₃ •̀)
简单、强大,线程无关,一行代码搞定API请求和数据转化:
User user = liteHttp.get(url, User.class);
当然也可以开启线程异步下载文件:
liteHttp.executeAsync(new FileRequest(url,path).setHttpListener(
new HttpListener<File>(true, true, true) {
@Override
public void onLoading(AbstractRequest<File> request, long total, long len) {
// loading notification
}
@Override
public void onSuccess(File file, Response<File> response) {
// successfully download
}
})
);
通过注解约定完成异步请求:
@HttpUri(loginUrl)
class LoginParam extends HttpRichParamModel<User> {
private String name;
private String password;
public LoginParam(String name, String password) {
this.name = name;
this.password = password;
}
}
liteHttp.executeAsync(new LoginParam("lucy", "123456"));
将构建类似下面请求:http://xxx?name=lucy&password=123456
案例详情可见我另一篇lite-http引言文章:LiteHttp 引言:开发者为什么要选LiteHttp??
3. lite-http有什么特点? (´ڡ`)
-
轻量级:微小的内存开销与Jar包体积,99K左右。
-
单线程:请求本身具有线程无关特性,基于当前线程高效率运作。
-
全支持:GET, POST, PUT, DELETE, HEAD, TRACE, OPTIONS, PATCH。
-
全自动:一行代码自动完成Model与Parameter、Json与Model。
-
可配置:更多更灵活的配置选择项,多达 23+ 项。
-
多态化:更加直观的API,输入和输出更加明确。
-
强并发:自带强大的并发调度器,有效控制任务调度与队列控制策略。
-
注解化:通过注解约定参数,URL、Method、ID、TAG等都可约定。
-
易拓展:自定义DataParser将网络数据流转化为你想要的数据类型。
-
可替换:基于接口,轻松替换网络连接实现方式和Json序列化库。
-
多层缓存:内存命中更高效!多种缓存模式,支持设置缓存有效期。
-
回调灵活:可选择当前或UI线程执行回调,开始结束、成败、上传、下载进度等都可监听。
-
文件上传:支持单个、多个大文件上传。
-
文件下载:支持文件、Bimtap下载及其进度通知。
-
网络禁用:快速禁用一种、多种网络环境,比如指定禁用 2G,3G 。
-
数据统计:链接、读取时长统计,以及流量统计。
-
异常体系:统一、简明、清晰地抛出三类异常:客户端、网络、服务器,且异常都可精确细分。
-
GZIP压缩:Request, Response 自动 GZIP 压缩节省流量。
-
自动重试:结合探测异常类型和当前网络状况,智能执行重试策略。
-
自动重定向:基于 30X 状态的重试,且可设置最大次数防止过度跳转。
4. lite-http的整体架构是怎样的呀? (´ڡ`)
关于App架构,请看我另一篇文章分享: 怎样搭高质量的Android项目框架,框架的结构具体描述?
5. 老湿,来点教学和分析带我飞呗? (◕‸◕)
好的 ◝‿◜ ,下面直接给你看,疗效好记得联系我,呵呵哒: