Difference between revisions of "Jetty/Tutorial/Embedding Jetty"

From Eclipsepedia

Jump to: navigation, search
Line 15: Line 15:
 
# wait (join the server to prevent main exiting).
 
# wait (join the server to prevent main exiting).
  
== Servers and Handlers ==
+
== Servers ==
=== Simplest Server ===  
+
The following code from [http://dev.eclipse.org/svnroot/rt/org.eclipse.jetty/jetty/trunk/example-jetty-embedded/src/main/java/org/eclipse/jetty/embedded/SimplestServer.java SimplestServer.java] will instantiate and run the simplest possible Jetty server:
The following code will instantiate and run the simplest possible Jetty server:
+
 
<pre>
 
<pre>
 
public class SimplestServer
 
public class SimplestServer
Line 30: Line 29:
 
</pre>
 
</pre>
  
This runs a  
+
This runs a HTTP server on port 8080.  It is not a very useful server as it has not handlers and thus will return a 404 error for every request.
  
==  
+
== Connectors ==
  
 +
== Handlers ==
  
 +
== Handler Collections ==
 +
 +
== File Server ==
 +
 +
 +
 +
 +
== Context
  
 
}}
 
}}

Revision as of 04:05, 27 July 2009



Contents

Introduction

Jetty has a slogan "Don't deploy your application in Jetty, deploy Jetty in your application". What this means is that Jetty as an alternative to bundling your application as a standard WAR to be deployed in Jetty, Jetty is designed to be a software component that can be instantiated and used in a java program just like any POJO.

This tutorial takes you step by step from the simplest jetty server instantiation, through programmatically, to running multiple web applications with standards based deployment descriptors.

The source for most of these examples is part of the standard jetty project.

Details

To embed a Jetty server, the following steps are typical:

  1. Create the server
  2. Add/Configure Connectors
  3. Add/Configure Handlers
  4. Add/Configure Servlets/Webapps to Handlers
  5. start the server
  6. wait (join the server to prevent main exiting).

Servers

The following code from SimplestServer.java will instantiate and run the simplest possible Jetty server:

public class SimplestServer
{
    public static void main(String[] args)  throws Exception
    {
        Server server = new Server(8080);
        server.start();
        server.join();
    }
}

This runs a HTTP server on port 8080. It is not a very useful server as it has not handlers and thus will return a 404 error for every request.

Connectors

Handlers

Handler Collections

File Server

== Context