Jump to: navigation, search

Difference between revisions of "Jetty/Howto/Develop"

< Jetty‎ | Howto
(Developing against Jetty APIs)
Line 44: Line 44:
  
 
Developing against the Jetty API can be used to develop both standard webapplications and embedded web applications.  The basic approach is to install the required [[Jetty/Reference/Dependencies|jetty-7 jars and dependencies]] on your class path and then write and run a variation of one of the examples in the [[Jetty/Tutorial/Embedding_Jetty#Web_Application_Context|Jetty Embedding Tutorial]].
 
Developing against the Jetty API can be used to develop both standard webapplications and embedded web applications.  The basic approach is to install the required [[Jetty/Reference/Dependencies|jetty-7 jars and dependencies]] on your class path and then write and run a variation of one of the examples in the [[Jetty/Tutorial/Embedding_Jetty#Web_Application_Context|Jetty Embedding Tutorial]].
 +
 +
For more detail of how to setup your class path, see:
 +
*  [[Jetty/Tutorial/Building and Running Embedded Jetty]] Tutorial
 +
*  [[Jetty/Tutorial/Developing with Jetty and Maven]] Tutorial

Revision as of 18:41, 15 February 2010



Introduction

Jetty Development can roughly be consider from two aspects:

  1. Developing standard web applications that use only standard APIs, but that are deployed in jetty either for development and/or production. These web applications may use some jetty APIs, but only as normal WEB-INF/lib libraries.
  2. Developing against the jetty APIs for either embedded or closely integrated purposes. This style of development needs jetty jars on the class path during development and runtime


Standard Web Application Development

To develop a standard web application with jetty, typically you need only the servlet.jar on the classpath of your IDE and then some way to run a jetty server just to test the web application as part of a normal development lifecycle:

Jetty Maven Plugin

Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information. It is an ideal tool to build a web application project and such projects can use the Jetty/Feature/Jetty Maven Plugin to run the web application in development mode.

Typically a build tool needs to assemble a web application into a war file, which merges the compiled code, the static content and the deployment descriptor into a zipped file, which can then be deployed in a server. However, during development, the time taken to assemble a war file can be significant and the resulting bundle can be hard to develop against as source code changes are not immediately reflected.

Once the Jetty/Feature/Jetty Maven Plugin is configured for a project, a jetty server can be started with the command:
mvn jetty:run

This runs the application directly from its unassembled source components, so that if static content is saved from your IDE's editor, it is immediately visible to the jetty server. If you save a java class, then your IDE will probably compile it on the fly and the plugin will notice the change and redeploy the web application within seconds.

Ant Jetty Plugin

The Jetty Ant plugin provides an ant target that allows a jetty server to be run from an ant build.xml file.

This modules is available from jetty@codehaus for Jetty-7, but currently the documentation only exists for jetty ant with jetty-6. This documentation mostly holds, except the jar names need to be updated for jetty-7 jars and dependencies.

TBD

OSGi Plugin

TBD

Eclipse Web Tooling

TBD

Embedded Jetty Main

A short java Main can be written to launch your web applications in jetty directly from your IDE, just as you would run any other java application. This allows your IDE's debugger to step through both your application and the server code, and thus allows very integrated debugging.

See the Jetty Embedding Tutorial for examples of running a webapp from a main. See the sections below for how to setup your IDE to run embedded jetty.


Developing against Jetty APIs

Developing against the Jetty API can be used to develop both standard webapplications and embedded web applications. The basic approach is to install the required jetty-7 jars and dependencies on your class path and then write and run a variation of one of the examples in the Jetty Embedding Tutorial.

For more detail of how to setup your class path, see: