Класс Filter

Фильтр

protected Filter()

doFilter

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

Параметры:

exchange - обмениваемый HttpExchange

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

Исключения:

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

NullPointerException - если обмен или цепочка null

description

public abstract String description()

Возвращает:

описание String Filter

beforeHandler

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

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

Фильтр перед обработчиком обычно используется для просмотра или изменения состояния обмена перед его обработкой. Фильтр 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

afterHandler

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

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

Фильтр после обработчика обычно используется для просмотра состояния обмена, а не для его изменения. Фильтр 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

adaptRequest

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