Jetty：权威参考

Table of Contents

• Getting Started With Jetty
• Introducing Jetty
  • What is Jetty?
  • What Version Do I Use?
  • Jetty and Java EE Web Profile
  • Finding Jetty in Maven
• Using Jetty
  • Downloading Jetty
  • Running Jetty
  • Common Jetty Configuration
  • Deploying Web Applications
• An Introduction to Jetty Configuration
  • How to Configure Jetty
  • What to Configure in Jetty
• Jetty Configuration Guide
• Deploying to Jetty
  • Anatomy of a Web Application
  • Automatic Web Application Deployment
  • Configuring a Specific Web Application Deployment
  • Deployment Processing of WebAppContexts
  • Configuring Static Content Deployment
  • Hot Deployment
  • Deployment Architecture
  • Quickstart Webapps
• Configuring Contexts
  • Setting a Context Path
  • Configuring Virtual Hosts
  • Temporary Directories
  • Serving a WebApp from a Particular Port/Connector
  • Creating Custom Error Pages
  • Setting Max Form Size
• Configuring Jetty Connectors
  • Connector Configuration Overview
  • Configuring SSL/TLS
  • SSL in the Jetty Distribution
• Configuring Security
  • Authentication and Authorization
  • Limiting Form Content
  • Aliased Files and Symbolic links
  • Secure Password Obfuscation
  • Setting Port 80 Access for a Non-Root User
  • JAAS Support
  • SPNEGO Support
  • OpenID Support
• Configuring JSP Support
  • Configuring JSP
• Jetty Administration Guide
• Starting Jetty
  • Startup Overview
  • Using start.jar
  • Managing Jetty Base and Jetty Home
  • Managing Server Classpath
  • Managing Startup Modules
  • Custom Modules
  • Managing XML Based Startup Configuration
  • Startup a Unix Service using jetty.sh
  • Startup via Windows Service
  • Startup using the Java Platform Module System (JPMS)
• Session Management
  • Session Architecture
  • Session Components
  • The SessionIdManager and the Housekeeper
  • The L1 Session Cache
  • Non-Persistent Sessions
  • Persistent Sessions: File System
  • Persistent Sessions: JDBC
  • Persistent Sessions: MongoDB
  • Persistent Sessions: Inifinspan
  • Persistent Sessions: Hazelcast
  • Persistent Sessions: Google Cloud DataStore
  • Persistent Sessions: The L2 Session Data Cache
  • Session Use Cases
• Jetty Logging
  • Configuring Jetty Logging
  • Default Logging with Jetty’s StdErrLog
  • Configuring Jetty Request Logs
  • Jetty Logging Integrations (SLF4J, Log4j, Logback, JCL, JUL)
  • Centralized Logging using Logback
  • Jetty Server Dump
• Configuring JNDI
  • Quick Setup
  • Working with Jetty JNDI
  • Configuring JNDI
  • Using JNDI with Jetty Embedded
  • Datasource Examples
• Annotations
  • Quick Setup
  • Working with Annotations
  • Using Annotations with Jetty Embedded
• Java Management Extensions (JMX)
  • Using JMX with Jetty
  • Jetty JMX Annotations
  • Managing Jetty with JConsole and JMC
• Application Layer Protocol Negotiation (ALPN)
  • Introducing ALPN
• HTTP/2
  • Introducing HTTP/2
  • Enabling HTTP/2
  • Configuring HTTP/2
  • Configuring HTTP/2 Push
  • Configuring HAProxy and Jetty
• FastCGI Support
  • FastCGI Introduction
  • Configuring Jetty for FastCGI
• Provided Servlets, Filters, and Handlers
  • Default Servlet
  • Proxy Servlet
  • Balancer Servlet
  • CGI Servlet
  • Quality of Service Filter
  • Denial of Service Filter
  • Header Filter
  • Gzip Handler
  • Cross Origin Filter
  • Resource Handler
  • Debug Handler
  • Statistics Handler
  • IP Access Handler
  • Moved Context Handler
  • Shutdown Handler
  • Default Handler
  • Error Handler
  • Rewrite Handler
• Jetty Runner
  • Use Jetty Without an Installed Distribution
• Optimizing Jetty
  • Garbage Collection
  • High Load
  • Limiting Load
• Jetty Development Guide
• Embedding
  • Jetty Embedded HelloWorld
  • Embedding Jetty
  • Embedded Examples
• HTTP Client
  • Introduction
  • API Usage
  • Cookies Support
  • Authentication Support
  • Proxy Support
  • Pluggable Transports
• Maven and Jetty
  • Using Maven
  • Configuring the Jetty Maven Plugin
  • Files Scanned by the Jetty Maven Plugin
  • Jetty Jspc Maven Plugin
• Ant and Jetty
  • Ant Jetty Plugin
• Handlers
  • Writing Custom Handlers
• WebSocket Introduction
  • What Jetty provides
  • WebSocket APIs
  • Enabling WebSocket
• Jetty Websocket API
  • Jetty WebSocket API Usage
  • WebSocket Events
  • WebSocket Session
  • Send Messages to Remote Endpoint
  • Using WebSocket Annotations
  • Using WebSocketListener
  • Using the WebSocketAdapter
  • Jetty WebSocket Server API
  • Jetty WebSocket Client API
• Continuations
  • Introduction
  • Using Continuations
  • Common Continuation Patterns
• Frameworks
  • CDI
  • Weld
  • Spring Setup
  • OSGI
  • Metro
• Jetty Reference Guide
• Architecture
  • Jetty Architecture
  • Jetty Classloading
  • Managing 1xx Responses
  • Creating a Custom Protocol
• Platforms, Stacks and Alternative Distributions
  • Many many options…​
  • Jelastic
  • CloudFoundry
  • Amazon Elastic Beanstalk
  • Fedora
  • Ubuntu
• Jetty XML Reference
  • Jetty XML Syntax
  • Jetty XML Usage
  • jetty.xml
  • jetty-web.xml
  • jetty-env.xml
  • webdefault.xml
  • Jetty override-web.xml
• Troubleshooting
  • Troubleshooting Zip Exceptions
  • Troubleshooting Locked Files on Windows
  • Preventing Memory Leaks
  • Troubleshooting Slow Deployment
  • Jetty Security Reports
  • Java WatchService
• Debugging
  • Options
  • Enable remote debugging
  • Debugging With IntelliJ
  • Debugging With Eclipse
• Contributing to Jetty
  • Community
  • Documentation
  • Source Control and Building
  • Coding Standards
  • Issues, Features, and Bugs
  • Contributing Patches
  • Releasing Jetty
  • Testing a Jetty Release
• Upgrading Jetty
  • Upgrading from Jetty 9.3.x to Jetty 9.4.0

Getting Started With Jetty

Introducing Jetty

What is Jetty?

Jetty is an open-source project providing an HTTP server, HTTP client, and javax.servlet container.

This guide is broken up in to five parts:

• The first section emphasizes beginning to use Jetty. It provides information about what Jetty is and where you can download it, and where to find Jetty in repositories like Central Maven. It also provides a Quick Start guide on how to get Jetty up and running as well as an overview of how and what to configure in Jetty.
• The second section of the guide deals with configuring Jetty at a more granular level. It explains how to use Jetty to deploy web applications, configure contexts and connects, and how to implement SSL and other security measures.
• Administration of Jetty is the focus of the third section of the guide. From server startup to session management, logging, HTTP/2 support and Jetty optimization, these chapters will help administrators get the most out of their Jetty server instances. This section also covers configuring many of the most common servlet container features such as JNDI and JMX.
• Aimed at advanced users of Jetty, the fourth section of the guide focuses on Jetty development. A large portion of this section is focused on using Jetty as an embedded server in existing applications. It contains several examples and how-to guides for making the most out of the Jetty framework. This section also includes a guide on using the Jetty Maven plugin as well as information on debugging Jetty.
• The final section of the guide is a reference section. Included there are guides on Jetty architecture and Jetty XML syntax, alternate distributions of Jetty and even troubleshooting of common issues. There is also a chapter on getting involved in the Jetty community including information on how to contribute code and how to find help.

Feedback is always welcome! Additionally, if you are interested in how to contribute to the open source project there is a section on that as well!

What Version Do I Use?

Jetty 9 is the most recent version of Jetty and has a great many improvements over previous versions. This documentation which focuses on Jetty 9. While many people continue to use older versions of Jetty, we generally recommend using Jetty 9 as it represents the version of Jetty that we will actively maintain and improve over the next few years.

Table 1. Jetty Versions
Version		Year	Home	Min JVM	Protocols	Servlet	JSP		Status
	It is important that only stable releases are used in production environments. Versions that have been deprecated or are released as Milestones (M) or Release Candidates (RC) are not suitable for production as they may contain security flaws or incomplete/non-functioning feature sets.
11		2020-	Eclipse	11 (2)	HTTP/1.1 (RFC 7230), HTTP/2 (RFC 7540), WebSocket (RFC 6455, JSR 356), FastCGI, JakartaEE Namespace(1)	5.0.0	3.0.0		Stable
10		2019-	Eclipse	11 (2)	HTTP/1.1 (RFC 7230), HTTP/2 (RFC 7540), WebSocket (RFC 6455, JSR 356), FastCGI	4.0.1	2.2		Stable
9.4		2016-	Eclipse	1.8	HTTP/1.1 (RFC 7230), HTTP/2 (RFC 7540), WebSocket (RFC 6455, JSR 356), FastCGI	3.1	2.3		Stable
9.3		2015-	Eclipse	1.8 (3)	HTTP/1.1 (RFC 7230), HTTP/2 (RFC 7540), WebSocket (RFC 6455, JSR 356), FastCGI	3.1	2.3		Deprecated / End of Life December 2020
9.2		2014-2018	Eclipse	1.7 (3)	HTTP/1.1 RFC2616, javax.websocket, SPDY v3	3.1	2.3		Deprecated / End of Life January 2018
9.1		2013-2014	Eclipse	1.7 (3)	HTTP/1.1 RFC2616	3.1	2.3		Deprecated / End of Life May 2014
9.0		2013-2013	Eclipse	1.7 (3)	HTTP/1.1 RFC2616	3.1-beta	2.3		Deprecated / End of Life November 2013
8		2009-2014	Eclipse/Codehaus	1.6 (3)	HTTP/1.1 RFC2616, WebSocket RFC 6455, SPDY v3	3.0	2.2		Deprecated / End of Life November 2014
7		2008-2014	Eclipse/Codehaus	1.5	HTTP/1.1 RFC2616, WebSocket RFC 6455, SPDY v3	2.5	2.1		Deprecated / End of Life November 2014
6		2006-2010	Codehaus	1.4-1.5	HTTP/1.1 RFC2616	2.5	2.0		Deprecated / End of Life November 2010
5		2003-2009	Sourceforge	1.2-1.5	HTTP/1.1 RFC2616	2.4	2.0		Antique
4		2001-2006	Sourceforge	1.2, J2ME	HTTP/1.1 RFC2616	2.3	1.2		Ancient
3		1999-2002	Sourceforge	1.2	HTTP/1.1 RFC2068	2.2	1.1		Fossilized
2		1998-2000	Mortbay	1.1	HTTP/1.0 RFC1945	2.1	1.0		Legendary
1		1995-1998	Mortbay	1.0	HTTP/1.0 RFC1945	-	-		Mythical

1. Due to Oracle’s ownership of the "Java" trademark, usage of the javax.* namespace has been restricted and the jakarta.* namespace was adopted by the Eclipse Foundation.
2. JPMS module support is optional
3. JDK9 and newer is not supported if using MultiRelease JAR Files, or Bytecode / Annotation scanning.