Struts Framework
Welcome
Home
Kickstart FAQ
User Guide
Resources
Who We Are
Downloads
Binaries
Source Code
Getting Started
Installation
Release Notes
Javadoc
Mailing Lists
Bug Database
Developer Guides
Bean Tags
HTML Tags
Logic Tags
Template Tags
Digester
Utilities
TagLib Documentation
Bean Tags
HTML Tags
Logic Tags
Template Tags
Current Development
Installation (nightly)
Release Notes (nightly)
Javadoc (nightly)
Workflow Proposal
TODO List
Installing Struts with your servlet container

Jetty Java HTTP Servlet Server

Jetty is a small, pure-Java, open source HTTP server that supports the 2.2 Servlet spec and JSP 1.1. Jetty can be downloaded from http://www.mortbay.com/jetty.

Struts WAR files run nearly straight out of the box when placed underneath Jetty's webapps directory. The one additional step needed is to add an entry for each WAR file to the Jetty server configuration file in order to map the appropriate request paths to the added Struts web applications (using "<Call name="addWebApplication">...").

So for example, if you have copied the WAR files that come with the Struts binary distribution into a subdirectory of the "%JETTY_HOME%/webapps" called "%JETTY_HOME%/webapps/struts" so that you have:

- %JETTY_HOME%/webapps/struts/struts-documentation.war
- %JETTY_HOME%/webapps/struts/struts-example.war
- %JETTY_HOME%/webapps/struts/struts-exercise-taglib.war
- %JETTY_HOME%/webapps/struts/struts-template.war
- %JETTY_HOME%/webapps/struts/struts-upload.war
- %JETTY_HOME%/webapps/struts/struts-blank.war

And you want to run Jetty using the demo.xml configuration file that comes with Jetty, just add the following block to demo.xml, anywhere after the Listeners are declared.

<!-- Jetty config for Struts BEGIN -->

  <Call name="addWebApplication">
    <Arg>/struts/struts-documentation/*</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/webapps/struts/struts-documentation.war</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/etc/webdefault.xml</Arg>
    <Arg type="boolean">false</Arg> <!-- if true,
        expand war in temp dir -->
  </Call>

  <Call name="addWebApplication">
    <Arg>/struts/struts-example/*</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/webapps/struts/struts-example.war</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/etc/webdefault.xml</Arg>
    <Arg type="boolean">true</Arg> <!-- if true,
        expand war in temp dir -->
  </Call>

  <Call name="addWebApplication">
    <Arg>/struts/struts-exercise-taglib/*</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/webapps/struts/struts-exercise-taglib.war</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/etc/webdefault.xml</Arg>
    <Arg type="boolean">false</Arg> <!-- if true,
        expand war in temp dir -->
  </Call>

  <Call name="addWebApplication">
    <Arg>/struts/struts-template/*</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/webapps/struts/struts-template.war</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/etc/webdefault.xml</Arg>
    <Arg type="boolean">true</Arg> <!-- if true,
        expand war in temp dir -->
  </Call>

  <Call name="addWebApplication">
    <Arg>/struts/struts-upload/*</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/webapps/struts/struts-upload.war</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/etc/webdefault.xml</Arg>
    <Arg type="boolean">true</Arg> <!-- if true,
        expand war in temp dir -->
  </Call>

  <Call name="addWebApplication">
    <Arg>/struts/struts-blank/*</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/webapps/struts/struts-blank.war</Arg>
    <Arg><SystemProperty name="jetty.home"
        default="."/>/etc/webdefault.xml</Arg>
    <Arg type="boolean">true</Arg> <!-- if true,
        expand war in temp dir -->
  </Call>

<!-- Jetty config for Struts END -->

  • Author: Paul Runyan

Back to Installation


Copyright (c) 2000-2002, Apache Software Foundation