husted 2003/08/29 13:14:19 Modified: doc/news index.xml doc/proposals release-plan_1_2_0.xml doc/resources related.xml related_books.xml resources.xml sigs.xml taglibs.xml utilities.xml doc/userGuide index.xml preface.xml Log: Routine updates Revision Changes Path 1.27 +3 -0 jakarta-struts/doc/news/index.xml Index: index.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/news/index.xml,v retrieving revision 1.26 retrieving revision 1.27 diff -u -r1.26 -r1.27 --- index.xml 26 Jul 2003 03:56:24 -0000 1.26 +++ index.xml 29 Aug 2003 20:14:19 -0000 1.27 @@ -33,6 +33,9 @@ <li> See the <a href="http://cvs.apache.org/viewcvs/jakarta-struts/">Struts CVS</a> for the current development codebase. </li> + <li> + See the <a href="../releases.html">Release Guides</a> for our release process and coding conventions. + </li> </ul> <hr size="1" noshade=""/> 1.4 +5 -1 jakarta-struts/doc/proposals/release-plan_1_2_0.xml Index: release-plan_1_2_0.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/proposals/release-plan_1_2_0.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- release-plan_1_2_0.xml 29 Aug 2003 14:27:24 -0000 1.3 +++ release-plan_1_2_0.xml 29 Aug 2003 20:14:19 -0000 1.4 @@ -15,6 +15,10 @@ </p> <p> + THIS IS AN UNRATIFIED DRAFT DOCUMENT PROVIDED FOR DISCUSSION PURPOSES ONLY! + </p> + + <p> The objective of the <strong>Struts 1.2.0</strong> release is to provide an official version of all the changes that have been made to the main trunk of the jakarta-struts CVS since the release of Struts 1.1 Final. 1.2 +24 -22 jakarta-struts/doc/resources/related.xml Index: related.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/resources/related.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- related.xml 23 Jun 2002 15:08:10 -0000 1.1 +++ related.xml 29 Aug 2003 20:14:19 -0000 1.2 @@ -10,38 +10,40 @@ <chapter name="Struts Resources" href="http://husted.com/struts/resources"> <section name="Other Struts-Related Articles"> -<p><b>Web DbForms by Joachim Peer</b><br/> +<p><b>Web DbForms by Joachim Peer</b><br /> - <a href="http://www.onjava.com/lpt/a//onjava/2001/07/18/dbforms.html">http://www.onjava.com/lpt/a//onjava/2001/07/18/dbforms.html</a></p> -<p><b>Expresso Extends Struts through Integration Roadmap</b><br/> - - <a href="http://www.jcorporate.com/html/products/expresso.html">http://www.jcorporate.com/html/products/expresso.html</a> <br/> +<p><b>Expresso Extends Struts through Integration Roadmap</b><br /> + - <a href="http://www.jcorporate.com/html/products/expresso.html">http://www.jcorporate.com/html/products/expresso.html</a> <br /> - <a href="http://www.jcorporate.com/doc/roadmap.html">http://www.jcorporate.com/doc/roadmap.html</a></p> -<p><b>Dynamic Value Object</b> by raffaele spazzoli <br/> +<p><b>Dynamic Value Object</b> by raffaele spazzoli <br /> - <a href="http://www.theserverside.com/patterns/thread.jsp?thread_id=2722">http://www.theserverside.com/patterns/thread.jsp?thread_id=2722</a></p> -<p><b>Coarse Grained BMP beans with Dependent Value Objects</b> by Floyd Marinescu<br/> +<p><b>Coarse Grained BMP beans with Dependent Value Objects</b> by Floyd Marinescu<br /> - <a href="http://www.theserverside.com/patterns/depbmp.jsp">http://www.theserverside.com/patterns/depbmp.jsp</a></p> -<p><b>View Helper</b> - Design patterns<br/> +<p><b>View Helper</b> - Design patterns<br /> - <a href="http://developer.java.sun.com/developer/restricted/patterns/ViewHelper.html">http://developer.java.sun.com/developer/restricted/patterns/ViewHelper.html</a></p> -<p><b>Ruby Web Application Framework</b> - A framework for developing web/wap applications founded in the Ruby programming language, based on the Jakarta Struts project.<br/> +<p><b>Ruby Web Application Framework</b> - A framework for developing web/wap applications founded in the Ruby programming language, based on the Jakarta Struts project.<br /> - <a href="http://sourceforge.net/projects/ruby-waf/">http://sourceforge.net/projects/ruby-waf/</a></p> -<p><b>Building Web Applications in Java </b> - by Brad Cox<br/> - - <a href="http://virtualschool.edu/wap/html/problem.html">http://virtualschool.edu/wap/index.html</a><br/> +<p><b>Building Web Applications in Java </b> - by Brad Cox<br /> + - <a href="http://virtualschool.edu/wap/html/problem.html">http://virtualschool.edu/wap/index.html</a><br /> - overview of article: <a href="http://www.mail-archive.com/[EMAIL PROTECTED]/msg08555.html">http://www.mail-archive.com/struts-user%40jakarta.apache.org/msg08555.html</a></p> -<p><b>Doclet your Servlet</b> by Jeremy Roschelle </p> -<p>- <a href="http://www.javaworld.com/javaworld/jw-03-2001/jw-0302-doclets.html">http://www.javaworld.com/javaworld/jw-03-2001/jw-0302-doclets.html</a></p> -<p><b>You make the decision</b> (JSP/Struts or Velocity/Turbine) by Jon Stevens.</p> -<p>- <a href="http://jakarta.apache.org/velocity/ymtd/ymtd.html">http://jakarta.apache.org/velocity/ymtd/ymtd.html</a></p> -<p><b>Get disconnected with CachedRowSet</b> by Taylor G. Cowan <br/> +<p><b>Doclet your Servlet</b> by Jeremy Roschelle<br /> + - <a href="http://www.javaworld.com/javaworld/jw-03-2001/jw-0302-doclets.html">http://www.javaworld.com/javaworld/jw-03-2001/jw-0302-doclets.html</a></p> +<p><b>You make the decision</b> (JSP/Struts or Velocity/Turbine) by Jon Stevens.<br /> + - <a href="http://jakarta.apache.org/velocity/ymtd/ymtd.html">http://jakarta.apache.org/velocity/ymtd/ymtd.html</a></p> +<p><b>Get disconnected with CachedRowSet</b> by Taylor G. Cowan <br /> - <a href="http://www.javaworld.com/javaworld/jw-02-2001/jw-0202-cachedrow.html">http://www.javaworld.com/javaworld/jw-02-2001/jw-0202-cachedrow.html</a></p> -<p><b>Incremental development with Ant and JUnit</b> by Malcolm Davis<br/> +<p><b>Incremental development with Ant and JUnit</b> by Malcolm Davis<br /> - <a href="http://www-106.ibm.com/developerworks/library/j-ant/?dwzone=java">http://www-106.ibm.com/developerworks/library/j-ant/?dwzone=java</a></p> -<p><b>A MVC Framework from Kevin Duffy<br/> - </b><a href="http://www.brainopolis.com/jsp/mvc/KDuffey_MVC.html">http://www.brainopolis.com/jsp/mvc/KDuffey_MVC.html</a></p> -<p><b>Encapsulate reusable functionality in JSP</b> by Simon Brown<br/> - <a href="http://www.javaworld.com/javaworld/jw-08-2000/jw-0811-jsptags.html">http://www.javaworld.com/javaworld/jw-08-2000/jw-0811-jsptags.html</a></p> -<p>[ opinion ] <b>Freeware: Is it really worth it? </b>by Anil Hemrajani - <a href="http://www.javaworld.com/javaworld/jw-11-2000/jw-1103-soapbox.html#resources">http://www.javaworld.com/javaworld/jw-11-2000/jw-1103-soapbox.html#resources</a></p> -<p><b>Solve your servlet-based presentation problems </b>by Kevin Unger <br/> +<p><b>A MVC Framework from Kevin Duffy<br /> + - </b><a href="http://www.brainopolis.com/jsp/mvc/KDuffey_MVC.html">http://www.brainopolis.com/jsp/mvc/KDuffey_MVC.html</a></p> +<p><b>Encapsulate reusable functionality in JSP</b> by Simon Brown<br /> + - <a href="http://www.javaworld.com/javaworld/jw-08-2000/jw-0811-jsptags.html">http://www.javaworld.com/javaworld/jw-08-2000/jw-0811-jsptags.html</a></p> +<p>[ opinion ] <b>Freeware: Is it really worth it? </b>by Anil Hemrajani<br /> + - <a href="http://www.javaworld.com/javaworld/jw-11-2000/jw-1103-soapbox.html#resources">http://www.javaworld.com/javaworld/jw-11-2000/jw-1103-soapbox.html#resources</a></p> +<p><b>Solve your servlet-based presentation problems </b>by Kevin Unger <br /> - <a href="http://www.javaworld.com/javaworld/jw-11-2000/jw-1103-presentation_p.html">http://www.javaworld.com/javaworld/jw-11-2000/jw-1103-presentation_p.html</a></p> -<p><b>Template Resolution in XML/HTML</b> by Anders Kristensen<b> - </b><a href="http://www-uk.hpl.hp.com/people/ak/doc/trix-tr.html">http://www-uk.hpl.hp.com/people/ak/doc/trix-tr.html</a></p> +<p><b>Template Resolution in XML/HTML</b> by Anders Kristensen<b> <br /> + - </b><a href="http://www-uk.hpl.hp.com/people/ak/doc/trix-tr.html">http://www-uk.hpl.hp.com/people/ak/doc/trix-tr.html</a></p> <p><a href="http://www.javaworld.com/javaworld/jw-12-1999/jw-12-ssj-jspmvc.html"><b>Understanding JavaServer Pages Model 2 architecture</b></a> by Govind Seshadri</p> <p><a href="http://www.servlets.com/soapbox/problems-jsp.html"><b>The Problem with JSP</b></a> by Jason Hunter</p> </section> 1.5 +9 -6 jakarta-struts/doc/resources/related_books.xml Index: related_books.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/resources/related_books.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- related_books.xml 15 Feb 2003 21:00:51 -0000 1.4 +++ related_books.xml 29 Aug 2003 20:14:19 -0000 1.5 @@ -11,6 +11,8 @@ <section name="Other Development Books"> <p><b>Java Development</b></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=1930110995/hitchhikeguidetoA/">JUnit in Action</a></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=047120708X/hitchhikeguidetoA/">Java Tools for Extreme Programming</a></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=193011043X/hitchhikeguidetoA/">Bitter Java</a></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=0521777682/hitchhikeguidetoA/">Elements of Java Style</a></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=0201310058/hitchhikeguidetoA/">Effective Java</a></p> @@ -18,20 +20,21 @@ <p><a href="http://www.amazon.com/exec/obidos/ISBN=0130819336/hitchhikeguidetoA/">Core Java 2, Volume 1 Fundamentals</a></p> <p><b>Java Web Development</b></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=0131422464/hitchhikeguidetoA/">Core J2EE Patterns: Best Practices and Design Strategies, Second Edition</a> <i>- Recommended!</i></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=1930110588/hitchhikeguidetoA/">Java Development with Ant</a> by Erik Hatcher and Steve Loughran <i>- To be released in July 2002</i></p> -<p><a href="http://www.amazon.com/exec/obidos/ISBN=1930110529/hitchhikeguidetoA/">JSTL in Action</a> by Shawn Bayern <i>- Released in June 2002</i></p> -<p><a href="http://www.amazon.com/exec/obidos/ISBN=0130648841/hitchhikeguidetoA/">Core J2EE Patterns</a></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=1930110529/hitchhikeguidetoA/">JSTL in Action</a> by Shawn Bayern</p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=193011009X/hitchhikeguidetoA/">JSP Tag Libraries</a></p> -<p><a href="http://www.amazon.com/exec/obidos/ISBN=1893115364/hitchhikeguidetoA/">Apache-Jakarta Tomcat by James Goodwill</a></p> -<p><a href="http://www.amazon.com/exec/obidos/ISBN=1884777996/hitchhikeguidetoA/">Web Development with JavaServer Pages 2nd Edition</a></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=1893115364/hitchhikeguidetoA/">Apache-Jakarta Tomcat</a></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=1884777996/hitchhikeguidetoA/">Web Development with JavaServer Pages, 2nd Edition</a></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=0130882488/hitchhikeguidetoA/">Core JSP</a></p> <p><b>Software Development</b></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=158880173X/hitchhikeguidetoA/">Open Source Development with CVS</a></p> <p><b>Software Engineering</b></p> -<p><a href="http://www.amazon.com/exec/obidos/ISBN=0321146530/hitchhikeguidetoA/">Test Driven Development</a></p> -<p><a href="http://www.amazon.com/exec/obidos/ISBN=0321127420/hitchhikeguidetoA/">Patterns in Enterprise Application Architecturee</a> <i>- Highly recommended!</i></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=0321146530/hitchhikeguidetoA/">Test Driven Development by Example</a></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=020161622X/hitchhikeguidetoA/">The Pragmatic Programmer: From Journeyman to Master</a></p> +<p><a href="http://www.amazon.com/exec/obidos/ISBN=0321127420/hitchhikeguidetoA/">Patterns in Enterprise Application Architecture</a> <i>- Highly recommended!</i></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=0201485672/hitchhikeguidetoA/">Refactoring: Improving the Design of Existing Code</a> <i>- Read me second!</i></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=0672316498/hitchhikeguidetoA/">The Inmates Are Running the Asylum: Why High Tech Products Drive Us Crazy and How To Restore The Sanity</a></p> <p><a href="http://www.amazon.com/exec/obidos/ISBN=1884777597/hitchhikeguidetoA/">Practical Software Requirements</a></p> 1.2 +10 -8 jakarta-struts/doc/resources/resources.xml Index: resources.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/resources/resources.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- resources.xml 23 Jun 2002 15:08:10 -0000 1.1 +++ resources.xml 29 Aug 2003 20:14:19 -0000 1.2 @@ -9,14 +9,16 @@ <body> <chapter name="Struts Resources" href="http://husted.com/struts/resources"> -<section name="Other Resource Pages"> -<p><a href="http://www.multitask.com.au/default.html?page=mtSOS"><b>Struts SOS</b> (fee-based)</a></p> -<p><a href="http://www.ingrid.org/jajakarta/struts/"><b>Japanese Translation of Struts documentation</b></a> as well as the other Jakarta projects).</p> -<p><b>Struts and Jakarta mailing lists in Japanese</b> - <a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a> and <a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a></p> -<p><a href="http://www.jguru.com/faq/home.jsp?topic=Struts"><b>JGuru FAQ</b></a></p> -<p><a href="http://husted.com/struts/"><b>More About Struts</b></a> by <a href="mailto:[EMAIL PROTECTED]">Husted dot Com</a>.</p> -<p><a href="http://java.sun.com/docs/books/tutorial/"><b>Javasoft Tutorials</b></a></p> -<p><a href="http://archives.java.sun.com"><b>Javasoft Mailing Lists</b></a></p> +<section name="Other Resource Pages"> + + <p><a href="http://www.ingrid.org/jajakarta/struts/"><b>Japanese Translation of Struts documentation</b></a> (as well as the other Jakarta projects).</p> + <p><a href="http://archives.java.sun.com"><b>Javasoft Mailing Lists</b></a></p> + <p><a href="http://java.sun.com/docs/books/tutorial/"><b>Javasoft Tutorials</b></a></p> + <p><a href="http://www.jguru.com/faq/home.jsp?topic=Struts"><b>JGuru FAQ</b></a> and <a href="http://www.jguru.com/forums/Struts">Forum</a></p> + <p><b>Struts and Jakarta mailing lists in Japanese</b> - <a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a> and <a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a></p> + <p><a href="http://www.multitask.com.au/default.html?page=mtSOS"><b>Struts SOS</b> (fee-based)</a></p> + <p><a href="http://husted.com/struts/"><b>More About Struts</b></a> by <a href="mailto:[EMAIL PROTECTED]">Husted dot Com</a>.</p> + </section> </chapter></body></document> 1.4 +31 -17 jakarta-struts/doc/resources/sigs.xml Index: sigs.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/resources/sigs.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- sigs.xml 12 Aug 2003 03:10:02 -0000 1.3 +++ sigs.xml 29 Aug 2003 20:14:19 -0000 1.4 @@ -9,22 +9,36 @@ <body> <chapter name="Struts Resources" href="http://husted.com/struts/resources"> -<section name="Special Interest Groups"> -<p><b>Local</b></p> -<p><a href="http://www.struts-atlanta.org/"> -<b>Atlanta Struts Users Group</b></a> - The Atlanta Struts Users Group (ASUG) -is a free, informal, all-volunteer, technically-savvy group of Atlanta Struts -enthusiasts, professionals and zealots who keep each other informed about -issues and innovations in the Struts Framework. Come to the meetings and -contribute!</p> -<p><a href="http://www.baychi.org/bof/struts"> -<b>Silicon Valley Struts User Group</b></a> - The Silicon Valley Struts User -Group (SVSUG) meets on the first Wednesday of the month at various locations -in the south bay. All levels of Struts user experience are welcome. Meetings -are free and open to all.</p> -<p><b>Online</b></p> -<p><a href="http://groups.yahoo.com/group/model_struts/"><b>Model Layer in MVC (Struts)</b></a>. </p> -<p><a href="http://www.basebeans.com:8081/mailman/listinfo/mvc-programmers"><b>MVC Programmers</b></a>. </p> -</section> + <section name="Special Interest Groups"/> + + <section name="Local"> + + <p> + <a href="http://www.struts-atlanta.org/"><b>Atlanta Struts Users Group</b></a> - The Atlanta Struts Users + Group (ASUG) is a free, informal, all-volunteer, technically-savvy group of Atlanta Struts enthusiasts, + professionals and zealots who keep each other informed about issues and innovations in the Struts Framework. + Come to the meetings and contribute! + </p> + + <p> + <a href="http://www.baychi.org/bof/struts"><b>Silicon Valley Struts User Group</b></a> - The Silicon Valley + Struts User Group (SVSUG) meets on the first Wednesday of the month at various locations in the south bay. + All levels of Struts user experience are welcome. + Meetings are free and open to all. + </p> + + </section> + + <section name="Online"> + + <p> + <a href="http://groups.yahoo.com/group/model_struts/"><b>Model Layer in MVC (Struts)</b></a>. + </p> + + <p> + <a href="http://www.basebeans.com:8081/mailman/listinfo/mvc-programmers"><b>MVC Programmers</b></a>. + </p> + + </section> </chapter></body></document> 1.4 +0 -1 jakarta-struts/doc/resources/taglibs.xml Index: taglibs.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/resources/taglibs.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- taglibs.xml 26 Jul 2003 03:56:26 -0000 1.3 +++ taglibs.xml 29 Aug 2003 20:14:19 -0000 1.4 @@ -10,7 +10,6 @@ <chapter name="Struts Resources" href="http://husted.com/struts/resources"> <section name="Contributor Taglibs"> -<p><a href="http://ultrawork.org/wtk/index.html"><b>Web Toolkit</b></a> - provides a component-based approach to building markup-driven applications (not Struts specific). Alternative to the Template and Tiles taglibs.</p> <p><a href="http://www.keyboardmonkey.com/next"><b>Nested Taglib</b></a> [Also included in Struts 1.1] by Arron Bates - More efficient markup of beans and their nested children (linked site provides library for previous struts versions).</p> <p><a href="http://www.mycgiserver.com/~eboudrant/#regexp"><font size="2"><b>REGEXP.VALIDATOR.STRUTS</b></font></a> by Emmanuel Boudrant - A validation component that works with Struts 1.0, to manage form validation on server-side and client-side. </p> <p><a href="http://husted.com/struts/resources/struts-was.zip"><b>Struts-WAS.jar</b></a> by Christopher Assenza - Modified Struts 1.0 JAR for Websphere 3.5 or 4. Zipped for download. <font size="1"> (For additional tips regarding Websphere 3.5 see <a href="../userGuide/installation-was352-x.html">http://jakarta.apache.org/struts/installation-was352-x.html</a>.)</font></p> 1.3 +23 -7 jakarta-struts/doc/resources/utilities.xml Index: utilities.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/resources/utilities.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- utilities.xml 24 Jun 2002 00:51:32 -0000 1.2 +++ utilities.xml 29 Aug 2003 20:14:19 -0000 1.3 @@ -10,13 +10,29 @@ <chapter name="Struts Resources" href="http://husted.com/struts/resources"> <section name="Other Struts-Related Utilities"> -<p><a href="http://www.basebeans.com/downloads.jsp"><b>webPIM</b></a> - Sample Struts 1.1 DB Master Detail CRUD Web App that includes Tiles, Validation, Menu, etc. and implements sample designs.</p> -<p><a href="http://edhill.its.uiowa.edu/display/"><b>The <display:*> tag library</b></a></p> -<p><a href="http://dbforms.org/"><b>dbForms</b></a> - RAD framework for database applications.</p> -<p><a href="http://jsptags.com/tags/navigation/pager/"><b>Pager Tag Library</b></a> - helps generate Google and AltaVista style search result navigators. It will -take multiple pages worth of information, dynamically split it up into page sized pieces and generate -a browsable index. It does this in a flexible way that allows designers to give the index just about any -look desired.</p> + + <p> + <a href="http://ultrawork.org/wtk/index.html"><b>Web Toolkit</b></a> - provides a component-based approach to + building markup-driven applications (not Struts specific). Alternative to the Template and Tiles taglibs. + </p> + + <p> + <a href="http://edhill.its.uiowa.edu/display/"><b>The <display:*> tag library</b></a> - An open source suite + of custom tags that provide high level web presentation patterns (like tables, tabs, templates, inspectors, + trees, etc...) + </p> + + <p> + <a href="http://dbforms.org/"><b>dbForms</b></a> - RAD framework for database applications. + </p> + + <p> + <a href="http://jsptags.com/tags/navigation/pager/"><b>Pager Tag Library</b></a> - helps generate Google and + AltaVista style search result navigators. It will take multiple pages worth of information, dynamically split + it up into page sized pieces and generate a browsable index. It does this in a flexible way that allows + designers to give the index just about any look desired. + </p> + </section> </chapter></body></document> 1.38 +0 -3 jakarta-struts/doc/userGuide/index.xml Index: index.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/userGuide/index.xml,v retrieving revision 1.37 retrieving revision 1.38 diff -u -r1.37 -r1.38 --- index.xml 29 Aug 2003 14:27:25 -0000 1.37 +++ index.xml 29 Aug 2003 20:14:19 -0000 1.38 @@ -189,9 +189,6 @@ <p align="right"> Next: <a href="preface.html">Preface</a> </p> - <p align="right"> - Comments? <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?StrutsDocComments">Post them to the Wiki!</a> - </p> </section> </body> 1.20 +96 -94 jakarta-struts/doc/userGuide/preface.xml Index: preface.xml =================================================================== RCS file: /home/cvs/jakarta-struts/doc/userGuide/preface.xml,v retrieving revision 1.19 retrieving revision 1.20 diff -u -r1.19 -r1.20 --- preface.xml 19 Jan 2003 00:40:41 -0000 1.19 +++ preface.xml 29 Aug 2003 20:14:19 -0000 1.20 @@ -32,14 +32,14 @@ </ul> <p> - This chapter briefly defines each of these technologies but does not describe them in detail. + This chapter briefly defines each of these technologies but does not describe them in detail. For your convenience, links to further information are provided if you would like to learn more about a technology. </p> <p><a target="#Java Web Services Tutorial"></a>If you are familiar with Java, but not these technologies, the best overall starting point is <a href="http://java.sun.com/webservices/docs/1.0/tutorial/index.html"><b>The Java Web Services Tutorial</b></a>. - This is also available for download in + This document is also available for download in <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/JavaWSTutorial.pdf">PDF</a> format. </p> @@ -165,14 +165,14 @@ <section name="0.5.1 Reflection and Introspection" href="reflection"> <p> - Reflection is the process of determining which member fields and methods are available on an object. - Introspection is a specialized form of reflection used by the JavaBean API. - Using Introspection, we can determine which methods of a JavaBean are intended to be accessed by other objects. + Reflection is the process of determining which member fields and methods are available on an object. + Introspection is a specialized form of reflection used by the JavaBean API. + Using Introspection, we can determine which methods of a JavaBean are intended to be accessed by other objects. (The getters and the setters, for example.) </p> <p> - The Struts framework uses Introspection to convert HTTP parameters into JavaBean properties and to populate HTML fields from JavaBean properties. + The Struts framework uses Introspection to convert HTTP parameters into JavaBean properties and to populate HTML fields from JavaBean properties. This technique makes it easy to "roundtrip" properties between HTML forms and JavaBeans. </p> @@ -194,11 +194,11 @@ <section name="0.5.2 Maps" href="Maps"> <p> - JavaBeans store data as properties and may act on that data through other methods. - JavaBeans are flexible and powerful objects but are not the only object that programmers use to store data. - Another popular object is the Map [<code>java.util.Map</code>]. - A Map is a simple collection of name and value pairs. - Maps are often used "behind the scenes" as a flexible way to store dynamic data. + JavaBeans store data as properties and may act on that data through other methods. + JavaBeans are flexible and powerful objects but are not the only object that programmers use to store data. + Another popular object is the Map [<code>java.util.Map</code>]. + A Map is a simple collection of name and value pairs. + Maps are often used "behind the scenes" as a flexible way to store dynamic data. </p> </section> @@ -206,25 +206,27 @@ <section name="0.5.3 DynaBeans" href="dynabeans"> <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. + 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> - In a Struts 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. + In a Struts 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 + For more about DynaBeans, see </p> <ul> <li> - <a href="http://jakarta.apache.org/commons/beanutils/api/index.html">The Commons BeanUtils Javadocs</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> </ul> @@ -261,36 +263,36 @@ <section name="0.7 Java Servlets" href="servlets"> <p> - Since Java is an object-orientated language, the - <a href="http://java.sun.com/products/servlet/">Java Servlet</a> - platform strives to cast HTTP into an object-orientated form. - This strategy makes it easier for Java developers to concentrate on what they need their application to do -- + Since Java is an object-orientated language, the + <a href="http://java.sun.com/products/servlet/">Java Servlet</a> + platform strives to cast HTTP into an object-orientated form. + This strategy makes it easier for Java developers to concentrate on what they need their application to do -- rather than the mechanics of HTTP. </p> - + <p> - HTTP provides a standard mechanism for extending servers called the Common Gateway Interface, or CGI. + HTTP provides a standard mechanism for extending servers called the Common Gateway Interface, or CGI. The server can pass a request to a CGI-aware program, and the program will pass back a response. - Likewise, a Java-aware server can pass a request to a servlet container. + Likewise, a Java-aware server can pass a request to a servlet container. The container can fulfill the request or it can pass the request back to the HTTP server. - The container decides whether it can handle the request by checking its list of servlets. + The container decides whether it can handle the request by checking its list of servlets. If there is a servlet registered for the request, the container passes the request to the servlet. </p> - + <p> - When a request comes in, the container checks to see if there is a servlet registered for that request. - If there is a match, - the request is given to the servlet. + When a request comes in, the container checks to see if there is a servlet registered for that request. + If there is a match, + the request is given to the servlet. If not, the request is returned to the HTTP server. </p> - + <p> It's the container's job to manages the servlet lifecycle. - The container creates the servlets, invokes the servlets, and ultimately disposes the servlets. - </p> + The container creates the servlets, invokes the servlets, and ultimately disposes the servlets. + </p> <p> - A servlet is generally a subclass of <code>javax.servlet.http.HttpServlet</code>. + A servlet is generally a subclass of <code>javax.servlet.http.HttpServlet</code>. A servlet must implement four methods, which are invoked by the container as needed: </p> @@ -311,16 +313,16 @@ such as when a web application is being undeployed or when the entire container is being shut down.</li> </ul> - + <p> - Struts provides a ready-to-use servlet for your application [<code>org.apache.struts.action.ActionServlet</code>]. - As a Struts developer, you can then just write objects that the Struts ActionServlet calls when needed. - But it is still helpful to understand the basics of what servlets are, + Struts provides a ready-to-use servlet for your application [<code>org.apache.struts.action.ActionServlet</code>]. + As a Struts developer, you can then just write objects that the Struts ActionServlet calls when needed. + But it is still helpful to understand the basics of what servlets are, and the role they play in a Java web application. </p> - + <p> - For more about Java Servlets, see: + For more about Java Servlets, see: </p> <ul> @@ -337,21 +339,21 @@ </ul> </section> - + <section name="0.7.1 Servlets and threads" href="threads"> <p> - To boost performance, the container can multi-thread servlets. - Only one instance of a particular servlet is created, - and each request for that servlet passes through the same object. - This strategy helps the container make the best use of available resources. + To boost performance, the container can multi-thread servlets. + Only one instance of a particular servlet is created, + and each request for that servlet passes through the same object. + This strategy helps the container make the best use of available resources. The tradeoff is that the servlet's <code>doGet()</code> and <code>doPost()</code> methods must be programmed in a <em>thread-safe</em> manner. </p> - + <p> For more about servlets and thread-safety, see: </p> - + <ul> <li> <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/Servlets5.html#64386">Controlling Concurrent Access to Shared Resources</a> in Java Web Services Tutorial. @@ -386,7 +388,7 @@ <p> For more about the servlet context, see: </p> - + <ul> <li> <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/Servlets10.html#64724">Accessing the Web Context</a> in Java Web Services Tutorial. @@ -443,7 +445,7 @@ <p> For more about the servlet request, see: </p> - + <ul> <li> <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/Servlets7.html#64433">Getting Information from Requests</a> in Java Web Services Tutorial. @@ -486,39 +488,39 @@ already been sent will not be effective.</p> <p> - When you are using presentation pages in a Model 2 application, - you will not generally use the servlet response APIs directly. + When you are using presentation pages in a Model 2 application, + you will not generally use the servlet response APIs directly. In the case of JavaServerPages, the JSP page compiler in your servlet container will convert your page into a servlet. The JSP servlet renders the response, interspersing dynamic information where you have interposed JSP custom tags. </p> - + <p> - Other presentation systems, like Velocity Tools for Struts, - may delegate rendering the response to a specialized servlet, - but the same pattern holds true. - You create a template, + Other presentation systems, like Velocity Tools for Struts, + may delegate rendering the response to a specialized servlet, + but the same pattern holds true. + You create a template, and the dynamic response is generated automatically from the template. </p> - + <p> For more about the servlet response, see: </p> - + <ul> <li> <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/Servlets7.html#64531">Constructing Responses</a> in Java Web Services Tutorial. </li> </ul> - + </section> <section name="0.7.5 Filtering" href="filter"> <p>If you are using a servlet container based on version <strong>2.3</strong> or later of the Servlet Specification (such as - Tomcat 4.x), you can take advantage of the new Filter APIs + Tomcat 4.x), you can take advantage of the new Filter APIs [<code>javax.servlet.Filter</code>] that let you compose a set of components that will process a request or response. Filters are aggregated into a chain in which each filter @@ -533,7 +535,7 @@ container. It is very likely that future versions of Struts will require a Servlet 2.3 or later container, so that Struts itself can utilize filters.</p> - + <p> For more about filters, see: </p> @@ -587,10 +589,10 @@ simultaneous users, you will likely want to minimize your use of session attributes, in an effort to control the overall amount of memory required to support your application.</p> - + <p> For more about sessions, see: - </p> + </p> <ul> <li> <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/Servlets11.html#64744">Maintaining Client State</a> in Java Web Services Tutorial @@ -605,11 +607,11 @@ <section name="0.7.7 Dispatching Requests" href="dispatch"> <p> - The Java Servlet specification extends the HTTP request/response cycle by allowing the request to be dispatched, - or forwarded, between resources. - Struts uses this feature to pass a request through specialized components, - each handling one aspect of the response. - In the normal course, a request may pass through a controller object, a model object, + The Java Servlet specification extends the HTTP request/response cycle by allowing the request to be dispatched, + or forwarded, between resources. + Struts uses this feature to pass a request through specialized components, + each handling one aspect of the response. + In the normal course, a request may pass through a controller object, a model object, and finally to a view object as part of a single request/response cycle. </p> @@ -618,17 +620,17 @@ <section name="0.7.8 Web Applications" href="webapp"> <p> - Just as a HTTP server can be used to host several distinct web sites, - a servlet container can be used to host more than one web application. + Just as a HTTP server can be used to host several distinct web sites, + a servlet container can be used to host more than one web application. The Java servlet platform provides a well-defined mechanism for organizing and deploying web applications. - Each application runs in its own namespace so that they can be developed and deployed separately. - A web application can be assembled into a Web Application Archive, or WAR file. - The single WAR can be uploaded to the server and automatically deployed. + Each application runs in its own namespace so that they can be developed and deployed separately. + A web application can be assembled into a Web Application Archive, or WAR file. + The single WAR can be uploaded to the server and automatically deployed. </p> - + <p> For more about web applications, see: - </p> + </p> <ul> <li> <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/WebApp.html#76431">Web Applications</a> in Java Web Services Tutorial @@ -640,29 +642,29 @@ <section name="0.7.9 Web application deployment descriptor (web.xml)" href="events"> <p> - Most aspects of an application's lifecycle are configured through an XML document called the Web application deployment descriptor. - The schema of the descriptor, or web.xml, is given by the Java servlet specification. + Most aspects of an application's lifecycle are configured through an XML document called the Web application deployment descriptor. + The schema of the descriptor, or web.xml, is given by the Java servlet specification. </p> - + <p> For more about the web.xml and application lifecycle events, see: - </p> + </p> <ul> <li> <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/WebApp2.html#64550">Web Application Life Cycle</a> in Java Web Services Tutorial </li> </ul> - + </section> <section name="0.7.10 Security" href="security"> <p> - One detail that can be configured in the Web application deployment descriptor is container-managed security. - Declarative security can be used to protect requests for URIs that match given patterns. - Pragmatic security can be used to fine-tune security make authorization decisions based on the time of day, + One detail that can be configured in the Web application deployment descriptor is container-managed security. + Declarative security can be used to protect requests for URIs that match given patterns. + Pragmatic security can be used to fine-tune security make authorization decisions based on the time of day, the parameters of a call, or the internal state of a Web component. - It can also be used to restrict authentication based on information in a database. + It can also be used to restrict authentication based on information in a database. </p> <p>For more information about container-managed security, see:</p> @@ -747,20 +749,20 @@ <a href="http://java.sun.com/webservices/docs/1.0/tutorial/doc/JAXPIntro.html">Java API for XML Processing</a> in the Java Web Services Tutorial. While the framework makes good use of this API internally, it is not something most Struts developers would use when writing their own applications.</p> - - </section> + + </section> <section name="0.9.1 Descriptors" href="descriptors"> <p> - When Java applications use XML configuration files, + When Java applications use XML configuration files, the elements are most often used as <em>descriptors</em>. - The application does not use the XML elements directly. + The application does not use the XML elements directly. The elements are used to create and configure (or deploy) Java objects. </p> - + <p> - The Java Servlet platform uses an XML configuration file to deploy servlets (among other things). + The Java Servlet platform uses an XML configuration file to deploy servlets (among other things). Likewise, Struts uses an XML configuration file to deploy objects used by the framework. </p> @@ -796,7 +798,7 @@ Other <a href="../resources/models.html">data access</a> and <a href="../resources/views.html">presentation</a> systems are listed in the Struts <a href="../resources/">Resource Guide</a>. </p> - + </section> <section name="0.11 JAAS" href="jaas">
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]