Jetty Logo
Version: 9.2.3.v20140905
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. Embedding

Table of Contents

Jetty Embedded HelloWorld
Embedding Jetty
Embedded Examples

Jetty Embedded HelloWorld

This section provides a tutorial that shows how you can quickly develop embedded code against the Jetty API.

Downloading the Jars

Jetty is decomposed into many jars and dependencies to achieve a minimal footprint by selecting the minimal set of jars. Typically it is best to use something like Maven to manage jars, however this tutorial uses an aggregate Jar that contains all of the Jetty classes in one Jar. You can manually download the aggregate jetty-all.jar and the servlet-api.jar using curl) or a browser.

Note

The central maven repository has started to aggressively reject/deny access to the repository from the wget command line tool (due to abusive use of the tool by some groups). The administrators of the central maven repository have stated that the recommended command line download tool is now curl.

Use curl as follows:

> mkdir Demo
> cd Demo
> curl -o jetty-all.jar http://central.maven.org/maven2/org/eclipse/jetty/aggregate/jetty-all/9.2.3.v20140905/jetty-all-9.2.3.v20140905.jar
> curl -o servlet-api.jar http://central.maven.org/maven2/javax/servlet/javax.servlet-api/3.1.0/javax.servlet-api-3.1.0.jar 

Writing a HelloWorld Example

The Embedding Jetty section contains many examples of writing against the Jetty API. This tutorial uses a simple HelloWorld handler with a main method to run the server. You can either download or create in an editor the file HelloWorld.java with the following content:

Compiling the HelloWord example

The following command compiles the HelloWorld class:

javac -cp servlet-api.jar:jetty-all.jar HelloWorld.java

Running the Handler and Server

The following command runs the HelloWorld example:

java -cp .:servlet-api.jar:jetty-all.jar HelloWorld

You can now point your browser at http://localhost:8080 to see your hello world page.

Next Steps

To learn more about Jetty, take these next steps:

See an error or something missing? Contribute to this documentation at Github!(Generated: 2014-10-20T01:00:32-07:00)