cvs commit: jakarta-struts/doc/news news_2002_q2.xml

[rleland]

rleland 2002/11/30 17:24:22

  Modified:doc/news news_2002_q2.xml
  Log:
  Remove Link
  
  Revision  ChangesPath
  1.2   +0 -11 jakarta-struts/doc/news/news_2002_q2.xml
  
  Index: news_2002_q2.xml
  ===
  RCS file: /home/cvs/jakarta-struts/doc/news/news_2002_q2.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- news_2002_q2.xml  6 Nov 2002 22:48:13 -   1.1
  +++ news_2002_q2.xml  1 Dec 2002 01:24:22 -   1.2
  @@ -97,17 +97,6 @@
   
   
   
  -
  -23 June 2002 - Struts Controller UML Diagrams
  -
  -The goal of this article is to illustrate the Struts 1.1 Controller with UML 
diagrams. This article is an introduction to the Struts framework in order to help 
beginners programmers to understand the MVC model 2.
  -
  -
  -http://rollerjm.free.fr/pro/Struts.html";>http://rollerjm.free.fr/pro/Struts.html
  -
  -
  -
  -
   12 June 2002 - Struts Console version 1.12.1
   
   Struts Console version 1.12.1 is now available.
  
  
  

--
To unsubscribe, e-mail:   
For additional commands, e-mail: 

cvs commit: jakarta-struts/doc/userGuide building_view.xml index.xml

[dmkarr]

dmkarr  2002/11/30 14:25:17

  Modified:doc/faqs index.xml
   doc/userGuide building_view.xml index.xml
  Added:   doc/faqs indexedprops.xml
  Log:
  Added detailed FAQ on indexed & mapped properties, and indexed tags.  Added
  short section to user guide mentioning indexed/mapped properties, providing
  link to new FAQ.
  
  I'd appreciate it if people familiar with this area would review this
  documentation.
  
  Revision  ChangesPath
  1.5   +1 -0  jakarta-struts/doc/faqs/index.xml
  
  Index: index.xml
  ===
  RCS file: /home/cvs/jakarta-struts/doc/faqs/index.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- index.xml 29 Nov 2002 21:24:49 -  1.4
  +++ index.xml 30 Nov 2002 22:25:16 -  1.5
  @@ -22,6 +22,7 @@
   Using the SSL protocol
   Installing the Eclipse IDE
   Installing the Netbeans IDE
  +Indexed Properties, Mapped Properties, and 
Indexed Tags

   
   
  
  
  
  1.1  jakarta-struts/doc/faqs/indexedprops.xml
  
  Index: indexedprops.xml
  ===
  
  
  
   
David M. Karr
Indexed Properties, Mapped Properties, and Indexed Tags
   
   

 
  
   The JSP specification discusses using "indexed properties" in reference to
   the  tag.  However, none of the support provided in
   the base JSP specification actually deals with the "indexing" part.  In
   truth, it allows for setting "array properties", but it doesn't do much
   for setting or even getting the actual values in each entry of the array,
   except in explicit scriptlet expressions (which are always allowed, but
   not recommended).
  
  
   The Struts framework provides much more powerful features related to
   indexed properties, but in truth most of the heavy lifting is not even in
   the Struts framework, but in the Jakarta Commons Beanutils package.  This
   package is used by Struts to provide this functionality.  You can see the
   javadoc documentation for the Beanutils package at http://jakarta.apache.org/commons/beanutils/api/index.html";>http://jakarta.apache.org/commons/beanutils/api/index.html.
   The information particularly related to indexed properties is in the
   package description for the org.apache.commons.beanutils package.  This
   article mirrors that information, but focuses on how this functionality is
   mapped to JSP tags using the Struts tag library.
  
  
   The support for indexed properties also includes "mapped properties",
   "nested properties" and "indexed tags", which are all related but slightly
   different.  The latter is exclusive to Struts, but the first two are also
   provided by the Beanutils package.  This article will cover all three of
   these topics.
  
 
 
  
   The simplest demonstration of using indexed properties in Struts can be
   shown with the following simple bean and JSP page:
  
   
  package org.apache.struts.webapp.exercise;
  import org.apache.struts.action.ActionForm;
  public class StringBean extends ActionForm {
  private String strAry[] =
  { "String 0", "String 1", "String 2", "String 3", "String 4" };
  
  public String getStringIndexed(int index) { return (strAry[index]); }
  public void setStringIndexed(int index, String value)
  { strAry[index] = value; }
  }
  
   First note the two methods in the StringBean class, "getStringIndexed()"
   and "setStringIndexed()".  Note that the "get" method takes an "int" and
   the "set" method takes an "int" and "String".  The Beanutils package and
   Struts recognizes this arrangement of signatures as an "indexed property",
   in this case with the property name "stringIndexed".
  
  
  
  <%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
  
  
  
   Note the property value of "stringIndexed[1]".  This is intended to
   reference the indexed property "stringIndexed", and the 1st (zero-based)
   entry of whatever array or collection which the indexed property
   represents.
  
  
   As you might be able to guess, when this page is executed, it will print
   just the string "String 1", which is the corresponding array entry at that
   index value.
  
  
   This is a simple demonstration of what indexed properties can provide.
  
 
 
  
   A variation on indexed properties are properties whose type is
   "java.util.List" or a subclass.
  
  
   For instance, the first example using "StringBean.java" and
   "indexedtest.

cvs commit: jakarta-struts/doc learning.xml index.xml

[husted]

husted  2002/11/30 06:41:59

  Modified:doc  learning.xml index.xml
  Log:
  Move0 Books about Struts to the Welcome page.
  
  Revision  ChangesPath
  1.4   +12 -42jakarta-struts/doc/learning.xml
  
  Index: learning.xml
  ===
  RCS file: /home/cvs/jakarta-struts/doc/learning.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- learning.xml  29 Nov 2002 21:19:11 -  1.3
  +++ learning.xml  30 Nov 2002 14:41:59 -  1.4
  @@ -20,18 +20,18 @@
 
 
 
  - 
  - User and Developer Guides,
  - 
  - 
  +
  +User and Developer Guides,
  +
  +
   Javadocs,
  - 
  - 
  - FAQs and Howtos,
  - 
  - 
  - and everything else you find here.
  - 
  +
  +
  +FAQs and Howtos,
  +
  +
  +and everything else you find here.
  +
 
 
 
  @@ -113,7 +113,7 @@
 
   
 
  - 
  +
 
   
 
  @@ -160,36 +160,6 @@
 The Struts News & Status page highlights 
current
 events affecting the framework, including new releases, proposals for new 
features,
 and additions to the Resources page.
  -  
  -
  -  
  -
  -  
  -
  -  
  -  
  -  
  -
  -  
  -  
  -  
  -  
  -  
  -
  -  
  -  
  - 
  -
  -  
  -  Printed books about Struts are available now, and several more are on the way.
  -  A current list of books about Struts is maintained in the
  -  resource area. Links to excerpts are provided when available.
  -  
  -  
  -  
  -  A great number of online articles and tutorials have also been published about 
Struts,
  -  which are also listed in the
  -  the resource area
 
   
 
  
  
  
  1.39  +73 -10jakarta-struts/doc/index.xml
  
  Index: index.xml
  ===
  RCS file: /home/cvs/jakarta-struts/doc/index.xml,v
  retrieving revision 1.38
  retrieving revision 1.39
  diff -u -r1.38 -r1.39
  --- index.xml 29 Nov 2002 19:01:31 -  1.38
  +++ index.xml 30 Nov 2002 14:41:59 -  1.39
  @@ -59,17 +59,80 @@
   
   
   
  -
  -
  -Next: Learning About Struts
  -
  -
  +
   
  -
  -
  -So when is the next release coming 
out?
  -
  -
  +
  +
  +
  +  
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  +
  + 
  +
  +
  +
  +
  +  
  +
  +
  +
  +
  +   
  +   Several printed books about Struts are available now, and more are on the 
way.
  +   A current list of books about Struts is maintained in the
  +   resource area. 
  +   Links to excerpts are provided when available.
  +   
  +  
  +   
  +
  +   
  +   
  +   Next: Learning About Struts
  +   
  +   
  +
  +   
  +   
  +   So when is the next release coming 
out?
  +   
  +   
   
   
   
  
  
  

--
To unsubscribe, e-mail:   
For additional commands, e-mail: 

cvs commit: jakarta-struts/doc/userGuide preface.xml building_controller.xml building_apps.xml

[husted]

husted  2002/11/30 06:30:28

  Modified:doc/userGuide preface.xml building_controller.xml
building_apps.xml
  Log:
  Nix some TODOs.
  
  Revision  ChangesPath
  1.15  +252 -124  jakarta-struts/doc/userGuide/preface.xml
  
  Index: preface.xml
  ===
  RCS file: /home/cvs/jakarta-struts/doc/userGuide/preface.xml,v
  retrieving revision 1.14
  retrieving revision 1.15
  diff -u -r1.14 -r1.15
  --- preface.xml   29 Nov 2002 21:27:57 -  1.14
  +++ preface.xml   30 Nov 2002 14:30:27 -  1.15
  @@ -31,9 +31,10 @@
 Extensible Markup Language
   
   
  -This chapter briefly defines each of these technologies, but does not 
describe them in
  -detail. For your convenience, links to further information about each component 
are also
  -provided.
  +
  +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.
  +
   
   If you are familiar with Java, but not these 
technologies,
   the best overall starting point is
  @@ -90,7 +91,7 @@
   Frameworks like Struts abstract much of these nuts and bolts, but it is 
important to understand
   what is happening behind the scenes. 
   
  -If you are not familiar with the HTTP Request/Response cycle, we 
strongly recommend the
  +If you are not familiar with the HTTP request/response cycle, we 
strongly recommend the
   http://java.sun.com/webservices/docs/1.0/tutorial/doc/HTTP.html#63796";>
   HTTP Overview in the JWST.
   
  @@ -208,9 +209,13 @@
   DynaBeans combine the extensibility of JavaBeans with the flexbility 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 can be used to roundtrip properties to HTML forms. 
  -In many cases, Struts DynaForms can be configured entirely through XML. 
  -This means you can avoid creating a formal subclass just to store a few simple 
properties.
  +The virtual properties of a DynaBean can't be called by standard Java methods, 
  +but work well with components that rely on relfection and introspection. 
  +
  +
  +
  +In a Struts application, you can use DynaBeans to describe your HTML forms. 
  +This stategy can avoid creating a formal JavaBean subclass to store a few 
simple properties. 
   
   
   
  @@ -255,45 +260,40 @@
   
   
   
  -Much of the HTTP Request/Response cycle nuts-and-bolts 
are handled by Sun's
  -http://java.sun.com/products/servlet/";>Java Servlet platform. This 
casts HTTP
  -into an object-orientated form so that developers can better concentrate on what
  -they need their application to do -- rather than the mechanics of HTTP.
  -
  -Struts provides a ready-to-use servlet for your application. As a Struts 
developer, you
  -can then just write objects that the Struts servlet 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.
  -
  -For more about Java Servlets, see 
  -
  -
  -http://java.sun.com/products/servlet/";>The
  -Java Servlet Technology page at
  -java.sun.com
  -http://java.sun.com/products/servlet/download/";>The
  -Servlet 2.2 and 2.3 Specifications download page at
  -java.sun.com
  -http://java.sun.com/webservices/docs/1.0/tutorial/doc/Servlets.html";>
  -Java Servlet Technology in the Java Web Services Tutorial.
  -http://java.sun.com/webservices/docs/1.0/tutorial/doc/WebApp.html";>
  -Web Applications in the Java Web Services Tutorial.
  -
  +
  +Since Java is an object-orientated language, the 
  +http://java.sun.com/products/servlet/";>Java Servlet 
  +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.
  +
  +
  +
  +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. 
  +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. 
  +If there is a servlet regi