Harmonyos network framework: LiteHttp

Tags : litehttp2.x-tutorials

Original project website: https://github.com/litesuits/android-lite-http
Original project baseline v2.3.1, sha1: a235642002efa91b8eed3f2952c8f56d9d8aa64f

1. What‘s lite-http ?

LiteHttp is a simple, intelligent and flexible HTTP framework for harmonyos. 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 ?

gradle

Step 1. Add the maven repository to your build file

Add it in your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			...
			mavenCentral()
		}
	}

Step 2. Add the dependency

	dependencies {
	        implementation 'io.github.dzsf:ohoslitehttp:1.0.3'
	        implementation 'io.github.dzsf:ohosapacheclient:1.0.3'
	}

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

Versions

v1.0.0

Licence

Apache Licence

LiteHttp： Harmonyos网络通信框架

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

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

原项目地址: https://github.com/litesuits/android-lite-http
原项目基线版本: v2.3.1, sha1: a235642002efa91b8eed3f2952c8f56d9d8aa64f

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

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

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

LiteHttp之开篇简介和大纲目录

1. lite-http是什么？ (･̆⍛･̆)

LiteHttp是一款简单、智能、灵活的HTTP框架库，它在请求和响应层面做到了全自动构建和解析，主要用于Harmonyos快速开发。

2. 为什么选lite-http？ (•́ ₃ •̀)

gradle

Step 1. Add the maven repository to your build file

Add it in your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			...
			mavenCentral()
		}
	}

Step 2. Add the dependency

	dependencies {
	        implementation 'io.github.dzsf:ohoslitehttp:1.0.3'
	        implementation 'io.github.dzsf:ohosapacheclient:1.0.3'
	}

简单、强大，线程无关，一行代码搞定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"));