网络HTTP

HTTP Network Request Library

A Retrofit-based HTTP network request encapsulation library that provides simple and easy-to-use API interfaces with complete network request functionality.
基于Retrofit的HTTP网络请求封装库，提供简单易用的API接口和完整的网络请求功能。

Features

功能特点

• Built on Retrofit2 and OkHttp
• 基于Retrofit2和OkHttp构建
• Support for common HTTP request methods (GET, POST, PUT, DELETE, etc.)
• 支持常见的HTTP请求方法（GET、POST、PUT、DELETE等）
• Unified request and response handling
• 统一的请求和响应处理
• Flexible request configuration
• 灵活的请求配置
• Custom request headers
• 自定义请求头
• Log interception and printing
• 日志拦截和打印
• Thread-safe singleton implementation
• 线程安全的单例实现

Integration

集成方式

Gradle

dependencies {implementation 'io.github.vance0901:http:1.0.0'
}

加入网络权限 Add network permissions

    <uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Usage

使用方法

1. Initialization

1. 初始化

Initialize in the Application class:
在Application类中初始化：

HttpConfig config = new HttpConfig.Builder().baseUrl("https://api.example.com/").connectTimeout(10000).readTimeout(10000).writeTimeout(10000).debug(BuildConfig.DEBUG).logLevel(BuildConfig.DEBUG ? HttpLoggingInterceptor.Level.BODY : HttpLoggingInterceptor.Level.NONE).build();HttpManager.init(config);

2. Define API Interfaces

2. 定义API接口

public interface ApiService {// GET request example// GET请求示例@GET("users/{id}")Call<BaseResponse<UserInfo>> getUserInfo(@Path("id") long id);// GET request with query parameters// 带查询参数的GET请求@GET("users")Call<BaseResponse<List<UserInfo>>> getUserList(@Query("page") int page, @Query("size") int size);// POST request example - form submission// POST请求示例 - 表单提交@FormUrlEncoded@POST("users/login")Call<BaseResponse<LoginResponse>> login(@Field("username") String username,@Field("password") String password);// POST request example - JSON submission// POST请求示例 - JSON提交@POST("users/create")Call<BaseResponse<UserInfo>> createUser(@Body UserInfo userInfo);// PUT request example// PUT请求示例@PUT("users/{id}")Call<BaseResponse<UserInfo>> updateUser(@Path("id") long id, @Body UserInfo userInfo);// DELETE request example// DELETE请求示例@DELETE("users/{id}")Call<BaseResponse<Void>> deleteUser(@Path("id") long id);// DELETE request with body// 带请求体的DELETE请求@HTTP(method = "DELETE", path = "users", hasBody = true)Call<BaseResponse<Void>> batchDeleteUsers(@Body List<Long> userIds);
}

3. Create API Service Class

3. 创建API服务类

public class UserService extends BaseApiService<ApiService> {private static volatile UserService instance;private UserService() {super();}public static UserService getInstance() {if (instance == null) {synchronized (UserService.class) {if (instance == null) {instance = new UserService();}}}return instance;}@Overrideprotected Class<ApiService> getApiServiceClass() {return ApiService.class;}// GET request example// GET请求示例public void getUserInfo(long userId, RequestCallback<UserInfo> callback) {executeRequest(apiService.getUserInfo(userId), callback);}// GET request with parameters example// 带参数的GET请求示例public void getUserList(int page, int size, RequestCallback<List<UserInfo>> callback) {executeRequest(apiService.getUserList(page, size), callback);}// POST request example// POST请求示例public void login(String username, String password, RequestCallback<LoginResponse> callback) {executeRequest(apiService.login(username, password), callback);}// POST request with JSON example// 带JSON的POST请求示例public void createUser(UserInfo userInfo, RequestCallback<UserInfo> callback) {executeRequest(apiService.createUser(userInfo), callback);}// PUT request example// PUT请求示例public void updateUser(long userId, UserInfo userInfo, RequestCallback<UserInfo> callback) {executeRequest(apiService.updateUser(userId, userInfo), callback);}// DELETE request example// DELETE请求示例public void deleteUser(long userId, RequestCallback<Void> callback) {executeRequest(apiService.deleteUser(userId), callback);}// DELETE request with body example// 带请求体的DELETE请求示例public void batchDeleteUsers(List<Long> userIds, RequestCallback<Void> callback) {executeRequest(apiService.batchDeleteUsers(userIds), callback);}
}

4. Make Network Requests

4. 发起网络请求

4.1 POST Request Example

4.1 POST请求示例

UserService.getInstance().login("username", "password", new RequestCallback<LoginResponse>() {@Overridepublic void onStart() {// Show loading state// 显示加载状态}@Overridepublic void onSuccess(LoginResponse data) {// Handle successful response// 处理成功响应}@Overridepublic void onError(int code, String message) {// Handle error response// 处理错误响应}@Overridepublic void onComplete() {// Request completed// 请求完成}
});

4.2 GET Request Example

4.2 GET请求示例

UserService.getInstance().getUserInfo(123, new RequestCallback<UserInfo>() {@Overridepublic void onStart() {// Show loading state// 显示加载状态}@Overridepublic void onSuccess(UserInfo data) {// Handle user information// 处理用户信息String username = data.getUsername();String email = data.getEmail();}@Overridepublic void onError(int code, String message) {// Handle errors, e.g., user not found// 处理错误，例如用户未找到}@Overridepublic void onComplete() {// Request completed// 请求完成}
});

4.3 PUT Request Example

4.3 PUT请求示例

// Create user information to update
// 创建要更新的用户信息
UserInfo userInfo = new UserInfo();
userInfo.setUsername("newUsername");
userInfo.setEmail("[e-mail]");UserService.getInstance().updateUser(123, userInfo, new RequestCallback<UserInfo>() {@Overridepublic void onStart() {// Show updating state// 显示更新状态}@Overridepublic void onSuccess(UserInfo data) {// Handle updated user information// 处理更新后的用户信息}@Overridepublic void onError(int code, String message) {// Handle update failure// 处理更新失败}@Overridepublic void onComplete() {// Update request completed// 更新请求完成}
});

4.4 DELETE Request Example

4.4 DELETE请求示例

UserService.getInstance().deleteUser(123, new RequestCallback<Void>() {@Overridepublic void onStart() {// Show deleting state// 显示删除状态}@Overridepublic void onSuccess(Void data) {// Handle successful deletion// 处理成功删除}@Overridepublic void onError(int code, String message) {// Handle deletion failure// 处理删除失败}@Overridepublic void onComplete() {// Deletion request completed// 删除请求完成}
});

5. Managing Request Headers

5. 管理请求头

5.1 Setting Global Authentication Token

5.1 设置全局认证令牌

// Set a global authentication token that will be used for all requests
// 设置一个全局认证令牌，用于所有请求
HttpManager.getInstance().setGlobalToken("your-auth-token-here");

5.2 Adding Custom Headers

5.2 添加自定义请求头

// Add a single custom header
// 添加单个自定义请求头
HttpManager.getInstance().addGlobalHeader("Custom-Header", "Header-Value");// Add multiple headers at once
// 一次添加多个请求头
Map<String, String> headers = new HashMap<>();
headers.put("X-API-Key", "api-key-value");
headers.put("Accept-Language", "en-US");
HttpManager.getInstance().addGlobalHeaders(headers);

5.3 Removing Headers

5.3 移除请求头

// Remove a specific header
// 移除特定请求头
HttpManager.getInstance().removeGlobalHeader("Custom-Header");// Clear all global headers
// 清除所有全局请求头
HttpManager.getInstance().clearGlobalHeaders();

5.4 Example: Managing Authentication Token After Login

5.4 示例：登录后管理认证令牌

UserService.getInstance().login("username", "password", new RequestCallback<LoginResponse>() {@Overridepublic void onStart() {// Show loading state// 显示加载状态}@Overridepublic void onSuccess(LoginResponse data) {// After successful login, set the authentication token// 登录成功后，设置认证令牌if (data != null && data.getToken() != null) {HttpManager.getInstance().setGlobalToken(data.getToken());}// Handle other login response data// 处理其他登录响应数据}@Overridepublic void onError(int code, String message) {// Handle login failure// 处理登录失败}@Overridepublic void onComplete() {// Login request completed// 登录请求完成}
});

Design Patterns

设计模式

This library uses multiple design patterns:
此库使用多种设计模式：

• Singleton Pattern: HttpManager
• 单例模式：HttpManager
• Builder Pattern: HttpConfig.Builder
• 构建者模式：HttpConfig.Builder
• Factory Pattern: HttpManager.createApi()
• 工厂模式：HttpManager.createApi()
• Observer Pattern: RequestCallback
• 观察者模式：RequestCallback
• Template Method Pattern: BaseApiService
• 模板方法模式：BaseApiService
• Strategy Pattern: Different request strategies through different API interfaces
• 策略模式：通过不同的API接口实现不同的请求策略
• Proxy Pattern: HeaderInterceptor
• 代理模式：HeaderInterceptor

Project Structure

项目结构

com.vance0901.zhuhai.network.http
├── HttpManager.java               // HTTP Manager
│                                  // HTTP管理器
│                                  
├── callback                       // Callback interfaces
│                                  // 回调接口
│   └── RequestCallback.java       // Request callback interface
│                                  // 请求回调接口
├── config                         // Configuration classes
│                                  // 配置类
│   └── HttpConfig.java            // HTTP configuration class
│                                  // HTTP配置类
├── interceptor                    // Interceptors
│                                  // 拦截器
│   └── HeaderInterceptor.java     // Request header interceptor
│                                  // 请求头拦截器
├── model                          // Data models
│                                  // 数据模型
│   └── BaseResponse.java          // Base response class
│                                  // 基础响应类
└── service                        // Service classes// 服务类└── BaseApiService.java        // Base API service class// 基础API服务类

JAVA开发者或其他开发人员使用请参考:
https://central.sonatype.com/artifact/io.github.vance0901/http/overview
For JAVA developers or other developers to use, please refer to:
https://central.sonatype.com/artifact/io.github.vance0901/http/overview
更多详细用法请查看demo。 For more detailed usage, please refer to the demo.

代码链接：

https://github.com/vance0901/ZhuHaiHttp