Author: husted
Date: Sat Jul 15 08:06:40 2006
New Revision: 422245
URL: http://svn.apache.org/viewvc?rev=422245&view=rev
Log:
STR-2910 Move preface from Struts 1 to Site as Key Technologies Primer so that
it can be shared with Struts 2; Add links to Apps page; Move Sean to Emeritus
per his request to me; Add kickers to Announcements and Volunteers so that
section headings don't abut.
Removed:
struts/struts1/trunk/src/site/xdoc/userGuide/preface.xml
Modified:
struts/struts1/trunk/el/src/site/site.xml
struts/struts1/trunk/extras/src/site/site.xml
struts/struts1/trunk/faces/src/site/site.xml
struts/struts1/trunk/scripting/src/site/site.xml
struts/struts1/trunk/src/site/site.xml
struts/struts1/trunk/src/site/xdoc/userGuide/building_model.xml
struts/struts1/trunk/src/site/xdoc/userGuide/index.xml
struts/struts1/trunk/src/site/xdoc/userGuide/introduction.xml
struts/struts1/trunk/taglib/src/site/site.xml
struts/struts1/trunk/tiles/src/site/site.xml
Modified: struts/struts1/trunk/el/src/site/site.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/el/src/site/site.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/el/src/site/site.xml (original)
+++ struts/struts1/trunk/el/src/site/site.xml Sat Jul 15 08:06:40 2006
@@ -29,6 +29,9 @@
<menu name="Components">
+ <item name="Struts Apps"
+ href="../struts-apps/index.html" />
+
<item name="Struts EL"
href="../struts-el/index.html" />
Modified: struts/struts1/trunk/extras/src/site/site.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/extras/src/site/site.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/extras/src/site/site.xml (original)
+++ struts/struts1/trunk/extras/src/site/site.xml Sat Jul 15 08:06:40 2006
@@ -23,6 +23,9 @@
<menu name="Components">
+ <item name="Struts Apps"
+ href="../struts-apps/index.html" />
+
<item name="Struts EL"
href="../struts-el/index.html" />
Modified: struts/struts1/trunk/faces/src/site/site.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/faces/src/site/site.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/faces/src/site/site.xml (original)
+++ struts/struts1/trunk/faces/src/site/site.xml Sat Jul 15 08:06:40 2006
@@ -39,6 +39,9 @@
<menu name="Components">
+ <item name="Struts Apps"
+ href="../struts-apps/index.html" />
+
<item name="Struts EL"
href="../struts-el/index.html" />
Modified: struts/struts1/trunk/scripting/src/site/site.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/scripting/src/site/site.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/scripting/src/site/site.xml (original)
+++ struts/struts1/trunk/scripting/src/site/site.xml Sat Jul 15 08:06:40 2006
@@ -26,6 +26,9 @@
<menu name="Components">
+ <item name="Struts Apps"
+ href="../struts-apps/index.html" />
+
<item name="Struts EL"
href="../struts-el/index.html" />
Modified: struts/struts1/trunk/src/site/site.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/src/site/site.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/src/site/site.xml (original)
+++ struts/struts1/trunk/src/site/site.xml Sat Jul 15 08:06:40 2006
@@ -59,6 +59,9 @@
<menu name="Components">
+ <item name="Struts Apps"
+ href="struts-apps/index.html" />
+
<item name="Struts EL"
href="struts-el/index.html" />
Modified: struts/struts1/trunk/src/site/xdoc/userGuide/building_model.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/src/site/xdoc/userGuide/building_model.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/src/site/xdoc/userGuide/building_model.xml (original)
+++ struts/struts1/trunk/src/site/xdoc/userGuide/building_model.xml Sat Jul 15
08:06:40 2006
@@ -400,84 +400,141 @@
stateful or stateless
Enterprise JavaBeans (EJBs) instead.
</p>
+
+ <p>
+ For more about using a database with your application, see
+ the
+ <a href="../faqs/db-howto.html">Accessing a Database
+ HowTo.</a>
+ </p>
+
+ <p>
+ For more about business logic and data access frameworks,
+ see the <a href="http://struts.apache.org/primer.html";>
+ key technologies primer</a>.
+ </p>
+
</subsection>
+
+
+ <a name="dynabeans"/>
+ <subsection name="2.5.1 DynaBeans">
- <a name="logic_frameworks"/>
- <subsection name="2.6 Business Logic Frameworks">
+ <p>
+ DynaBeans combine the extensibility of JavaBeans with the
+ flexibility of a Map.
+ Defining even the simplest JavaBean requires defining a
+ new class and coding a field and two methods for each
+ property.
+ The properties of a DynaBean can be configured via an XML
+ descriptor.
+ The virtual properties of a DynaBean can't be called by
+ standard Java methods,
+ but work well with components that rely on reflection and
+ introspection.
+ </p>
<p>
- Most teams still roll their own business logic layer using
- plain old JavaBeans (POJOs).
- Though, business layer frameworks are beginning to emerge,
- and now include:
+ In your application, you can use DynaBeans to describe
+ your HTML forms.
+ This strategy can avoid creating a formal JavaBean
+ subclass to store a few simple properties.
</p>
+
+ <p>
+ For more about DynaBeans, see
+ </p>
+
<ul>
<li>
- <a href="http://jakarta.apache.org/commons/chain/";>
- Commons Chain of Responsiblity</a>
- </li>
- <li>
- <a href="http://springframework.org/";>Spring</a>
+ The Commons BeanUtils
+ <a
href="http://jakarta.apache.org/commons/beanutils/api/org/apache/commons/beanutils/package-summary.html#package_description";>
+ Package Description</a>
+ and
+ <a
href="http://jakarta.apache.org/commons/beanutils/api/index.html";>
+ Javadocs.</a>
</li>
<li>
- <a href="http://www.opensymphony.com/xwork/";>XWork</a>
+ <a href="https://formdef.dev.java.net/";>Struts
+ FormDef</a>
</li>
</ul>
+ </subsection>
+
+ <a name="chain"/>
+ <subsection name="2.6 Commons Chain">
+
<p>
- As of Struts 1.3, Commons Chain is used to construct the
- default
- Request Processor for the framework.
- See the
- <a href="preface.html#chain">Preface</a>
- section for more.
+ A popular technique for organizing the execution of
+ complex
+ processing flows is the "Chain of Responsibility" pattern,
+ as described (among many other places) in the classic
+ <a
href="http://www.amazon.com/exec/obidos/tg/detail/-/0201633612/apachesoftwar-20/";>
+ "Gang of Four" design patterns book.</a>
+ The GoF summarizes the Chain of Responsibility pattern as
+ "Avoid coupling the sender of a request to its receiver
+ by giving more than one object a chance to handle the
+ request.
+ Chain the receiving objects
+ and pass the request along the chain until an object
+ handles it."
</p>
- </subsection>
- <a name="data_frameworks"/>
- <subsection name="2.6 Data Access Frameworks">
+ <p>
+ The CoR pattern helps us keep software components loosely
+ coupled.
+ A component can call a Chain of Responsbility,
+ without knowing what objects are on the chain or how they
+ are
+ implemented.
+ Most importantly, we can adjust the Chain without changing
+ how callers invoke the Chain.
+ As of version 1.3,
+ the default Request Processor,
+ which acts as the framework's "kernal",
+ is a Chain of Responsiblity.
+ </p>
<p>
- Most often, the business layer is seen to be distinct from
- the
- data access layer.
- Some teams roll their own data access objects (DAOs),
- but more and more teams are turning to one of the many
- data access
- frameworks.
- Some popular data access frameworks include:
+ To implement its Chain, the Request Processor uses the
+ <a href="http://jakarta.apache.org/commons/chain/";>
+ Chain of Responsibility</a>
+ component in the Jakarta Commons
+ which provides a standard implementation of the CoR
+ pattern,
+ along with various implementations of the Context and
+ Command objects used by the Chain to service a request.
+ </p>
+
+ <p>
+ For more about Chain of Responsiblity, see
</p>
<ul>
<li>
- <a href="http://java.sun.com/products/ejb/index.html";>
- Enterprise Java Beans</a>
- </li>
- <li>
- <a href="http://www.hibernate.org/";>Hibernate</a>
- </li>
- <li>
- <a href="http://ibatis.apache.org";>iBATIS</a>
+ <a href="http://jakarta.apache.org/commons/chain/";>
+ Jakarta Commons Chain of Responsibility</a>
</li>
<li>
- <a href="http://java.sun.com/products/jdbc/index.html";>
- JDBC</a>
+ <a href="http://www.onjava.com/lpt/a/5671";>
+ A look at Commons Chain</a>
</li>
<li>
- <a href="http://db.apache.org/ojb/";>
- Object Relational Bridge</a>
+ <a
href="http://www.infonoia.com/en/content.jsp?d=inf.05.06&pr=1";>
+ Better Code with Struts 1.3
+ </a>
</li>
</ul>
-
-
+
<p>
- For more about using a database with your application, see
- the
- <a href="../faqs/db-howto.html">Accessing a Database
- HowTo.</a>
- </p>
- </subsection>
+ As of Struts 1.3, Commons Chain is used to construct the
+ default
+ Request Processor for the framework.
+ </p>
+
+ </subsection>
</section>
<section>
Modified: struts/struts1/trunk/src/site/xdoc/userGuide/index.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/src/site/xdoc/userGuide/index.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/src/site/xdoc/userGuide/index.xml (original)
+++ struts/struts1/trunk/src/site/xdoc/userGuide/index.xml Sat Jul 15 08:06:40
2006
@@ -30,122 +30,6 @@
<ul>
<li>
- <a href="preface.html">0. Preface</a>
- <ul>
- <li>
- <a href="preface.html#suspects">0.1 The Usual
- Suspects</a>
- </li>
- <li>
- <a href="preface.html#http">0.2 HTTP, HTML, and
- User Agents</a>
- </li>
- <li>
- <a href="preface.html#cycle">0.3 The HTTP
- Request/Response Cycle</a>
- </li>
- <li>
- <a href="preface.html#java">0.4 The Java Language
- and Application Frameworks</a>
- </li>
- <ul>
- <li>
- <a href="preface.html#chain">0.4.1 Chain of
- Responsibility</a>
- </li>
- </ul>
- <li>
- <a href="preface.html#javabeans">0.5 JavaBeans</a>
- </li>
- <ul>
- <li>
- <a href="preface.html#reflection">0.5.1
- Reflection and Introspection</a>
- </li>
- <li>
- <a href="preface.html#maps">0.5.2 Maps</a>
- </li>
- <li>
- <a href="preface.html#dynabeans">0.5.3
- DynaBeans</a>
- </li>
- </ul>
- <li>
- <a href="preface.html#resources">0.6 Properties
- Files and ResourceBundles</a>
- </li>
- <li>
- <a href="preface.html#servlets">0.7 Java
- Servlets</a>
- </li>
- <ul>
- <li>
- <a href="preface.html#threads">0.7.1 Servlets
- and threads</a>
- </li>
- <li>
- <a href="preface.html#context">0.7.2 Servlet
- Context</a>
- </li>
- <li>
- <a href="preface.html#request">0.7.3 Servlet
- Request</a>
- </li>
- <li>
- <a href="preface.html#response">0.7.4 Servlet
- Response</a>
- </li>
- <li>
- <a href="preface.html#filter">0.7.5
- Filtering</a>
- </li>
- <li>
- <a href="preface.html#session">0.7.6
- Sessions</a>
- </li>
- <li>
- <a href="preface.html#dispatch">0.7.7
- Dispatching Requests</a>
- </li>
- <li>
- <a href="preface.html#webapp">0.7.8 Web
- Applications</a>
- </li>
- <li>
- <a href="preface.html#events">0.7.9 Web
- application deployment descriptor</a>
- </li>
- <li>
- <a href="preface.html#security">0.7.10
- Security</a>
- </li>
- </ul>
- <li>
- <a href="preface.html#jsp">0.8 JavaServer Pages,
- JSP Tag Libraries, and JavaServer Faces</a>
- </li>
- <li>
- <a href="preface.html#xml">0.9 Extensible Markup
- Language</a>
- </li>
- <ul>
- <li>
- <a href="preface.html#descriptors">0.9.1
- Descriptors</a>
- </li>
- </ul>
- <li>
- <a href="preface.html#jaas">0.10 JAAS</a>
- </li>
- <li>
- <a href="preface.html#layers">0.11 Other
- layers</a>
- </li>
- </ul>
- </li>
-
-
- <li>
<a href="introduction.html">1. Introduction</a>
<ul>
<li>
@@ -204,14 +88,6 @@
<a href="building_model.html#business_logic">2.5
Business Logic Beans</a>
</li>
- <li>
- <a href="building_model.html#logic_frameworks">2.6
- Business Logic Frameworks</a>
- </li>
- <li>
- <a href="building_model.html#data_frameworks">2.7
- Data Access Frameworks</a>
- </li>
</ul>
</li>
<li>
@@ -542,7 +418,6 @@
</li>
</ul>
</li>
-
</ul>
</section>
@@ -550,7 +425,7 @@
<section>
<p class="right">
Next:
- <a href="preface.html">Preface</a>
+ <a href="introduction.html">introduction</a>
</p>
</section>
Modified: struts/struts1/trunk/src/site/xdoc/userGuide/introduction.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/src/site/xdoc/userGuide/introduction.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/src/site/xdoc/userGuide/introduction.xml (original)
+++ struts/struts1/trunk/src/site/xdoc/userGuide/introduction.xml Sat Jul 15
08:06:40 2006
@@ -30,12 +30,23 @@
"Read the directions and directly you will be directed in the
right
direction."
</em></p></blockquote>
+
+ <p>
+ The framework documentation is written for active web
+ developers and assumes a working
+ knowledge about how Java web applications are built.
+ For more about the underlying nuts and bolts,
+ see the <a href="http://struts.apache.org/primer.html";>
+ Key Technologies Primer.
+ </a>
+ </p>
+
<a name="history"/>
<subsection
name="1.1 Forward into the Past! (or a brief history of
Struts)"
href="history">
-
+
<p>
When Java servlets were first invented, many programmers
quickly realized that they were a
Modified: struts/struts1/trunk/taglib/src/site/site.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/site/site.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/taglib/src/site/site.xml (original)
+++ struts/struts1/trunk/taglib/src/site/site.xml Sat Jul 15 08:06:40 2006
@@ -30,6 +30,9 @@
<menu name="Components">
+ <item name="Struts Apps"
+ href="../struts-apps/index.html" />
+
<item name="Struts EL"
href="../struts-el/index.html" />
Modified: struts/struts1/trunk/tiles/src/site/site.xml
URL:
http://svn.apache.org/viewvc/struts/struts1/trunk/tiles/src/site/site.xml?rev=422245&r1=422244&r2=422245&view=diff
==============================================================================
--- struts/struts1/trunk/tiles/src/site/site.xml (original)
+++ struts/struts1/trunk/tiles/src/site/site.xml Sat Jul 15 08:06:40 2006
@@ -29,6 +29,9 @@
<menu name="Components">
+ <item name="Struts Apps"
+ href="../struts-apps/index.html" />
+
<item name="Struts EL"
href="../struts-el/index.html" />
