Класс HttpClient

public abstract class HttpClient
extends Object

Клиент HTTP.

Объект типа HttpClient может быть использован для отправки запросов и получения их ответов. Объект HttpClient создается с помощью builder. Построитель может быть использован для конфигурации состояния клиента, например: предпочтительной версии протокола (HTTP/1.1 или HTTP/2), следования редиректам, прокси, аутентификатора и т. д. После создания объект HttpClient является неизменяемым и может быть использован для отправки нескольких запросов.

Объект HttpClient предоставляет информацию о конфигурации и совместное использование ресурсов для всех запросов, отправленных через него.

Обработчик тела ответа BodyHandler должен быть предоставлен для каждого отправляемого HttpRequest. BodyHandler определяет, как обрабатывать тело ответа, если оно есть. После получения HttpResponse, доступны заголовки, код ответа и тело (как правило). Прочитаны ли байты тела ответа или нет зависит от типа T, тела ответа.

Запросы могут быть отправлены синхронно или асинхронно:

• send(HttpRequest, BodyHandler) блокируется, пока запрос не будет отправлен, а ответ не будет получен.
• sendAsync(HttpRequest, BodyHandler) отправляет запрос и получает ответ асинхронно. Метод sendAsync возвращает сразу же с CompletableFuture<HttpResponse>. CompletableFuture завершается, когда ответ становится доступным. Возвращаемое значение CompletableFuture может быть комбинировано различными способами для объявления зависимостей между несколькими асинхронными задачами.

Синхронный пример

HttpClient client = HttpClient.newBuilder()
        .version(Version.HTTP_1_1)
        .followRedirects(Redirect.NORMAL)
        .connectTimeout(Duration.ofSeconds(20))
        .proxy(ProxySelector.of(new InetSocketAddress("proxy.example.com", 80)))
        .authenticator(Authenticator.getDefault())
        .build();
   HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
   System.out.println(response.statusCode());
   System.out.println(response.body());

Асинхронный пример

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://foo.com/"))
        .timeout(Duration.ofMinutes(2))
        .header("Content-Type", "application/json")
        .POST(BodyPublishers.ofFile(Paths.get("file.json")))
        .build();
   client.sendAsync(request, BodyHandlers.ofString())
        .thenApply(HttpResponse::body)
        .thenAccept(System.out::println);

Проверка безопасности

Если менеджер безопасности присутствует, проверки безопасности выполняются методами отправки HTTP-клиента. Для доступа к целевому серверу и прокси-серверу (если он настроен) требуется соответствующее URLPermission. Форма URLPermission необходимая для доступа к прокси, имеет параметр method со значением "CONNECT" (для всех типов проксирования) и строку URL вида "socket://host:port", где хост и порт указывают адрес прокси-сервера.