6.2 Installation

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.3 Servlet spec and JSP 1.2. 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-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-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 -->
                

Back to Installation