Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Jetty/Tutorial/EclipseRT-Jetty-Starter-Kit



Introduction

This tutorial shows how to use the EclipseRT Jetty StarterKit.

Details

StarterKit Overview

Eclipse RT StarterKit is configured out of the box with

  • Equinox
  • P2 support: simpleconfigurator, dropins reconciler, provisioning commands for the OSGi console
  • slf4j, logback
  • Jetty-7: servlet-2.5, JSP-2.1, JMX, JNDI, JTA, Websocket and continuations...
  • SDK additions: sources, JUnit support and PDE files.

Current download URL: http://download.eclipse.org/jetty/7.1.3.v20100526/dist/eclipse/

On the command-line

Launch

The starter kit can be launched via the equinox native launcher or directly through java.

Jetty server configuration

The jetty server is configured via the etc/jetty.xml file.

Logging configuration

slf4j, logback: configured in etc/logback.xml

Upgrade and bundle management

Via P2 (link to the P2 console command controles and the P2 admin UI.)

Dropins reconciler

It is possible to add bundles in the dropins folder. This is only for development purposes. For production it is recommended to publish your bundles and features in a P2 repository and use P2 to install them into the Starter Kit.

J2EE support

  • Web application can be dropped in the webapps folder.
  • Jetty Context files can be defined in the contexts folder.
  • Shared libraries between webapps can be placed inside lib/ext.

The resulting applications's classloaders behave in the same manner than in the traditional J2EE distribution of Jetty. Those web-applications and shared libraries don't have access to classes provided by OSGi bundles.

With Eclipse PDE

The SDK version of the starter kit is packaged with a PDE related files. This makes it faster to define the corresponding target platform and launch configuration.

Import the Starter Kit in the workspace

Import the downloaded starter kit as a Eclipse Project into your workspace. The project is called "EclipseRT Jetty Starter Kit".

Setup the Target Platform

At the root of the project, open the JettyStarterKitSDK.target file. Click on the top left on "Set As Target Platform."

Define the Target Platform

Note: You can also use the Target Platform definition wizard instead.

Launch configuration

The launch configuration "Start Jetty" is preset.

To create one from scratch, make a new OSGi launch configuration. Add the following system properties to the VM arguments:

 -Djetty.home=${workspace_loc:Jetty Starter Kit} -Dlogback.configurationFile=${workspace_loc:Jetty Starter Kit}/etc/logback.xml

Web-bundles and test units

Please refer to Jetty OSGi Target Platform, tutorial

Additional Resources

Jetty-OSGi, Jetty OSGi Target Platform, tutorial, RFC66, PDE

Copyright © Eclipse Foundation, Inc. All Rights Reserved.