struts-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From hus...@apache.org
Subject svn commit: r422245 - in /struts/struts1/trunk: el/src/site/ extras/src/site/ faces/src/site/ scripting/src/site/ src/site/ src/site/xdoc/userGuide/ taglib/src/site/ tiles/src/site/
Date Sat, 15 Jul 2006 15:06:41 GMT
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&amp;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" />
 



Mime
View raw message