MyOkHttp 使用教程

MyOkHttp 使用教程

MyOkHttp对Okhttp3进行二次封装,对外提供了POST请求、GET请求、PATCH请求、PUT请求、DELETE请求、上传文件、下载文件、取消请求、Raw/Json/Gson返回、后台下载管理等功能项目地址:https://gitcode.com/gh_mirrors/my/MyOkHttp

项目介绍

MyOkHttp 是一个基于 OkHttp 封装的 HTTP 客户端库，提供了更加简洁和易用的 API，支持 GET、POST 等常见 HTTP 请求，以及文件上传和下载功能。MyOkHttp 旨在简化网络请求的编写，提高开发效率。

项目快速启动

安装

在项目的 build.gradle 文件中添加以下依赖：

implementation 'com.github.tsy12321:MyOkHttp:1.0.0'

基本使用

以下是一个简单的 GET 请求示例：

import com.tsy.sdk.myokhttp.MyOkHttp;
import com.tsy.sdk.myokhttp.response.GsonResponseHandler;

public class Main {
    public static void main(String[] args) {
        MyOkHttp myOkHttp = new MyOkHttp();
        
        myOkHttp.get()
                .url("https://api.example.com/data")
                .tag(this)
                .enqueue(new GsonResponseHandler<Data>() {
                    @Override
                    public void onSuccess(int statusCode, Data response) {
                        System.out.println("Response: " + response);
                    }

                    @Override
                    public void onFailure(int statusCode, String error_msg) {
                        System.err.println("Error: " + error_msg);
                    }
                });
    }
}

应用案例和最佳实践

文件上传

以下是一个文件上传的示例：

import com.tsy.sdk.myokhttp.MyOkHttp;
import com.tsy.sdk.myokhttp.response.RawResponseHandler;

public class FileUploadExample {
    public static void main(String[] args) {
        MyOkHttp myOkHttp = new MyOkHttp();
        
        myOkHttp.upload()
                .url("https://api.example.com/upload")
                .addFile("file", "example.txt", new File("path/to/example.txt"))
                .tag(this)
                .enqueue(new RawResponseHandler() {
                    @Override
                    public void onSuccess(int statusCode, String response) {
                        System.out.println("Upload success: " + response);
                    }

                    @Override
                    public void onFailure(int statusCode, String error_msg) {
                        System.err.println("Upload error: " + error_msg);
                    }
                });
    }
}

文件下载

以下是一个文件下载的示例：

import com.tsy.sdk.myokhttp.MyOkHttp;
import com.tsy.sdk.myokhttp.response.DownloadResponseHandler;

public class FileDownloadExample {
    public static void main(String[] args) {
        MyOkHttp myOkHttp = new MyOkHttp();
        
        myOkHttp.download()
                .url("https://api.example.com/download/example.txt")
                .filePath("path/to/save/example.txt")
                .tag(this)
                .enqueue(new DownloadResponseHandler() {
                    @Override
                    public void onSuccess(int statusCode, File file) {
                        System.out.println("Download success: " + file.getAbsolutePath());
                    }

                    @Override
                    public void onFailure(int statusCode, String error_msg) {
                        System.err.println("Download error: " + error_msg);
                    }
                });
    }
}

典型生态项目

MyOkHttp 可以与以下项目结合使用，以实现更复杂的功能：

1. Retrofit：用于构建类型安全的 HTTP 客户端。
2. Gson：用于 JSON 数据的序列化和反序列化。
3. RxJava：用于处理异步事件流。

通过这些生态项目的结合，可以进一步提高 MyOkHttp 的灵活性和功能性。

MyOkHttp对Okhttp3进行二次封装,对外提供了POST请求、GET请求、PATCH请求、PUT请求、DELETE请求、上传文件、下载文件、取消请求、Raw/Json/Gson返回、后台下载管理等功能项目地址:https://gitcode.com/gh_mirrors/my/MyOkHttp