android-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.

Code Quality Rank: L2

Programming language: Java

License: Apache License 2.0

Tags: Network    

Latest version: v2.3.1

README

Android network framework: LiteHttp

Tags : litehttp2.x-tutorials

---

Website : http://litesuits.com

QQgroup : 42960650 , 47357508

Android网络通信为啥子选 lite-http ？

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

---

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?

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？？

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. 老湿，来点教学和分析带我飞呗？ (◕‸◕)

好的 ◝‿◜ ，下面直接给你看，疗效好记得联系我，呵呵哒：

1. 初始化和初步使用

2. 简化请求和非安全方法的使用

3. 自动对象转化

4. 自定义DataParser和Json序列化库的替换

5. 文件、位图的上传和下载

6. 禁用网络和流量、时间统计

7. 重试和重定向

8. 处理异常和取消请求

9. POST方式的多种类型数据传输

10. lite-http异步并发与调度策略

11. 全局配置与参数设置详解

12. 通过注解完成API请求

13. 多层缓存机制及用法

14. 回调监听器详解

15. 并发调度控制器详解