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