Прекрасный клиент HTTP

implementation 'top.jfunc.network:unihttp-all:${version}'

implementation 'com.gitee.xxssyyyyssxx.unihttp-all:${version}'

<!-- https://mvnrepository.com/artifact/top.jfunc.network/httpclient -->
<dependency>
    <groupId>top.jfunc.network</groupId>
    <artifactId>unihttp-all</artifactId>
    <version>${version}</version>
</dependency>

implementation('top.jfunc.network:unihttp-all:${version}') {
        exclude group: 'org.apache.httpcomponents'
        exclude group: 'com.squareup.okhttp3'
        exclude group: 'org.jodd'
}

<dependency>
    <groupId>top.jfunc.network</groupId>
    <artifactId>unihttp-all</artifactId>
    <version>${version}</version>
    <exclusions>
        <exclusion>
            <groupId>com.squareup.okhttp3</groupId>
            <artifactId>okhttp</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.apache.httpcomponents</groupId>
            <artifactId>httpclient</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.apache.httpcomponents</groupId>
            <artifactId>httpmime</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.jodd</groupId>
            <artifactId>jodd-http</artifactId>
        </exclusion>
    </exclusions>
</dependency>
```### Как использовать его?

**Для SmartHttpClient**

1. Вы можете использовать делегата HttpUtil для получения реализации или создать экземпляр самостоятельно;
2. В Spring Boot проектах используйте Bean для внедрения;
3. HttpUtil предоставляет полную статическую обёртку для SmartHttpClient, что позволяет сделать HTTP-запрос одной строкой кода.

```java
@Configuration
public class HttpConfig {
    @Bean("smartHttpClient")
    public SmartHttpClient smartHttpClient(){
        // Если требуется заменить реализацию HTTP или выполнить больше действий, можно настроить этот бин
        SmartHttpClient smartHttpClient = new JdkSmartHttpClient();
        // new OkHttp3SmartHttpClient();
        // new JoddSmartHttpClient();
        // new ApacheSmartHttpClient(){
            // Перезаписать некоторые методы
        };
        smartHttpClient.setConfig(Config.defaultConfig()...); // Установить baseUrl...
        return smartHttpClient;
    }
}

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());

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());

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`
```java
http.setConfig(Config.defaultConfig()
            .setBaseUrl("https://fanyi.baidu.com/")
            .addDefaultHeader("xx", "xx")
            .setDefaultBodyCharset("UTF-8")
            .setDefaultResultCharset("UTF-8")
            .setDefaultConnectionTimeout(15000)
            .setDefaultReadTimeout(15000)

    //....
   );

@Configuration
public class SomeConfiguration {
    @Bean
    public SmartHttpClient smartHttpClient() {
        Config config = Config.defaultConfig().setBaseUrl("xxxxx");
        JdkSmartHttpClient smartHttpClient = new JdkSmartHttpClient();
        smartHttpClient.setConfig(config);
        return smartHttpClient;
    }

    // Конфигурация для сканирования пакета top.jfunc.network.controller.client
    @Bean
    public HttpServiceCreator httpServiceCreator(SmartHttpClient smartHttpClient) {
        return new HttpServiceCreator().setSmartHttpClient(smartHttpClient);
    }

    @Bean
    public HttpServiceScanConfigure httpServiceScanConfigure() {
        HttpServiceScanConfigure httpServiceScanConfigure = new HttpServiceScanConfigure(httpServiceCreator(smartHttpClient()));
        httpServiceScanConfigure.setAnnotationClassScan(HttpService.class);
        httpServiceScanConfigure.setScanPackages("top.jfunc.network.controller.client");
        return httpServiceScanConfigure;
    }
}

@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);
}
``````markdown
        @GET("get/query")
        Ответ headerMap(@HeaderMap Map<String, String> map);



        @GET("/get/query")
        Ответ загрузка();

        @POST("/post/{id}")
        Ответ отправить(@Path("id") String id, @Body String xx);

        @Multipart
        @POST("/upload/only")
        Ответ загрузить(@Part FormFile... formFiles);
        @Multipart
        @POST("/upload/withParam")
        Ответ загрузить_с_параметрами(@Part("name") String name, @Part("age") int age, @Part FormFile... formFiles);

        @FormUrlEncoded
        @POST("/post/form")
        Ответ форма(@Field("name") String name, @Field("age") int age);
        @FormUrlEncoded
        @POST("/post/form")
        Ответ форма_map(@FieldMap Map<String, String> params);
    }

Проект использует параллельный двойной интерфейсный дизайн, где одна сторона предназначена для реализаторов интерфейсов — **HttpTemplate-SmartHttpTemplate**, это _функциональные интерфейсы_, основные функции которых заключаются в моделировании параметров HTTP и заголовков; другая сторона предназначена для конечных пользователей — **HttpClient-SmartHttpClient**, это _интерфейсы пользователя_. Конкретные реализации классов осуществляются путём реализации двух групп интерфейсов, последний интерфейс вызывает первый интерфейс перед выполнением. Преимущество такого подхода состоит в том, что он обеспечивает независимость между реализациями и пользователями, позволяя бесконечно улучшать реализации **HttpTemplate, SmartHttpTemplate** без существенного влияния на пользователей.

HttpTemplate, HttpClient интерфейсы основаны на методах для моделирования параметров HTTP и заголовков; SmartHttpTemplate наследуется от HttpTemplate, а SmartHttpClient интерфейс наследуется от HttpClient, и они также используют запросы для моделирования параметров HTTP и заголовков, что делает их более удобными для оптимизации и использования.

[Проектирование системы интерфейсов и описание диаграммы классов](https://gitee.com/xxssyyyyssxx/unihttp-all/blob/master/CLASS.md)