Contact the core Jetty developers at www.webtide.com
private support for your internal/customer projects ... custom extensions and distributions ... versioned snapshots for indefinite support ... scalability guidance for your apps and Ajax/Comet projects ... development services from 1 day to full product delivery

Chapter 25. Reference Section

Table of Contents

jetty.xml
jetty-web.xml
jetty-env.xml
Jetty XML Usage

jetty.xml

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 and max thread).

  • Connectors (ports, timeouts, buffer sizes, protocol).

  • The handler structure (default handlers and/or a contextHandlerCollections).

  • The deployment manager that scans for and deploys webapps and contexts.

  • Login services that provide 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 Repository. The selection of which configuration files to use is controlled by Start Features 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

  • ??? –In-depth reference for Jetty-specific configuration XML syntax.
  • ??? –Configuration file for configuring a specific webapp.
See an error or something missing?
Contribute to this documentation at Github!