Configuring Jetty

Overview

Jetty is configured by dependency injection into the Jetty components. The root component of Jetty is Server, on which you can set an array of Connector instances and an array of Handler instances. Each specific type of connector and handler will have it's own setters and getters for configuration.

A Typical Configuration

• The JVM will have a single instance of Server
• The Server will have a single Connector instance, probably a SelectChannelConnector.
• The Connector will have a port set on it.
• The Server will have one or more handlers. Typically these will be instances of ContextHandler that wrap other Handler instances for a given context path.
• The ContextHandler will be configured with a contextPath and wrapped handler for the context.
• The ContextHandler may be configured with ResourceBase, ClassLoader, VirtualHosts, etc.
• The ContextHandler may be an instance of WebAppContext which configures itself from the WEB-INF/web.xml file found within the configured ResourceBase and will contain a SessionHandler, which will contain a SecurityHandler, which will container a ServletHandler
• The ContextHandler may contain a ServletHandler, which will contain:
  • FilterHolders
  • FilterMappings
  • ServletHolders
  • ServletMappings

All these components have setters and getters for configuration. These may be configured by:

• Directly calling the API in a java program - see Embedding Jetty
• Calling the API via Jetty XML - see jetty.xml, jetty-web.xml, jetty-env.xml
• Calling the bean-style API via a framework such as spring or xbeans - see XBean with Jetty