Интерфейс HttpResponse.BodyHandler<T>

@FunctionalInterface
public static interface HttpResponse.BodyHandler<T>

Обработчик тела ответа. Класс BodyHandlers предоставляет реализации многих распространённых обработчиков тела.

Интерфейс BodyHandler позволяет проверить код ответа и заголовки до получения фактического тела ответа и отвечает за создание подписчика ответа BodySubscriber. Интерфейс BodySubscriber потребляет фактические байты тела ответа и, как правило, преобразует их в тип Java более высокого уровня.

BodyHandler — это функция, которая принимает объект ResponseInfo и возвращает BodySubscriber. BodyHandler вызывается, когда код состояния и заголовки ответа доступны, но перед получением байтов тела ответа.

Следующий пример использует один из предопределённых обработчиков тела предопределённых обработчиков тела, который всегда обрабатывает тело ответа одинаковым способом (потоком тела ответа в файл).

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("http://www.foo.com/"))
        .build();
  client.sendAsync(request, BodyHandlers.ofFile(Paths.get("/tmp/f")))
        .thenApply(HttpResponse::body)
        .thenAccept(System.out::println);

Обратите внимание, что даже если предопределённые обработчики не проверяют код состояния ответа, код состояния ответа и заголовки всегда доступны в HttpResponse, когда он возвращается.

Во втором примере функция возвращает другого подписчика в зависимости от кода состояния.

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("http://www.foo.com/"))
        .build();
  BodyHandler<Path> bodyHandler = (rspInfo) -> rspInfo.statusCode() == 200
                      ? BodySubscribers.ofFile(Paths.get("/tmp/f"))
                      : BodySubscribers.replacing(Paths.get("/NULL"));
  client.sendAsync(request, bodyHandler)
        .thenApply(HttpResponse::body)
        .thenAccept(System.out::println);

HttpResponse.BodySubscriber<T> apply(HttpResponse.ResponseInfo responseInfo)