jetty-web.xml
is a Jetty configuration file that you can bundle with a specific web
application. The format of jetty-web.xml
is the same as
jetty.xml
– it is an XML mapping of the Jetty API.
This document offers an overview for using the jetty-web.xml
configuration file. For a
more in-depth look at the syntax, see ???.
jetty-web.xml
applies on a per-webapp basis, and configures an instance of
org.eclipse.jetty.webapp.WebAppContext
.
<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure.dtd"> <Configure class="org.eclipse.jetty.webapp.WebAppContext"> .. </Configure>
jetty-web.xml
configures an instance of WebAppContext; jetty.xml
configures an
instance of Server.Place the jetty-web.xml
into your web application's WEB-INF
folder.
When Jetty deploys a web application, it looks for a file called WEB-INF/jetty-web.xml
or
WEB-INF/web-jetty.xml
within the web application (or WAR) and applies the configuration found
there. Be aware that jetty-web.xml
is called after all other
configuration has been applied to the web application.
The distribution contains an example of jetty-web.xml
inside the WEB-INF folder of the
test webapp war ($JETTY_HOME/webapps/test.war/WEB-INF/jetty-web.xml
).