Watch 1 Star 0 Fork 1

myq13579 / httpclient-interfacingJava

Join us
Explore and code with more than 2 million developers,Free private repositories !:)
Sign up
http客户端接口设计,完全模拟http可能的参数,支持GET、POST、文件上传下载等,有多种实现:OKHttp3、ApacheHttpClient、HttpURLConnection、Jodd-http,可以无代码改变地切换http实现。在原项目基础上分拆模块化:https://gitee.com/xxssyyyyssxx/httpclient spread retract

Clone or download
Loading...
README.md

httpclient-interfacing

introduction

Http客户端接口设计,基本覆盖所有Http可能的参数,针对Http请求抽象出了参数设置的接口,进而达到使用统一、一致、连缀的API对URL、Header、Body、Form、文件上传提供最大的支持。 目前适配了这几种实现:OkHttp3、ApacheHttpClient、HttpURLConnection、JoddHttp,可以无代码修改地实现一键切换。 我用此工具逐渐替换了业务项目工程中不统一、繁杂的各种HttpClient工具的实现、版本,只需要面向统一、抽象的操作接口。 可以做到无代码修改切换Http请求的实现,而无需散弹式修改

http模块的架构设计和使用方式见 CSDN博客

一个http请求工具类的接口化(接口设计)

一个http请求工具类的接口化(多种实现)

项目采用双接口并行设计模式,一种是面向接口实现者的 HttpTemplate-SmartHttpTemplate 功能接口 ,主要的功能是模拟Http的参数、header等;一种是面向终端用户调用者的 HttpClient-SmartHttpClient 用户接口 。具体实现类通过实现两组接口,后者接口实现最终调用前者的接口实现。这样做的好处是互不影响,实现者可以无限优化 HttpTemplate、SmartHttpTemplate 的实现类,而对使用者几无影响。

HttpTemplate、HttpClient接口基于方法来模拟Http的参数、header等;SmartHttpTemplate继承于HttpTemplate,SmartHttpClient接口继承于HttpClient,且基于Request来模拟Http的参数、header,这样更容易优化、更容易使用。

接口体系设计及类图说明

features

  • HttpClient接口体系
  • SmartHttpClient(继承HttpClient)接口体系:基于Request-Response
  • Request支持链式调用、支持基于策略接口的Java对象转换为String、支持路径参数
  • Response支持基于策略接口的String转换为Java对象
  • 支持文件上传、下载
  • 支持https
  • 支持无代码修改的OkHttp3、ApacheHttpClient、HttpURLConnection、JoddHttp的切换
  • HttpUtil支持根据jar包的存在性加载实现
  • 配置项可以通过-D或者System.setProperty()全局设置,可以对某个实现的对象例如 NativeSmartHttpClient 全局设置,也可以针对某一个请求Request单独设置,优先级逐渐升高
  • 支持返回值和JavaBean之间的转换,基于项目 https://gitee.com/xxssyyyyssxx/httpclient-converter
  • 通过Config全局配置默认参数
  • 支持全局header设置、全局Query参数
  • 支持请求之前之后加入特定的处理,复写SmartHttpClientbeforeTemplateafterTemplate方法
  • Proxy代理支持
  • HttpUtil提供的静态方法完全代理SmartHttpClient接口,实现一句话完成Http请求
  • 从1.1.1版本开始Request分裂为表达每种请求的不同Request
  • 从1.1.1版本开始支持基于CookieHandler的Cookie支持,在全局设置中设置CookieHandler即可
  • 从1.1.2版本开始类似Retrofit、MyBatis-Mapper的接口使用方式
  • 从1.1.2版本开始支持全局拦截器拦截
  • 从1.1.5版本开始支持每个HttpRequest中设置属性便于后续使用
  • 从1.1.8版本开始支持所有的HTTP METHOD
  • 文件上传支持断点续传

how to import it?

源码使用

下载本项目,gradle clean build得到的jar包引入工程即可。本项目依赖于utils

项目管理工具导入

项目已经发布至 jcentermaven 中央仓库 最新版本version: 1.1.8 引入其中一种实现即可

Gradle:

compile 'top.jfunc.network:httpclient-jdk:${version}'
compile 'top.jfunc.network:httpclient-apache:${version}'
compile 'top.jfunc.network:httpclient-okhttp3:${version}'
compile 'top.jfunc.network:httpclient-jodd:${version}'

Maven:

<!-- https://mvnrepository.com/artifact/top.jfunc.network/httpclient-jdk -->
<dependency>
    <groupId>top.jfunc.network</groupId>
    <artifactId>httpclient-jdk</artifactId>
    <version>${version}</version>
</dependency>
<!-- https://mvnrepository.com/artifact/top.jfunc.network/httpclient-apache -->
<dependency>
    <groupId>top.jfunc.network</groupId>
    <artifactId>httpclient-apache</artifactId>
    <version>${version}</version>
</dependency>
<!-- https://mvnrepository.com/artifact/top.jfunc.network/httpclient-okhttp3 -->
<dependency>
    <groupId>top.jfunc.network</groupId>
    <artifactId>httpclient-okhttp3</artifactId>
    <version>${version}</version>
</dependency>
<!-- https://mvnrepository.com/artifact/top.jfunc.network/httpclient-jodd -->
<dependency>
    <groupId>top.jfunc.network</groupId>
    <artifactId>httpclient-jodd</artifactId>
    <version>${version}</version>
</dependency>

SpringBoot环境下更简单,引入相应的starter即可,就可以直接使用SmartHttpClient的实例,当然你可以配置一些参数。

how to use it?

面向SmartHttpClient

  1. 可以使用HttpUtil获取一个实现(基于ServiceLoader加载),或者自己实例化一个;
  2. 在SpringBoot项目中,用Bean注入;
  3. HttpUtil实现了对接口SmartHttpClient的完全静态化代理,一句话实现Http请求。
  4. 定义接口并标注HttpService注解,配置后直接注入接口即可(类似Retrofit、Mapper)
@Configuration
public class HttpConfig {

    @Bean("smartHttpClient")
    public SmartHttpClient smartHttpClient(){
        //如果要更换http的实现或者做更多的事情,可以对此bean进行配置
        NativeSmartHttpClient smartHttpClient = new NativeSmartHttpClient();
        // new OkHttp3SmartHttpClient();
        // new ApacheSmartHttpClient(){
                //重写某些方法
        };
        smartHttpClient.setConfig(Config.defaultConfig()...);//设置baseUrl...
        retrun smartHttpClient;
    }
    
    
    //以下配置可以扫描 top.jfunc.network.controller.client 包下的标注 @HttpService 注解的接口
    @Bean
    public HttpServiceCreator httpServiceCreator(SmartHttpClient smartHttpClient){
        return new HttpServiceCreator().setSmartHttpClient(smartHttpClient);
    }
    @Bean
    public HttpServiceScanConfigure httpServiceScanConfigure(){
        HttpServiceScanConfigure httpServiceScanConfigure = new HttpServiceScanConfigure(jFuncHttp(smartHttpClient()));
        httpServiceScanConfigure.setAnnotationClassScan(HttpService.class);
        httpServiceScanConfigure.setScanPackages("top.jfunc.network.controller.client");
        return httpServiceScanConfigure;
    }
}

当拿到实例之后,就可以使用接口定义的所有的方法用于http请求。 HttpClient接口定义了基本的http请求方法,SmartHttpClient继承于HttpClient,新增了基于Request的方法 见架构图。

setConfig可以设置SmartHttpClient实例的全局默认设置。目前定义了一下一些参数。

baseUrl、defaultConnectionTimeout、defaultReadTimeout、defaultBodyCharset、defaultResultCharset、defaultHeaders。

定义了这些可配置项,可以通过-D或者System.setProperty()全局设置,可以对某个实现的对象例如 NativeSmartHttpClient 全局设置,也可以针对某一个请求单独设置,优先级逐渐升高

https://gitee.com/xxssyyyyssxx/httpclient/blob/master/src/test/java/top/jfunc/common/http/HttpBasicTest.java

https://gitee.com/xxssyyyyssxx/httpclient/blob/master/src/test/java/top/jfunc/common/http/HttpSmartTest.java

下面演示几种用法:

  1. Request代表所有请求的变量,支持链式编程
  2. SmartHttpClient接口的实现类完成真正的请求
  3. Response代表返回信息,可以根据需要转换为字节数组、字符串。。。

GET:

Response response = http.get(Request.of(url).setIgnoreResponseBody(false).setIncludeHeaders(true).addHeader("saleType" , "2").setResultCharset("UTF-8"));
System.out.println(response);
System.out.println("headers:" + response.getHeaders());

String s = http.get(url);
System.out.println(s);

Request request = Request.of(url).addParam("xx" , "xx").addParam("yy" , "yy").addHeader("saleType" , "2").setResultCharset("UTF-8");
byte[] bytes = http.getAsBytes(request);
System.out.println(bytes.length);
System.out.println(new String(bytes));

request = Request.of(url).setFile(new File("C:\\Users\\xiongshiyan\\Desktop\\yyyy.txt"));
File asFile = http.getAsFile(request);
System.out.println(asFile.getAbsolutePath());

POST:

Request request = Request.of(url).setIncludeHeaders(true).addHeader("ss" , "ss").addHeader("ss" , "dd").setBody("{\"name\":\"熊诗言\"}").setContentType(JSON_WITH_DEFAULT_CHARSET).setConnectionTimeout(10000).setReadTimeout(10000).setResultCharset("UTF-8");
Response post = http.post(request);
System.out.println(post.getBody());
System.out.println(post.getHeaders());

String s = http.postJson(url, "{\"name\":\"熊诗言\"}");
System.out.println(s);

request = Request.of(url).addParam("xx" , "xx").addParam("yy" , "yy").setContentType(FORM_URLENCODED);
Response response = http.post(request);
System.out.println(response.getBody());

UPLOAD:

FormFile formFile = new FormFile(new File("E:\\838586397836550106.jpg") , "filedata",null);
Request request = Request.of(url).addHeader("empCode" , "ahg0023")
        .addHeader("phone" , "15208384257").addFormFile(formFile).setIncludeHeaders(true);
Response response = httpClient.upload(request);
System.out.println(response.getBody());
System.out.println(response.getHeaders());

多文件及带参数的上传:

FormFile formFile = new FormFile(new File("E:\\838586397836550106.jpg") , "filedata",null);
FormFile formFile2 = new FormFile(new File("E:\\BugReport.png") , "filedata2",null);
Request request = Request.of(url).addHeader("empCode" , "ahg0023")
        .addHeader("phone" , "15208384257").addFormFile(formFile2).addFormFile(formFile).setIncludeHeaders(true);

request.addParam("k1", "v1").addParam("k2" , "v2");
Response response = httpClient.upload(request);
System.out.println(response.getBody());
System.out.println(response.getHeaders());

对SmartHttpClient设置全局默认参数

http.setConfig(Config.defaultConfig()
            .setBaseUrl("https://fanyi.baidu.com/")
            .addDefaultHeader("xx" , "xx")
            .setDefaultBodyCharset("UTF-8")
            .setDefaultResultCharset("UTF-8")
            .setDefaultConnectionTimeout(15000)
            .setDefaultReadTimeout(15000)

    //.....
   );

在配置HttpService接口扫描之后,定义如下一样的接口


@HttpService
public interface InterfaceForTestHttpService {

    @GET
    Response request(HttpRequest httpRequest);

    @GET("/get/{q}")
    Response list(@Path("q") String q, @Query("xx") int xx);
    @GET("/get/query")
    Response queryMap(@QueryMap Map<String, String> map);
    @GET
    Response url(@Url String url);

    @GET("get/query")
    Response header(@Header("naked") String naked);

    @Headers({"xx:xiongshiyan","yy:xsy"})
    @GET("get/query")
    Response headers(@Header("naked") String naked);

    @GET("get/query")
    Response headerMap(@HeaderMap Map<String, String> map);



    @GET("/get/query")
    Response download();

    @POST("/post/{id}")
    Response post(@Path("id") String id, @Body String xx);

    @Multipart
    @POST("/upload/only")
    Response upload(@Part FormFile... formFiles);
    @Multipart
    @POST("/upload/withParam")
    Response uploadWithParam(@Part("name") String name, @Part("age") int age, @Part FormFile... formFiles);

    @FormUrlEncoded
    @POST("/post/form")
    Response form(@Field("name") String name, @Field("age") int age);
    @FormUrlEncoded
    @POST("/post/form")
    Response formMap(@FieldMap Map<String, String> params);
}

建议的最佳实践为:

  1. 设置body的同时应该设置Content-Type
  2. 针对同一组请求可以使用一个SmartHttpClient,可以对他进行一些参数设置
  3. 使用拦截器而非复写父类方法达到拦截目的

更多用法等待你探索,本人才疏学浅,难免有考虑不周到的地方,请不吝赐教。

提供了服务端和客户端的测试工程,可以clone下来运行。

https://gitee.com/xxssyyyyssxx/http-server-test

https://gitee.com/xxssyyyyssxx/http-client-test

如果你想实现自己的,只需要继承 top.jfunc.common.http.smart.AbstractSmartHttpClient , 参考top.jfunc.common.http.smart.DemoImpl实现抽象方法即可。实现方法可以参考httpclient-jdk、apache、okhttp3、jodd等。

Comments ( 0 )

Sign in for post a comment

Java
1
https://gitee.com/myqyun/httpclient-interfacing.git
git@gitee.com:myqyun/httpclient-interfacing.git
myqyun
httpclient-interfacing
httpclient-interfacing
master

Help Search