Может кто-нибудь сказать мне, что делает DispatcherType?
Кажется, это важная конфигурация.
Использование класса не помогло мне, указав на такие вещи, как ServletContextHandler # addFilter, который "документирован" с мудрыми словами: convenience method to add a filter.
В общем, любой шанс "понять" недокументированный API-интерфейс Jetty без кода-примера-поиска-забавы или try-and-fail-and-wonder?
Это также параметр в web.xml; и, вероятно, существует уже довольно давно.
http://download.oracle.com/docs/cd/B32110_01/web.1013/b28959/filters.htm#BCFIEDGB
В этом разделе приведено несколько конфигураций образцов, в которых действует действие фильтра вперед или включается цель. Начнем с объявления фильтра, за которым следуют альтернативные конфигурации сопоставления фильтра:
<filter>
<filter-name>myfilter</filter-name>
<filter-class>mypackage.MyFilter</filter-class>
</filter>
Чтобы выполнить MyFilter для фильтрации целевой цели с именем includedservlet:
<filter-mapping>
<filter-name>myfilter</filter-name>
<servlet-name>includedservlet</servlet-name>
<dispatcher>INCLUDE</dispatcher>
</filter-mapping>
Обратите внимание, что вызов include() может поступать из любого сервлета (или другого ресурса) в приложении. Также обратите внимание, что MyFilter не будет выполняться для прямого запроса includeservlet, если у вас нет другого элемента со значением REQUEST.
Выполнять MyFilter для фильтрации любого сервлета, запрошенного напрямую по шаблону URL/mypath/, или выполнить его для фильтрации любой прямой цели, которая вызывается через шаблон URL, начинающийся с "/mypath/":
<filter-mapping>
<filter-name>myfilter</filter-name>
<url-pattern>/mypath/*</url-pattern>
<dispatcher>FORWARD</dispatcher>
<dispatcher>REQUEST</dispatcher>
</filter-mapping>
~~~~~~~~~~~~~~~~~~~~~~
Кроме того, по умолчанию используется запрос; read applyTo (...) метод на следующей странице:
Добавляя к ответу Asad, диспетчер не является специфичным для Jetty, это часть спецификации сервлета до версии 2.5. Вот официальное описание значений диспетчера от web-app_2_5.xsd:
<xsd:complexType name="dispatcherType">
<xsd:annotation>
<xsd:documentation>
The dispatcher has four legal values: FORWARD, REQUEST, INCLUDE,
and ERROR. A value of FORWARD means the Filter will be applied
under RequestDispatcher.forward() calls. A value of REQUEST
means the Filter will be applied under ordinary client calls to
the path or servlet. A value of INCLUDE means the Filter will be
applied under RequestDispatcher.include() calls. A value of
ERROR means the Filter will be applied under the error page
mechanism. The absence of any dispatcher elements in a
filter-mapping indicates a default of applying filters only under
ordinary client calls to the path or servlet.
</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:restriction base="javaee:string">
<xsd:enumeration value="FORWARD"/>
<xsd:enumeration value="INCLUDE"/>
<xsd:enumeration value="REQUEST"/>
<xsd:enumeration value="ERROR"/>
</xsd:restriction>
</xsd:simpleContent>
</xsd:complexType>