Интерфейс 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);