当前位置： 首页 > news >正文

安亭网站建设,泰州品牌网站建设,域名访问网站在哪里找,域名服务器在哪个国家TechZhi HTTP Client Starter 源码特性快速开始1. 添加依赖2. 配置3. 使用 主要功能支持的HTTP方法文件操作功能高级功能配置示例 API使用示例基本请求自定义请求异步请求文件操作示例错误处理 构建和测试依赖说明 本文将介绍一款本人开发的高性能Spring Boot HTTP客户端Starte… TechZhi HTTP Client Starter 源码特性快速开始1. 添加依赖2. 配置3. 使用 主要功能支持的HTTP方法文件操作功能高级功能配置示例 API使用示例基本请求自定义请求异步请求文件操作示例错误处理 构建和测试依赖说明 本文将介绍一款本人开发的高性能Spring Boot HTTP客户端Starter它完美整合了OkHttp和Apache HttpClient。该项目旨在解决原生HTTP客户端以及RestTemplate在文件上传下载、异步请求、失败重试等场景下的复杂性提供一个配置简单、功能强大的解决方案。 源码 https://github.com/ShouZhiDuan/easydo/blob/main/http-client-starter/README.md特性 高性能: 基于OkHttp和Apache HttpClient 5的高性能HTTP客户端 易配置: 丰富的配置选项支持连接池、超时、重试等 安全支持: 支持SSL/TLS配置可关闭证书校验 代理支持: 支持HTTP和SOCKS代理配置 日志集成: 可配置的请求/响应日志记录 重试机制: 内置智能重试机制 异步支持: 支持同步和异步HTTP请求 类型安全: 自动JSON序列化/反序列化️ Spring Boot集成: 无缝集成Spring Boot自动配置 文件操作: 完整的文件上传、下载和流处理支持 进度跟踪: 文件传输进度回调和监控 智能检测: 自动文件类型检测和Content-Type映射 快速开始

1. 添加依赖 dependencygroupIdcom.techzhi.common/groupIdartifactIdhttp-client-starter/artifactIdversion1.0.0/version /dependency2. 配置 techzhi:http-client:enabled: trueclient-type: OK_HTTPconnect-timeout: 10sread-timeout: 30s# 更多配置选项请参考配置文档3. 使用 Service public class MyService {Autowiredprivate HttpClient httpClient;Autowiredprivate HttpClientTemplate httpClientTemplate;public void example() {// 基本GET请求HttpResponseString response httpClient.get(https://api.example.com/data);// 带类型转换的GET请求HttpResponseUser userResponse httpClient.get(https://api.example.com/user/1, User.class);// POST请求User newUser new User(John, johnexample.com);HttpResponseUser createResponse httpClient.post(https://api.example.com/users, newUser, User.class);// 使用模板类HttpResponseString tokenResponse httpClientTemplate.getWithToken(https://api.example.com/protected, your-token);} }主要功能 支持的HTTP方法 GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS同步和异步请求自动JSON序列化/反序列化表单提交支持 文件操作功能 文件上传: 支持单个和多个文件上传多部分表单: multipart/form-data支持可混合文件和表单字段文件下载: 支持大文件流式下载自动创建目录进度回调: 上传和下载进度实时监控文件流: 获取文件输入流和字节数组类型检测: 自动文件类型检测和Content-Type映射异步操作: 支持异步文件上传和下载 高级功能 连接池管理代理配置HTTP/SOCKSSSL/TLS配置支持关闭证书验证重试机制请求/响应日志Bearer Token和Basic认证 配置示例 techzhi:http-client:enabled: trueclient-type: OK_HTTP # OK_HTTP 或 APACHE_HTTP_CLIENTconnect-timeout: 10sread-timeout: 30swrite-timeout: 30s# 连接池配置pool:max-total: 200default-max-per-route: 50time-to-live: 5m# 代理配置proxy:enabled: falsetype: HTTPhost: proxy.example.comport: 8080# SSL配置ssl:verify-hostname: trueverify-certificate-chain: true# 重试配置retry:enabled: truemax-attempts: 3retry-interval: 1sAPI使用示例 基本请求 // GET请求 HttpResponseString response httpClient.get(https://httpbin.org/get);// POST请求 MapString, Object data Map.of(key, value); HttpResponseString postResponse httpClient.post(https://httpbin.org/post, data);自定义请求 HttpRequest request HttpRequest.post(https://httpbin.org/post).header(Authorization, Bearer token).header(Content-Type, application/json).queryParam(page, 1).jsonBody(requestData);HttpResponseResponseData response httpClient.execute(request, ResponseData.class);异步请求 CompletableFutureHttpResponseString future httpClient.getAsync(https://httpbin.org/get); future.thenAccept(response - {System.out.println(Response: response.getBody()); });文件操作示例 // 1. 单个文件上传 File file new File(document.pdf); HttpResponseString uploadResponse httpClient.uploadFile(https://api.example.com/upload, file, file );// 2. 文件上传带进度回调 FileProgressCallback progressCallback new FileProgressCallback() {Overridepublic void onProgress(long bytesTransferred, long totalBytes, double percentage) {System.out.printf(上传进度: %.2f%%\n, percentage);}Overridepublic void onComplete(long totalBytes) {System.out.println(上传完成: totalBytes bytes);} };httpClient.uploadFile(https://api.example.com/upload, file, file, progressCallback);// 3. 多文件上传 ListMultipartFile files Arrays.asList(MultipartFile.of(file1, new File(doc1.pdf)),MultipartFile.of(file2, new File(doc2.pdf)),MultipartFile.of(data, info.json, jsonData.getBytes(), application/json) );HttpResponseString multiResponse httpClient.uploadFiles(https://api.example.com/upload, files);// 4. 文件和表单数据混合上传 MapString, String formFields new HashMap(); formFields.put(title, 文档标题); formFields.put(category, 技术文档);httpClient.uploadFilesWithForm(https://api.example.com/upload, files, formFields);// 5. 文件下载 boolean downloadSuccess httpClient.downloadFile(https://api.example.com/download/report.pdf, /path/to/save/report.pdf );// 6. 文件下载带进度回调 httpClient.downloadFile(https://api.example.com/download/large-file.zip, /path/to/save/large-file.zip, progressCallback );// 7. 获取文件字节数组 byte[] fileBytes httpClient.getFileBytes(https://api.example.com/download/small-file.txt);// 8. 获取文件流 try (InputStream fileStream httpClient.getFileStream(https://api.example.com/download/data.csv)) {// 处理文件流BufferedReader reader new BufferedReader(new InputStreamReader(fileStream));String line;while ((line reader.readLine()) ! null) {// 处理每一行} }// 9. 异步文件操作 CompletableFutureHttpResponseString asyncUpload httpClient.uploadFileAsync(https://api.example.com/upload, file, file );CompletableFutureBoolean asyncDownload httpClient.downloadFileAsync(https://api.example.com/download/file.zip, /path/to/save/file.zip );错误处理 HttpResponseString response httpClient.get(https://httpbin.org/status/404);if (response.isSuccessful()) {String data response.getBody(); } else if (response.isClientError()) {System.out.println(Client error: response.getStatusCode()); } else if (response.isServerError()) {System.out.println(Server error: response.getStatusCode()); }构建和测试

   编译项目

   mvn clean compile# 运行测试 mvn test# 打包 mvn clean package# 安装到本地仓库 mvn install依赖说明 本项目支持以下HTTP客户端实现 OkHttp: 默认实现高性能、轻量级Apache HttpClient 5: 功能丰富企业级特性 根据项目需求选择合适的实现通过配置techzhi.http-client.client-type来切换。