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

void applyPushPromise(HttpRequest initiatingRequest, HttpRequest pushPromiseRequest, Function<HttpResponse.BodyHandler<T>,CompletableFuture<HttpResponse<T>>> acceptor)

Уведомление о входящем запросе о подтверждении.

Этот метод вызывается один раз для каждого полученного запроса о подтверждении, до момента, когда тело ответа на начальный запрос клиента будет полностью получено.

Запрос о подтверждении принимается вызовом заданной acceptor функции. Функция acceptor должна принять непустую BodyHandler, которая будет использоваться для обработки тела ответа на запрос. Функция-акцептор вернет CompletableFuture, который завершит работу с ответом на запрос.

Если функция acceptor не вызвана успешно, то запрос о подтверждении отклоняется. Функция acceptor бросит исключение IllegalStateException если вызвана более одного раза.

static <T> HttpResponse.PushPromiseHandler<T> of(Function<HttpRequest,HttpResponse.BodyHandler<T>> pushPromiseHandler, ConcurrentMap<HttpRequest,CompletableFuture<HttpResponse<T>>> pushPromisesMap)

Возвращает обработчик запросов о подтверждении, который накапливает запросы о подтверждении и их ответы в заданной карте.

Элементы добавляются в заданную карту для каждого принятого запроса о подтверждении. Ключ элемента — запрос подтверждения, а значение — CompletableFuture , который завершает работу с ответом, соответствующим запросу подтверждения. Запрос подтверждения отклоняется/отменяется, если в карте уже есть запись, ключ которой равен ему. Запрос подтверждения отклоняется/отменяется, если у него нет того же происхождения, что и у начального запроса.

Элементы добавляются в заданную карту как можно быстрее при получении и принятии запроса подтверждения. Таким образом, код, использующий такую карту как кэш, может определить, был ли запрос подтверждения отправлен сервером, и избежать, возможно, ненужных запросов.

Доставка ответа на запрос подтверждения не координируется с доставкой ответа на начальный запрос клиента. Однако, когда тело ответа на начальный запрос клиента будет полностью получено, карта гарантированно будет полностью заполнена, то есть больше записей добавляться не будет. Индивидуальные CompletableFutures в карте могут или могут не быть завершены на этом этапе.