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

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

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

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