Класс Filter

protected Filter()

public abstract void doFilter(HttpExchange exchange, Filter.Chain chain) throws IOException

Параметры:

exchange — HttpExchange, который необходимо отфильтровать

chain — Chain, позволяющий вызвать следующий фильтр

Вызывает исключение:

IOException — может быть выброшено любым модулем фильтра и, если перехвачено, должно быть выброшено повторно

NullPointerException — если exchange или chain равны null

public abstract String description()

Возвращает:

String, описывающую Filter

public static Filter beforeHandler(String description, Consumer<HttpExchange> operation)

Примечание API:

Фильтр beforeHandler обычно используется для проверки или изменения состояния обмена до его обработки. operation фильтра выполняется до вызова Filter.Chain.doFilter(HttpExchange), то есть до выполнения последующих фильтров в цепочке и обработчика обмена. Предполагается, что operation фильтра не будет обрабатывать запрос или отправлять заголовки ответа, поскольку обычно это делает обработчик обмена.

Пример добавления заголовка ответа "Foo" ко всем ответам:

    var filter = Filter.beforeHandler("Add response header Foo",
                e -> e.getResponseHeaders().set("Foo", "Bar"));
    httpContext.getFilters().add(filter);

Параметры:

description — строка, возвращаемая методом description()

operation — операция возвращаемого фильтра

Возвращает:

фильтр, операция которого вызывается до обработки обмена

Вызывает исключение:

NullPointerException — если какой-либо аргумент равен null

Начиная с:

17

public static Filter afterHandler(String description, Consumer<HttpExchange> operation)

Примечание API:

Фильтр afterHandler обычно используется для проверки состояния обмена, а не его изменения. operation фильтра выполняется после вызова Filter.Chain.doFilter(HttpExchange), то есть после выполнения всех последующих фильтров в цепочке и обработчика обмена. Предполагается, что operation фильтра не будет обрабатывать обмен или отправлять заголовки ответа. Скорее всего, это приведет к сбою, поскольку обмен обычно уже обработан к моменту вызова operation. В частности, ответ может быть отправлен до выполнения operation фильтра.

Пример добавления фильтра, который регистрирует код ответа всех обменов:

    var filter = Filter.afterHandler("Log response code", e -> log(e.getResponseCode());
    httpContext.getFilters().add(filter);

Пример добавления последовательности фильтров afterHandler в контекст:
Операции фильтров вызываются в порядке, обратном порядку добавления фильтров в список фильтров контекста.

    var a1Set = Filter.afterHandler("Set a1", e -> e.setAttribute("a1", "some value"));
    var a1Get = Filter.afterHandler("Get a1", e -> doSomething(e.getAttribute("a1")));
    httpContext.getFilters().addAll(List.of(a1Get, a1Set));

Операция a1Get будет вызвана после операции a1Set, поскольку a1Get был добавлен перед a1Set.

Параметры:

description — строка, возвращаемая методом description()

operation — операция возвращаемого фильтра

Возвращает:

фильтр, операция которого вызывается после обработки обмена

Вызывает исключение:

NullPointerException — если какой-либо аргумент равен null

Начиная с:

17

public static Filter adaptRequest(String description, UnaryOperator<Request> requestOperator)

Примечание API:

При вызове возвращаемого фильтра он сначала вызывает requestOperator с заданным обменом, ex, чтобы получить адаптированное состояние запроса. Затем он вызывает следующий фильтр в цепочке или обработчик обмена, передавая обмен, эквивалентный ex, в котором адаптированное состояние запроса задано как эффективное состояние запроса.

Пример добавления заголовка запроса "Foo" ко всем запросам:

    var filter = Filter.adaptRequest("Add Foo header", r -> r.with("Foo", List.of("Bar")));
    httpContext.getFilters().add(filter);

Параметры:

description — строка, возвращаемая методом description()

requestOperator — оператор запроса

Возвращает:

фильтр, адаптирующий состояние запроса до обработки обмена

Вызывает исключение:

NullPointerException — если какой-либо аргумент равен null

Начиная с:

18