Android network framework: LiteHttp

Tags : litehttp2.x-tutorials

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

Lite-http Chart

About App architecture, see my other article: How to take high-quality Android project framework, the framework of the structure described in detail?

5. tutorials and analysis (◕‸◕)

Good ◝‿◜, huh:

1. Initialization and preliminary usage

2. Simplified requests and non-safe method of use

3. Automatic model conversion

4. Custom DataParser and Json serialization library Replace

5. Files, bitmap upload and download

6. Disable network and traffic statistics

7. Retries and redirect

8. Exceptions handling and cancellation request

9. Multiple data transmission via POST(PUT)

10. Asynchronous concurrency and scheduling strategy

11. Global configuration and parameter settings Detailed

12. Annotation-Based request

13. Multilayer cache mechanism and usage

14. Detailed of callback listener

15. SmartExecutor： concurrent scheduler

LiteHttp： Android网络通信框架

中文版换个语种，再来一次

标签： litehttp2.x版本系列教程

官网： http://litesuits.com

QQ群：大群 47357508 ，二群 42960650

Android网络框架为什么可以选用lite-http？

lite-http 初步使用和快速起步上手

本系列文章面向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？？