Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Jetty/Reference/jetty.xml"
m |
|||
| Line 1: | Line 1: | ||
{{Jetty Reference | {{Jetty Reference | ||
| − | | introduction = <tt>jetty.xml</tt> is the default configuration file for Jetty, typically located at <tt>$JETTY_HOME/etc/jetty.xml</tt>. | + | | introduction = <tt>jetty.xml</tt> is the default configuration file for Jetty, typically located at <tt>$JETTY_HOME/etc/jetty.xml</tt>. Usually the jetty.xml configures: |
* the Server class (or subclass if extended) and global options | * the Server class (or subclass if extended) and global options | ||
* a ThreadPool (min & max thread) | * a ThreadPool (min & max thread) | ||
| − | * connectors (ports, timeouts, buffer sizes, protocol etc.) | + | * connectors (ports, timeouts, buffer sizes, protocol, etc.) |
| − | * the handler structure (default handlers and/or a contextHandlerCollections etc.) | + | * the handler structure (default handlers and/or a contextHandlerCollections, etc.) |
* the deployment manager that scans for and deploys webapps and contexts | * the deployment manager that scans for and deploys webapps and contexts | ||
| − | * login services that provides authentication checking | + | * login services that provides authentication checking |
* a request log | * a request log | ||
| − | + | Not all Jetty features are configured in <tt>jetty.xml</tt>. There are several optional configuration files that share the same format as <tt>jetty.xml</tt> and, if specified, concatenate to it. These configuration files are also stored in <tt>$JETTY_HOME/etc/</tt>, and examples of them are in [http://dev.eclipse.org/svnroot/rt/org.eclipse.jetty/jetty/trunk/jetty-server/src/main/config/etc/ svn]. The selection of which configuration files to use is controlled by [[Jetty/Feature/Start.jar|start.jar]] and the process of merging configuration is described in [[Jetty/Reference/jetty.xml_usage|jetty.xml usage]]. | |
| − | + | ||
| body = | | body = | ||
| Line 31: | Line 30: | ||
| more = | | more = | ||
| − | * [[Jetty/Tutorial/jetty.xml|jetty.xml Tutorial]] | + | * [[Jetty/Tutorial/jetty.xml|jetty.xml Tutorial]]–detailed tutorial that walks you through writing your own version of jetty.xml |
| − | * [[Jetty/Reference/jetty.xml syntax|jetty.xml Syntax Reference]] | + | * [[Jetty/Reference/jetty.xml syntax|jetty.xml Syntax Reference]]–in-depth reference for Jetty-specific configuration XML syntax |
| − | * [[Jetty/Reference/jetty-web.xml|jetty-web.xml]] | + | * [[Jetty/Reference/jetty-web.xml|jetty-web.xml]]–configuration file for configuring a specific webapp |
}} | }} | ||
Revision as of 16:27, 18 August 2010
Introduction
jetty.xml is the default configuration file for Jetty, typically located at $JETTY_HOME/etc/jetty.xml. Usually the jetty.xml configures:
- the Server class (or subclass if extended) and global options
- a ThreadPool (min & max thread)
- connectors (ports, timeouts, buffer sizes, protocol, etc.)
- the handler structure (default handlers and/or a contextHandlerCollections, etc.)
- the deployment manager that scans for and deploys webapps and contexts
- login services that provides authentication checking
- a request log
Not all Jetty features are configured in jetty.xml. There are several optional configuration files that share the same format as jetty.xml and, if specified, concatenate to it. These configuration files are also stored in $JETTY_HOME/etc/, and examples of them are in svn. The selection of which configuration files to use is controlled by start.jar and the process of merging configuration is described in jetty.xml usage.
Root Element
jetty.xml configures an instance of the Jetty org.eclipse.jetty.server.Server.
<?xml version="1.0"?> <!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http://www.eclipse.org/jetty/configure.dtd"> <Configure id="Server" class="org.eclipse.jetty.server.Server"> ... </Configure>
Examples
$JETTY_HOME/etc contains the default jetty.xml, as well as other sample configuration files (jetty-*.xml) which can be passed to the server via the command line.
Additional Resources
- jetty.xml Tutorial–detailed tutorial that walks you through writing your own version of jetty.xml
- jetty.xml Syntax Reference–in-depth reference for Jetty-specific configuration XML syntax
- jetty-web.xml–configuration file for configuring a specific webapp