blob: 2cbe3d64adc9ee017bfb33526ba6d181128609ef [file] [log] [blame]
<?xml version="1.0"?>
<document url="./index.xml">
<properties>
<author>Craig R. McClanahan</author>
<author>Ted Husted</author>
<author>Martin Cooper</author>
<title>The Struts Framework Project</title>
</properties>
<body>
<section name="Welcome to Struts 1.0.1" href="Welcome">
<p>Welcome to the Struts Framework! The goal of this project
is to provide an open source framework useful in building web applications
with Java <a href="http://java.sun.com/products/servlet">Servlet</a> and
<a href="http://java.sun.com/products/jsp">JavaServer Pages</a> (JSP)
technology. Struts encourages application architectures based on the
Model-View-Controller (MVC) design paradigm, colloquially known as
<i>Model 2</i> in discussions on various servlet and JSP related
mailing lists.</p>
<p>Struts includes the following primary areas of functionality:</p>
<ul>
<li>A controller servlet that dispatches requests to appropriate
<strong>Action</strong> classes provided by the application
developer.</li>
<li>JSP custom tag libraries, and associated support in the controller
servlet, that assists developers in creating interactive form-based
applications.</li>
<li>Utility classes to support XML parsing, automatic population of
JavaBeans properties based on the Java reflection APIs, and
internationalization of prompts and messages.</li>
</ul>
<p>Struts is part of the <a href="http://jakarta.apache.org">Jakarta
Project</a>, sponsored by the
<a href="http://www.apache.org">Apache Software Foundation</a>. The
official Struts home page is at
<a href="http://jakarta.apache.org/struts">http://jakarta.apache.org/struts</a>.
</p>
</section>
<section name="Learning About Struts" href="Docs">
<p>The <a href="userGuide/kickstart.html"><b>Kickstart FAQ</b></a> quickly answers
the most common questions about Struts.</p>
<p>A concise <a href="userGuide/index.html"><b>Users Guide</b></a> is also provided
with the distribution. The User Guide introduces the Model View Controller
architecture, and how it relates to the major components of Struts. Several Developer
Guides are also provided, to help you get started with the Struts tag extensions and
utility packages.</p>
<p>For more detail about a specific class or package, the Struts
<a href="api/index.html"><b>Javadocs</b></a>
are comprehensive and carefully maintained. It is strongly recommended that
you refer to the <a href="api/index.html">Javadoc</a>
for each class as you begin to use it, to be sure important features and options
are not overlooked. What you don't know, can't help you.</p>
<p>Of course, the only true documentation is the code itself. If you have any questions
about how Struts actually works, do not hestate to <i>use the source</i>. For the
complete, buildable source code to the entire Struts framework, see the "src" folder in
the <a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0.1/src/"><b>Struts 1.0 source distribution</b></a>.</p>
<p>The Struts <a href="userGuide/resources.html"><b>Resources</b></a> page provides links to
everything else written about Struts, including books, articles, tutorials, and sample
applications. There are also links to public sites "Powered by Struts". </p>
</section>
<section name="Acquiring Struts" href="Acquiring">
<p>The <i>production release</i> of <strong>Struts 1.0.1</strong> is available in
in convenient binary distribution and also with complete source code.</p>
<ul>
<li><a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0.1">
<b>Struts 1.0.1 Binary Distribution</b></a></li>
<li><a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0.1/src">
<b>Struts 1.0.1 Source Code Distribution</b></a></li>
</ul>
<p>Check the <a href="release-notes-1.0.1.html">Release Notes</a>
for a summary of what new features have been added, and other significant
changes, since the Struts 1.0 release.</p>
</section>
<section name="Nightly Builds" href="Builds">
<p>For developers who are helping to develop Struts, or who just want
"the latest bits", the latest development version is made available each
morning. Use at your own risk!</p>
<ul>
<li>Download the source directly via
<a href="http://jakarta.apache.org/getinvolved/cvsindex.html">
Anonymous CVS</a>.</li>
<li>Download nightly binary distributions from
<a href="http://jakarta.apache.org/builds/jakarta-struts/nightly">
here</a>.</li>
<li>Download nightly source distributions from
<a href="http://jakarta.apache.org/builds/jakarta-struts/nightly/src">
here</a>.</li>
</ul>
<p>Access to the CVS source repository for Struts is available through both
<a href="http://cvs.apache.org/viewcvs/jakarta-struts/">web
browser</a> and
<a href="http://jakarta.apache.org/getinvolved/cvsindex.html">CVS client</a>
interfaces.</p>
<p>In addition to the Struts distribution, you will need to ensure that
you have downloaded and installed all of the
<a href="installation.html#Prerequisites">prerequisite</a> software
applications. Then, follow the appropriate instructions to
<a href="installation.html#Building">build Struts from the source
distribution</a>, or <a href="installation.html#Installing">install and
use a Struts binary distribution</a> in your web application.</p>
</section>
<section name="Reporting Bugs and Feature Requests" href="Bugs">
<p>Tracking of bug reports and new feature requests for Struts is hosted at
<a href="http://nagoya.apache.org/bugzilla/">http://nagoya.apache.org/bugzilla/</a>.
Please select <strong>Struts</strong> from the product list, along with the
details of which component of Struts you feel this report relates to,
and details of your operating environment. You will automatically be
notified by Email as the status of your bug report changes.</p>
</section>
<section name="Getting Involved" href="Involved">
<p>There are a number of ways to get more involved in the Struts
community, including contributing to the future development of Struts.
Check out the following resources:</p>
<ul>
<li><strong>STRUTS-USER Mailing List</strong> - Subscribe to this list
to communicate with other developers that are using
mailing list to communicate with other developers that are using
Struts for their own applications, including questions about the
installation of Struts, and the usage of particular Struts features.
[<a href="mailto:struts-user-subscribe@jakarta.apache.org">Subscribe</a>]
[<a href="mailto:struts-user-unsubscribe@jakarta.apache.org">Unsubscribe</a>]
</li>
<li><strong>STRUTS-DEV Mailing List</strong> - Subscribe to this
mailing list to communicate with other developers interested in expanding
and improving the functionality supported by Struts itself.
[<a href="mailto:struts-dev-subscribe@jakarta.apache.org">Subscribe</a>]
[<a href="mailto:struts-dev-unsubscribe@jakarta.apache.org">Unsubscribe</a>]
</li>
<li><strong>Bug Reports and Feature Requests</strong> Use the
<a href="http://nagoya.apache.org/bugzilla/">Bug Reporting System</a>
to submit these reports.</li>
<li><strong>Patches and Modules</strong> - You can contribute patches and
new modules to Struts by posting them to the STRUTS-DEV mailing list.
After discussion and acceptance, one of the existing Committers will
add your contribution to the Struts source code base (with credit to
you, of course).</li>
<li><strong>Become A Committer</strong> - If you wish to contribute directly
to the development of Struts, and have commit access to the CVS source
repository, you can be nominated (or nominate yourself) for Committer
status on this project. The rules by which committers are voted on are
listed at the
<a href="http://jakarta.apache.org/guidelines/index.html">Jakarta
web site</a>.</li>
</ul>
</section>
</body>
</document>