| The Chain Of Responsibility Adapter README File |
| $Id: README.txt,v 1.2 2003/11/27 23:01:22 martinc Exp $ |
| |
| |
| INTRODUCTION: |
| ============ |
| |
| FIXME |
| |
| |
| CONTENTS OF THIS RELEASE: |
| ======================== |
| |
| |
| Top Level Directory: |
| ------------------- |
| |
| LICENSE.txt -- The Apache Software License, under which all software |
| included in this bundle is licensed. |
| |
| README.txt -- This README file. |
| |
| build.xml -- Ant build script (only required for building from |
| source). |
| |
| build.properties.sample |
| -- Sample "build.properties" file that may be customized |
| (only required for building from source). |
| |
| |
| Directory "docs": |
| ---------------- |
| |
| api/ -- Javadocs for the classes included in the Struts Chain |
| of Responsibility library (org.apache.struts.chain.*). |
| |
| |
| Directory "lib": |
| --------------- |
| |
| struts-chain.jar -- The compiled classes for the Chain Of Responsibility |
| adapter library. |
| |
| |
| Directory "src": |
| --------------- |
| |
| conf/ -- Source files for the JAR file's manifest. |
| |
| example/ -- Source files for the demonstration web application. |
| |
| java/ -- Source files for the Chain of Responsibility library |
| classes (only required for building from source). |
| The base package is "org.apache.struts.chain". |
| |
| |
| Directory "web": |
| --------------- |
| |
| example/ -- JSP and web application configuration files for the |
| demonstration web application. |
| |
| |
| Directory "webapps": |
| ------------------- |
| |
| struts-chain.war -- Executable version of the demonstration |
| web application. |
| |
| |
| RUNNING THE EXAMPLE APPLICATION: |
| =============================== |
| |
| The following steps are required to deploy and run the example application |
| (struts-chain.war) included in this distribution: |
| |
| |
| Install A Java Development Kit: |
| ------------------------------ |
| |
| The Struts Chain Of Responsibility library requires a Java Development Kit (not |
| the Java Runtime Environment), version 1.3 or later. It was tested against |
| Sun's JDK 1.4.2 release, available at: |
| |
| http://java.sun.com/j2se/ |
| |
| |
| Install A Servlet/JSP Container: |
| ------------------------------- |
| |
| The Struts Chain Of Responsibility library requires a container that supports |
| Servlet 2.3 (or later) and JSP 1.2 (or later). Any J2EE 1.3 (or later) |
| application server should also work. You must acquire and install such |
| a container in order to execute the example application, following that |
| container's standard installation instructions. |
| |
| |
| Install A Struts 1.2 Nightly Release: |
| ------------------------------------ |
| |
| The Struts Chain of Responsibility library requires a recent nightly build of |
| the head branch of the Struts CVS repository (i.e. the code being used for the |
| Struts 1.2 development track). |
| |
| http://jakarta.apache.org/site/binindex.cgi |
| |
| You will want to become familiar with the operation of the standard example |
| web application (struts-example.war), if you are not already. |
| |
| |
| Deploy And Execute The Sample Application: |
| ----------------------------------------- |
| |
| Follow the standard procedures for your container to deploy a web application |
| that is packaged as a WAR file. For example, you can deploy on Tomcat by |
| simply copying the struts-chain.war file into the "webapps" |
| subdirectory of your Tomcat installation, and restarting Tomcat. |
| |
| To execute the sample application, access it with a web browser under URL to |
| which it was installed. This will usually be something like: |
| |
| http://localhost:8080/struts-chain/ |
| |
| |
| USING THE CHAIN OF RESPONSIBILITY LIBRARY IN YOUR OWN APPLICATIONS: |
| ================================================================== |
| |
| FIXME |
| |
| |
| BUILDING FROM SOURCE: |
| ==================== |
| |
| If you wish, you can build the Struts Chain Of Responsibility library, and the |
| sample application, from the source code included in this distribution. |
| Follow these steps: |
| |
| |
| Install An Ant Distribution: |
| --------------------------- |
| |
| The provided build.xml script requires Ant, version 1.5.2 or later. You can |
| get it from: |
| |
| http://ant.apache.org/ |
| |
| Install this environment as described in the Ant documentation, and ensure |
| that Ant's "bin" directory is on your PATH. |
| |
| |
| Configure Your Build Properties: |
| ------------------------------- |
| |
| Copy the "build.properties.sample" file in the top level directory to a file |
| named "build.properties", and customize the paths that are specified there. |
| |
| |
| Build The Sources: |
| ----------------- |
| |
| The simplest way to build is to execute: |
| |
| ant clean dist |
| |
| to recreate the entire distribution in the "dist" subdirectory. Use the |
| "ant -projecthelp" command to see what other targets are available. |
| |
| |
| |
| KNOWN LIMITATIONS: |
| ================= |
| |
| FIXME |