Author: husted
Date: Sun Sep 11 12:17:16 2005
New Revision: 280168
URL: http://svn.apache.org/viewcvs?rev=280168&view=rev
Log:
* helping: Add "How can I help make the decisions".
* preface, building_model: Move "other layer" links from preface.
* preface: add anchors
Modified:
struts/core/trunk/xdocs/userGuide/building_model.xml
struts/core/trunk/xdocs/userGuide/index.xml
struts/core/trunk/xdocs/userGuide/preface.xml
struts/site/trunk/xdocs/helping.xml
Modified: struts/core/trunk/xdocs/userGuide/building_model.xml
URL:
http://svn.apache.org/viewcvs/struts/core/trunk/xdocs/userGuide/building_model.xml?rev=280168&r1=280167&r2=280168&view=diff
==============================================================================
--- struts/core/trunk/xdocs/userGuide/building_model.xml (original)
+++ struts/core/trunk/xdocs/userGuide/building_model.xml Sun Sep 11 12:17:16
2005
@@ -260,20 +260,72 @@
For larger applications, these beans will often be 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>.
+ 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:
</p>
+ <ul>
+ <li>
+ <a href="http://jakarta.apache.org/commons/chain/";>
+ Commons Chain</a>
+ <ul>
+ <li>
+ <a href="http://www.onjava.com/lpt/a/5671";>
+ A look at Commons Chain</a>
+ </li>
+ </ul>
+ </li>
+ <li>
+ <a href="http://springframework.org/";>Spring</a>
+ </li>
+ <li>
+ <a href="http://www.opensymphony.com/xwork/";>XWork</a>
+ </li>
+ </ul>
+
+ <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:
+ </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>
+ </li>
+ <li>
+ <a href="http://java.sun.com/products/jdbc/index.html";>JDBC</a>
+ </li>
+ <li>
+ <a href="http://db.apache.org/ojb/";>Object Relational
Bridge</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>
+</section>
-<subsection>
+<section>
<p class="right">
Next: <a href="building_view.html">Building View Components</a>
</p>
-</subsection>
-
</section>
+
</body>
</document>
Modified: struts/core/trunk/xdocs/userGuide/index.xml
URL:
http://svn.apache.org/viewcvs/struts/core/trunk/xdocs/userGuide/index.xml?rev=280168&r1=280167&r2=280168&view=diff
==============================================================================
--- struts/core/trunk/xdocs/userGuide/index.xml (original)
+++ struts/core/trunk/xdocs/userGuide/index.xml Sun Sep 11 12:17:16 2005
@@ -24,6 +24,7 @@
<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>
<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>
@@ -53,7 +54,7 @@
<li><a href="building_view.html#i18n">3.2
Internationalization</a></li>
<li><a href="building_view.html#form_beans">3.3 Forms and
FormBean Interactions</a>
<ul>
- <li><a href="building_view.html#indexed">3.3.1 Indexed
& Mapped Properties</a></li>
+ <li><a href="building_view.html#indexed">3.3.1 Indexed
& mapped Properties</a></li>
<li><a href="building_view.html#form_input">3.3.2 Input
Field Types Supported</a></li>
<li><a href="building_view.html#presentation_tags">3.3.3
Other Useful Presentation Tags</a></li>
<li><a href="building_view.html#form_validation">3.3.4
Automatic Form Validation</a></li>
Modified: struts/core/trunk/xdocs/userGuide/preface.xml
URL:
http://svn.apache.org/viewcvs/struts/core/trunk/xdocs/userGuide/preface.xml?rev=280168&r1=280167&r2=280168&view=diff
==============================================================================
--- struts/core/trunk/xdocs/userGuide/preface.xml (original)
+++ struts/core/trunk/xdocs/userGuide/preface.xml Sun Sep 11 12:17:16 2005
@@ -9,7 +9,8 @@
<section name="0. Preface: Core Technologies">
- <subsection name="0.1 The Usual Suspects" href="suspects">
+ <a name="suspects"/>
+ <subsection name="0.1 The Usual Suspects">
<p>
This User Guide is written for active web developers and assumes a
working
@@ -26,6 +27,8 @@
<li><a href="#servlets">Java Servlets</a></li>
<li><a href="#jsp">JavaServer Pages and JSP Tag Libraries</a></li>
<li><a href="#xml">Extensible Markup Language</a></li>
+ <li><a href="#jaas">JAAS</a></li>
+ <li><a href="#layers">Other Layers</a></li>
</ul>
<p>
@@ -60,7 +63,8 @@
</subsection>
- <subsection name="0.2 HTTP, HTML and User Agents" href="http">
+ <a name="http"/>
+ <subsection name="0.2 HTTP, HTML and User Agents">
<p>The World Wide Web was built over the Hypertext Transfer Protocol
(<a href="http://www.ietf.org/rfc/rfc2616.txt?number=2616";>HTTP</a>) and
the Hypertext Markup Language
@@ -86,7 +90,8 @@
</ul>
</subsection>
- <subsection name="0.3 The HTTP Request/Response cycle" href="cycle">
+ <a name="cycle"/>
+ <subsection name="0.3 The HTTP Request/Response cycle">
<p>A very important part of HTTP for the web developer is the
request/response cycle. To use HTTP
you have to make a request. A HTTP server, like a web server, is then
obliged to respond. When you
@@ -101,7 +106,8 @@
</subsection>
- <subsection name="0.4 The Java Language and Application Frameworks"
href="java">
+ <a name="java"/>
+ <subsection name="0.4 The Java Language and Application Frameworks">
<p>Struts is written in the popular and versatile
<a
href="http://java.sun.com/docs/books/jls/first_edition/html/index.html";>Java
programming language</a>.
@@ -137,7 +143,8 @@
</subsection>
- <subsection name="0.5 JavaBeans" href="javabeans">
+ <a name="javabeans"/>
+ <subsection name="0.5 JavaBeans">
<p>Like many Java applications, most of the Struts objects are designed as
<a href="http://java.sun.com/products/javabeans/";>JavaBeans</a>. Following
the JavaBean design patterns makes
@@ -163,7 +170,8 @@
</subsection>
- <subsection name="0.5.1 Reflection and Introspection" href="reflection">
+ <a name="reflection"/>
+ <subsection name="0.5.1 Reflection and Introspection">
<p>
Reflection is the process of determining which member fields and methods
are available on an object.
@@ -192,7 +200,8 @@
</subsection>
- <subsection name="0.5.2 Maps" href="Maps">
+ <a name="maps"/>
+ <subsection name="0.5.2 Maps">
<p>
JavaBeans store data as properties and may act on that data through other
methods.
@@ -204,7 +213,8 @@
</subsection>
- <subsection name="0.5.3 DynaBeans" href="dynabeans">
+ <a name="dynabeans"/>
+ <subsection name="0.5.3 DynaBeans">
<p>
DynaBeans combine the extensibility of JavaBeans with the flexibility of a
Map.
@@ -236,7 +246,8 @@
</subsection>
- <subsection name="0.6 Properties Files and ResourceBundles"
href="resources">
+ <a name="resources"/>
+ <subsection name="0.6 Properties Files and ResourceBundles">
<p>Java applications, including web applications, are often configured
using
<a
href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/Properties.html";>Properties</a>
@@ -265,7 +276,8 @@
</subsection>
- <subsection name="0.7 Java Servlets" href="servlets">
+ <a name="servlets"/>
+ <subsection name="0.7 Java Servlets">
<p>
Since Java is an object-orientated language, the
<a href="http://www.novocode.com/doc/servlet-essentials/";>Java Servlet</a>
@@ -344,7 +356,8 @@
</subsection>
- <subsection name="0.7.1 Servlets and threads" href="threads">
+ <a name="threads"/>
+ <subsection name="0.7.1 Servlets and threads">
<p>
To boost performance, the container can multi-thread servlets.
@@ -366,7 +379,8 @@
</subsection>
- <subsection name="0.7.2 Servlet Context" href="context">
+ <a name="context"/>
+ <subsection name="0.7.2 Servlet Context">
<p>The <em>ServletContext</em> interface
[<code>javax.servlet.ServletContext</code>] defines a servlet's view of
the web application within which the servlet is running. It is
@@ -401,7 +415,8 @@
</subsection>
- <subsection name="0.7.3 Servlet Request" href="request">
+ <a name="request"/>
+ <subsection name="0.7.3 Servlet Request">
<p>Each request processed by a servlet is represented by a Java
interface, normally a <code>HttpServletRequest</code>
@@ -458,7 +473,8 @@
</subsection>
- <subsection name="0.7.4 Servlet Response" href="response">
+ <a name="response"/>
+ <subsection name="0.7.4 Servlet Response">
<p>The primary purpose of a servlet is to process an incoming
<a href="#request">Servlet Request</a>
[<code>javax.servlet.http.HttpServletRequest</code>]
@@ -520,7 +536,8 @@
</subsection>
- <subsection name="0.7.5 Filtering" href="filter">
+ <a name="filter"/>
+ <subsection name="0.7.5 Filtering">
<p>If you are using a servlet container based on version
<strong>2.3</strong> or later of the Servlet Specification (such as
@@ -551,7 +568,8 @@
</subsection>
- <subsection name="0.7.6 Sessions" href="session">
+ <a name="session"/>
+ <subsection name="0.7.6 Sessions">
<p>One of the key characteristics of HTTP is that it is
<em>stateless</em>. In other words, there is nothing built in to
@@ -607,7 +625,8 @@
</subsection>
- <subsection name="0.7.7 Dispatching Requests" href="dispatch">
+ <a name="dispatch"/>
+ <subsection name="0.7.7 Dispatching Requests">
<p>
The Java Servlet specification extends the HTTP request/response cycle
by allowing the request to be dispatched,
@@ -620,7 +639,8 @@
</subsection>
- <subsection name="0.7.8 Web Applications" href="webapp">
+ <a name="webapp"/>
+ <subsection name="0.7.8 Web Applications">
<p>
Just as a HTTP server can be used to host several distinct web sites,
@@ -642,7 +662,8 @@
</subsection>
- <subsection name="0.7.9 Web application deployment descriptor (web.xml)"
href="events">
+ <a name="events"/>
+ <subsection name="0.7.9 Web application deployment descriptor (web.xml)">
<p>
Most aspects of an application's lifecycle are configured through an XML
document called the Web application deployment descriptor.
@@ -660,7 +681,8 @@
</subsection>
- <subsection name="0.7.10 Security" href="security">
+ <a name="security"/>
+ <subsection name="0.7.10 Security" href="">
<p>
One detail that can be configured in the Web application deployment
descriptor is container-managed security.
@@ -679,7 +701,8 @@
</subsection>
- <subsection name="0.8 JavaServer Pages, JSP Tag Libraries, and Java Server
Faces" href="jsp">
+ <a name="jsp"/>
+ <subsection name="0.8 JavaServer Pages, JSP Tag Libraries, and Java Server
Faces" href="">
<p><a href="http://java.sun.com/products/jsp/product.html";>JavaServer
Pages</a> (JSPs) are
"inside-out servlets" that make it easier to create and maintain dynamic
web pages. Instead
of putting what you want to write to the HTTP response inside of a Java
<code>print</code>
@@ -766,7 +789,8 @@
</subsection>
- <subsection name="0.9 Extensible Markup Language (XML)" href="xml">
+ <a name="xml"/>
+ <subsection name="0.9 Extensible Markup Language (XML)" href="">
<p>The features provided by the Struts framework relies on a number of
objects that are
usually deployed using a configuration file written in
@@ -808,61 +832,54 @@
</subsection>
- <subsection name="0.10 Other layers" href="layers">
+ <a name="jaas"/>
+ <subsection name="0.10 JAAS" href="">
- <p>
- Struts provides the control layer for a web application. Developers can
use this layer with
- other standard technologies to provide the data access and presentation
layers. Some
- popular Data access technologies include:
- </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></li>
- <li><a
href="http://java.sun.com/products/jdbc/index.html";>JDBC</a></li>
- <li><a href="http://db.apache.org/ojb/";>Object Relational
Bridge</a></li>
- </ul>
-
- <p>
- Presentation layer technologies include:
- </p>
+ <p>
+ While Struts can work with any approach to user authentication and
authorization, Struts 1.1 and later offers
+ direct support for the standard Java Authentication and
Authorization Service (JAAS).
+ You can now specify security roles on an action-by-action basis.
+ </p>
- <ul>
- <li><a href="http://java.sun.com/products/jsp";>JavaServer
Pages</a></li>
- <li><a href="http://jakarta.apache.org/velocity/index.html";>Velocity
Templates</a></li>
- <li><a href="http://www.w3.org/TR/xslt";>XSL Transformations </a></li>
- </ul>
+ <p>For more about JAAS, see the <a
href="http://java.sun.com/products/jaas/index-14.html";>Javasoft product page</a>
+ and the <a
href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/WebAppSecurity.html";>
+ Web Application Security</a> chapter of the
+ <a
href="http://java.sun.com/webservices/docs/1.0/tutorial/index.html";>Java Web
Services Tutorial</a>.</p>
+ <p>
+ A popular extension for handling security in a Java web application,
including a Struts application,
+ is <a
href="http://securityfilter.sourceforge.net/";>SecurityFilter</a>.
+ </p>
</subsection>
- <subsection name="0.11 JAAS" href="jaas">
+ <a name="layers"/>
+ <subsection name="0.11 Other layers">
<p>
- While Struts can work with any approach to user authentication and
authorization, Struts 1.1 and later offers
- direct support for the standard Java Authentication and Authorization
Service (JAAS).
- You can now specify security roles on an action-by-action basis.
+ Struts Core provides the control layer for a web application.
+ Developers can use this layer with other standard technologies
+ to provide the business, data access, and presentation layers.
</p>
- <p>For more about JAAS, see the <a
href="http://java.sun.com/products/jaas/index-14.html";>Javasoft product page</a>
- and the <a
href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/WebAppSecurity.html";>
- Web Application Security</a> chapter of the
- <a
href="http://java.sun.com/webservices/docs/1.0/tutorial/index.html";>Java Web
Services Tutorial</a>.</p>
+ <p>
+ For more about creating business and data access layers,
+ see the "Building Model Components section".
+ </p>
<p>
- A popular extension for handling security in a Java web application,
including a Struts application,
- is <a href="http://securityfilter.sourceforge.net/";>SecurityFilter</a>.
+ For more about creating the presentation layer,
+ see the "Building View Components section".
</p>
+ </subsection>
-</subsection>
+</section>
-<subsection>
+<section>
<p class="right">
Next: <a href="introduction.html">Introduction</a>
</p>
-</subsection>
-
</section>
+
</body>
</document>
Modified: struts/site/trunk/xdocs/helping.xml
URL:
http://svn.apache.org/viewcvs/struts/site/trunk/xdocs/helping.xml?rev=280168&r1=280167&r2=280168&view=diff
==============================================================================
--- struts/site/trunk/xdocs/helping.xml (original)
+++ struts/site/trunk/xdocs/helping.xml Sun Sep 11 12:17:16 2005
@@ -554,6 +554,65 @@
</subsection>
+<a name="decides_help"/>
+<subsection name="How can I help make the decisions?">
+
+ <p>
+ A guiding principle of the Apache Software Foundation is
+ "them that do the work, make the decisions".
+ This phrase is actually a double-entendre.
+ A project will make some decisions by voting (very few),
+ but the real decisions are made when a volunteer actually does the
+ work.
+ Unless someone volunteers to do the work,
+ other decisions are meaningless.
+ </p>
+
+ <p>
+ In an ASF project, like Apache Struts,
+ volunteers who make sustained constributions to the project
+ are invited to become "Committers".
+ In due course, Committers are invited to join the Project Management
+ Committee (PMC).
+ A goal of the ASF is for all Committers to be on the PMC.
+ </p>
+
+ <p>
+ By "sustained", we mean that an individual has been active
+ in the project for at least six months.
+ The contributions should come in the form of both patches
+ (to code or documentation), and posts to the mailing lists.
+ Patches must be competent and accepted into the repository.
+ Posts must be consistently helpful, friendly, and collaborative.
+ The most important characteristic in a prospective Committer is an
+ amicable demeanor that fosters goodwill.
+ </p>
+
+ <p>
+ As PMC members take note of Struts developers who meet our
+ qualifications, one of us will call for a vote on the internal
+ PMC maining list.
+ (This usually happens when someone gets tired of applying
+ the volunteer's patches!)
+ The internal list is rarely used, and it is never used for
+ development discussions.
+ If the PMC vote passes, we will send the developer a invitation
+ privately, to give the individaul a chance to accept or discretely
+ decline.
+ If the candidate accepts,
+ the PMC will announce the new member on the dev list.
+ </p>
+
+ <p>
+ For more about decision-making, see
+ "<a href="http://apache.org/foundation/how-it-works.html";>
+ How the ASF Works</a>" and the
+ <a href="http://struts.apache.org/bylaws.html";>Apache Struts
+ Project Guidelines</a>.
+ </p>
+
+</subsection>
+
</section>
<section>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
