Skip to main content

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.

Jump to: navigation, search

Jetty/Reference/jetty.xml

< Jetty‎ | Reference
Revision as of 01:26, 8 February 2010 by Gregw.webtide.com (Talk | contribs)



Introduction

jetty.xml is the default configuration file for Jetty, typically located at $JETTY_HOME/etc/jetty.xml. Typically the jetty.xml will configure:

  • 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

Because Jetty has many options, not all of them are configured in jetty.xml and there are several optional configuration files that share the same format of jetty.xml and are essentially concatenated to it (if specified). These configuration files are also stored in $JETTY_HOME/etc/ and examples of them may be found 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

Back to the top