Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
xml
xml
<servlet>
    <servlet-name>CXFServlet</servlet-name>
    <display-name>CXF Servlet</display-name>
    <servlet-class>
       org.apache.cxf.transport.servlet.CXFServlet
    </servlet-class>

    <!-- Enable asynchronous requests -->
 
    <async-supported>true</async-supported>

    <load-on-startup>1</load-on-startup> 
</servlet>

Anchor
redirecting
redirecting
Redirecting requests and serving the static content

Starting from CXF 2.2.5 it is possible to configure CXFServlet to redirect current requests to other servlets or serve the static resources.

init-param namedescription
redirects-listspace separated list of URI patterns; if a given request URI matches one of the patterns then CXFServlet will try to find a RequestDispatcher using the pathInfo of the current HTTP request and will redirect the request to it
redirect-servlet-pathcan be used to affect a RequestDispatcher lookup, if specified then it will concatenated with the pathInfo of the current request
redirect-servlet-nameenable a named RequestDispatcher look-up, after one of the URI patterns in the "redirects-list" has matched the current request URI
static-resources-listspace separated list of static resource such as html, css, or pdf files which CXFServlet will serve directly from classpath
static-cache-controlset parameter value to HTTP response Cache-Control header

...

For example, please see this web.xml.

The "http://localhost:9080/the/bookstore1/books/html/123" request URI will initially be matched by the CXFServlet given that it has a more specific URI pattern than the RedirectCXFServlet. After a current URI has reached a jaxrs:server endpoint, the response will be redirected by the JAXRS RequestDispatcherProvider to a "/book.html" address, see "dispatchProvider1" bean here.

...