Jetty Documentation

The documentation provided here applies to only old versions of Jetty.

Jetty Documentation

• jetty @ Codehaus
  • Jetty <= 6 @ codehaus
  • Jetty <= 6 wiki @ codehaus
  • Jetty Hightide - deprecated
  • Jetty Powered
  • About Jetty

• jetty @ Eclipse
  • Jetty >= 7 @ eclipse
  • Jetty >= 7 wiki @ eclipse
  • Jetty >= 7 @ eclipse

Getting Started

• Downloading Jetty
• Installing Jetty-6.1.x
• Running Jetty-6.1.x
  • Windows Service Wrapper
  • Debian Packages
  • RPMs
• Supported JVMs

References

• Jetty Architecture
• Jetty Xml Configuration Syntax Reference
• Javadoc
• xref
• Walkthrough: jetty.xml
• Jetty Security

Tutorials

• Newbie Guide to Jetty
• Writing a Jetty Handler
• Embedding Jetty
• Porting to Jetty6jetty6
• Porting to Jetty7 from Jetty6
• Getting Started with Jetty on www.itjungle.com

Development

• Contributing
• Jetty Coding Standards
• GIT:
  • jetty @ codehaus
    • git://git.codehaus.org/jetty-project.git
    • Browse: http://git.codehaus.org/gitweb.cgi?p=jetty-project.git
  • jetty @ eclipse
    • git://git.eclipse.org/gitroot/jetty/org.eclipse.jetty.project.git
    • ssh://git.eclipse.org/gitroot/jetty/org.eclipse.jetty.project.git
    • http://git.eclipse.org/gitroot/jetty/org.eclipse.jetty.project.git
    • Browse: http://git.eclipse.org/c/jetty/org.eclipse.jetty.project.git
• (Historical) SVN:
  • jetty-7 (developers svn+ssh)
  • jetty-7 accessories (developers https)
  • jetty-6 (developers https)
  • jetty-6 contrib (developers https)
  • hightide (developers https)
• Codehaus CI
• Building from Source
• JIRA
• Jetty-6.1.x Release Procedure
• Website Release Procedure
• Building Jetty RPMs

Feature Guides

Asynchronous Servlets

• Suspendable Requests
• Continuations
• Quality of Service Filter
• Asynchronous REST & Jetty HTTP Client
• Asynchronous Web Services
• Asynchronous Proxy Servlet

AJAX / Comet

• Continuations for Ajax Comet
• Cometd (aka Bayeux)
  • Acknowledged Messages
  • Clustering with Oort coming soon
• ActiveMQ

Maven Support

• Maven Jetty Plugin
  • Which files are scanned by the Jetty Maven Plugin
• Maven Jetty Jspc Plugin
• Maven web app project archetypes courtesy of Webtide

Ant Support

• Ant Jetty Plugin

IDEA

• Debugging Jetty with IntelliJ IDEA

Eclipse Workbench

• Importing Jetty Source into Eclipse
• Debugging Jetty with Eclipse
• Debugging with the Maven Jetty Plugin inside Eclipse
• Jetty Eclipse Plugin - Web Tooling Support
• JettyLauncher Soon to be upgraded to jetty6
• run-jetty-run

Cargo

• Cargo container-agnostic testing tools

Useful Servlets and Filters

• Servlets Bundled with Jetty

Mobile Computing

• Google Android: i-jetty
• JME CDC

JEE Server Integrations

• Apache Geronimo JEE
• RedHat JBoss
• Grizzly Connector from Glassfish
• Sybase EAServer
• Remote Glassfish EJBs from Jetty

Web Frameworks

• DWR
• MyFaces
• JSF Reference Implementation
• Jakarta Slide
• Google Web Toolkit (GWT)
• Jetspeed2
• ICEfaces

EJB

• Jetty and Spring EJB3 (Pitchfork)
• JBoss EJB3
• ObjectWeb EasyBeans (aka JOnAS EJB3 container)
• Remote Glassfish EJBs from Jetty

Clustering Technologies

• Gigaspaces coming soon
• Terracotta (generic Terracotta version)
• Terracotta (Jetty version)
• WADI
• see also Session Clustering using a Database

Infrastructure

• Atomikos Transaction Manager
• JOTM
• Bitronix Transaction Manager
• ActiveMQ
• Binding JAX-WS 2.x Endpoints to Jetty contexts
• Java-monitor

OSGi

• Jetty OSGi Powered Products
• OSGi Tips
• Jetty as the HTTP Service in Equinox
• Jetty as the HTTP Service in Felix
• Jetty as the HTTP Service in PAX
• ProSyst mBedded Server Equinox Edition
• Jetty in Spring Dynamic Modules
• Jetty in JOnAS 5

Amazon EC2

• Jetty on Amazon EC2

Other

• JIRA

How Tos

General

• Running Jetty with jconsole
• Debug Logging
• Useful web developer tools
• How to test Servlets
• File upload Upload in Jetty6jetty6

General Configuration

• Configuring Jetty
• The jetty.xml file
• The jetty-web.xml file
• The jetty-env.xml file
• The webdefault.xml file
• The override web.xml file
• Temporary Directories
• System Properties
• How to capture stderr/stdout
• Suppressing HTTP Server Header
• Classloading
• JSP Configuration
• Serving aliased/symbolically linked files
• Customizing startup
• Using XBean to configure Jetty
• How to Create Custom Error Pages
• GZIP Compression

Contexts and Web Applications

• Web Application Deployer (static deploy)
• Context Deployer (hot deploy!)
• Static Content
• Relocating / Redirecting Contexts
• Rewrite Handler
• see also Embedding Jetty and Maven Jetty Plugin
• Multiple WebApp Source Directory

Connectors

• Configuring Connectors
• Configuring SSL
  • Ssl Connector Guide
  • Configure SSL Cipher Suites
• Apache mod_proxy (Reverse Proxy)
• Apache mod_proxy_ajp and mod_jk for AJP
• Running on port 80 as non-root user

Associating webapps with ports and virtual hosts

• Serving different webapps from different ports
• Virtual hosts

Thread Pools

• Bounded ThreadPool
• Queued ThreadPool TODO

Security

• Jetty Security reports.
• Securing Jetty
• Securing Passwords
• Realms
  • JAAS Realms
• How to Configure Security with Embedded Jetty

Management

• Server Log (coming soon)
• Request Logging
• Collecting statistics
• Graceful shutdown
• JMX

Annotations

• Annotations, Resource Injection and Lifecycle Callbacks

JNDI Services

• Using JNDI
  • DataSource Examples

JSP

• JSP 2.0 and JSP 2.1
• JSP Configuration

Sessions

• Session Configuration
• Persisting Sessions
• Single Sign On - Jetty HashSSORealm

  Clustering

• Session Clustering using a Database
• Session Clustering using Gigaspaces coming soon
• Session Clustering with Terracotta(Generic)
• Session Clustering with Terracotta(Jetty)
• Session Clustering with WADI

Optimizing

• Optimizing with Last-Modified and Cache-Control
• Optimizing Browser Caching
• Optimizing on High Load Servers

Other

• International Characters and Character Encodings
• Intercepting Connections and Requests
• Using Jetty to Put a Website on a CD (Jetty 5 - but same principle applies )

Trouble shooting

• No warning starting Jetty on port already in use (on Windows)
• Files locked on Windows
• Slow File Serving on Windows 2003
• Save could not be completed
• Temporary directory files not deleted
• Welcome files not working
• Invalid Content Length Log Message
• JSP expression do not evaluate
• Keep Generated
• Post requests using nio https hang
• Security Constraints and Welcome Files
• SSL does not work with DSA key
• Problems with JAAS 6.0.x
• NullpointerException in jasper Localizer class
• Zip exception reading jar or war files
• Connectors slow to startup
• Frequent disconnects when downloading large files
• OutofMemory Errors
• J2SE 6 Problems
• Webapp suddenly stopped working