HttpUtils

<dependency>
     <groupId>com.ejlchina</groupId>
     <artifactId>httputils</artifactId>
     <version>2.1.0</version>
</dependency>

})
.put();                                                         // **Асинхронный PUT**

**2.4 DELETE**

```java
HttpResult result = http.sync("http://api.demo.com/users/1").delete();  // **Синхронный DELETE**

HttpCall call = http.async("http://api.demo.com/users/1")
    .setOnResponse((HttpResult result) -> {
        
    })
    .delete();                                                      // **Асинхронный DELETE**

http.async("http://api.demo.com/users/1")
    .setOnResponse((HttpResult result) -> {
        // Ответный обратный вызов
    })
    .setOnException((Exception e) -> {
        // Обратный вызов исключения
    })
    .setOnComplete((State state) -> {
        // Завершающий обратный вызов, выполняется независимо от успеха или неудачи
    })
    .get();

String path = "D:/reports/2020-03-01.xlsx"; // Каталог сохранения файлов

// Синхронная загрузка
http.sync("http://api.demo.com/reports/2020-03-01.xlsx")
    .get().getBody().toFile(path);

// Асинхронная загрузка
http.async("http://api.demo.com/reports/2020-03-01.xlsx")
    .setOnResponse((HttpResult result) -> {
        result.getBody().toFile(path);
    })
    .get();

HttpCall call = http.async("http://api.demo.com/users/1").get();

System.out.println(call.isCanceled());   // false

boolean success = call.cancel();   // Отмена запроса

System.out.println(success);             // true
System.out.println(call.isCanceled());   // true

http.sync("http://api.demo.com/orders")
    .addHeader("Token", "xxxxxx")
    .addHeader("Accept", "application/json")
    .get();

Map<String, String> headers = new HashMap<>()
headers.put("Token", "xxxxxx");
headers.put("Accept", "application/json");

http.sync("http://api.demo.com/orders")
    .addHeader(headers)
    .get();

http.sync("http://api.demo.com/shops/{shopName}/products/{productId}")
    .addPathParam("shopName", "taobao")
    .addPathParam("productId", 20)
    .get();

Map<String, String> params = new HashMap<>()
params.put("shopName", "taobao");
params.put("productId", 20);
``` **Добавление параметров в запросы**

В запросах могут использоваться различные параметры, которые добавляются к URL разными способами.

1. **Параметры запроса (URL-параметры)** используются для добавления параметров после строки запроса URL. Они могут быть добавлены как синхронно, так и асинхронно:

    * Синхронное добавление:

        ```java
        http.sync("http://api.demo.com/shops/{shopName}/products/{productId}")
                .addPathParam(params)
                .get();
        ```

    * Асинхронное добавление: аналогично.

2. **Параметры формы (Body-параметры)** передаются с запросом в теле сообщения. Они также могут быть добавлены синхронно или асинхронно:

     * Синхронное добавление:

         ```java
         http.sync("http://api.demo.com/signin")
                 .addBodyParam("username", "Jackson")
                 .addBodyParam("password", "xxxxxx")
                 .post();
         ```

     ```java
     Map<String, String> params = new HashMap<>();
     params.put("username", "Jackson");
     params.put("password", "xxxxxx");

     http.sync("http://api.demo.com/signin")
             .addBodyParam(params)
             .post();
         ```

3. **JSON-параметры** передаются в виде строки JSON в теле запроса. Их можно добавить синхронно или асинхронно:

      * Синхронное добавление:

          ```java
          http.sync("http://api.demo.com/signin")
                  .addJsonParam("username", "Jackson")
                  .addJsonParam("password", "xxxxxx")
                  .post();
          ```

       ```java
       Map<String, Object> params = new HashMap<>();
       params.put("username", "Jackson");
       params.put("password", "xxxxxx");

       http.sync("http://api.demo.com/signin")
               .addJsonParam(params)
               .post();
           ```

4. **Установка JSON-строки**:

      ```java
      http.sync("http://api.demo.com/signin")
              .setRequestJson("\"username\":\"Jackson\",\"password\":\"xxxxxx\"")
              .post();
      ```

5. **Преобразование JavaBean в JSON**:

      ```java
      Login login = new Login();
      login.setUsername("Jackson");
      login.setPassword("xxxxxx");

      http.sync("http://api.demo.com/signin")
              .setRequestJson(login)
              .post();
      ```

6. **Файл-параметры**:

   * **Загрузка локальных файлов**:

       ```java
       File file1 = new File("D:/1.jpg");
       File file2 = new File("D:/2.jpg");

       http.sync("http://api.demo.com/upload")
               .addFileParam("image1", file1)
               .addFileParam("image2", file2)
               .post();
       ```

   * **Использование потока ввода файла**:

       ```java
       // Получение потока ввода файла
       InputStream input = ...

       http.sync("http://api.demo.com/upload")
               .addFileParam("image", "jpg", input)
               .post();
       ```

   * **Использование массива байтов файла**:

       ```java
       // Получение массива байтов файла
       byte[] content = ...

       http.sync("http://api.demo.com/upload")
               .addFileParam("image", "jpg", content)
               .post();
       ```

7. **Совместное использование параметров формы и файл-параметров**:

    ```java
    File file = new File("D:/首页广告.jpg");

    http.sync("http://api.demo.com/messages")
            .addBodyParam("name", "广告图")
            .addFileParam("image", file)
            .post();
    ```

8. **Метки**:

    Иногда необходимо классифицировать HTTP-задачи. Для этого используются метки:

    ```java
    http.async("http://api.demo.com/users")     //（1）
            .setTag("A")
            .get();

    http.async("http://api.demo.com/users")     //（2）
            .setTag("A.B")
            .get();

    http.async("http://api.demo.com/users")     //（3）
            .setTag("B")
            .get();

    http.async("http://api.demo.com/users")     //（4）
            .setTag("B.C")
            .get();

    http.async("http://api.demo.com/users")     //（5）
            .setTag("C")
            .get();
    ```

9. **Отмена задач по меткам**:

    Только асинхронные задачи могут быть отменены. Метка может использоваться не только для отмены задач, но и в препроцессорах. **Как изменить поток выполнения обратного вызова функции и как настроить обратный вызов-исполнитель**

Чтобы изменить поток выполнения для обратного вызова функции, можно настроить обратный вызов-исполнитель. Например, в Android, чтобы все обратные вызовы выполнялись в потоке пользовательского интерфейса (UI), можно выполнить следующую конфигурацию при создании HTTP:
```java
HTTP http = HTTP.builder()
        .callbackExecutor((Runnable run) -> {
            runOnUiThread(run);             // Выполнить в UI потоке
        })
        .build();

HTTP http = HTTP.builder()
    .config((Builder builder) -> {
        // Настройка пула соединений: минимум 10 соединений (по умолчанию 5)
        builder.connectionPool(new ConnectionPool(10, 5, TimeUnit.MINUTES));
        // Настройка времени ожидания соединения
        builder.connectTimeout(20, TimeUnit.SECONDS);
        // Добавление перехватчика
        builder.addInterceptor((Chain chain) -> {
            Request request = chain.request();
            // Необходимо вернуть результат синхронно, перехватчики не могут выполнять асинхронные операции
            return chain.proceed(request);
        });
        // Другие настройки: SSL, кэш, прокси, события и т.д.
    })
    .build();

HTTP http = HTTP.builder()
        .addPreprocessor((Process process) -> {
            HttpTask<?> task = process.getTask();       // Получить текущую задачу HTTP
            if (!task.tagMatched("Auth")) {             // Проверить, нужна ли задача токена
                return;
            }
            requestToken((String token) -> {            // Асинхронное получение токена
                task.addHeader("Token", token);         // Добавить токен в заголовок задачи
                process.proceed();                      // Продолжить текущую задачу
            }); 
        })
        .build();

HTTP http = HTTP.builder()
        .addSerialPreprocessor((Process process) -> {
            HttpTask<?> task = process.getTask();       // Получить текущую задачу HTTP
            if (!task.tagMatched("Auth")) {             // Проверить, нужна ли задаче токен
                return;
            }
            // Проверить срок действия, обновить при необходимости
            requestTokenAndRefreshIfExpired((String token) -> {
                task.addHeader("Token", token);         // Добавить токен в заголовок задачи
                process.proceed();                      // Вызов этого метода не позволит другим задачам войти в этот обработчик
            }); 
        })
        .build();