1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
The Chain Of Responsibility Adapter README File
$Id: README.txt 51188 2003-11-27 23:01:22Z martinc $
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
|
