You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@struts.apache.org by hu...@apache.org on 2006/07/11 16:22:16 UTC
svn commit: r420866 - in /struts/struts1/trunk: faces/src/site/xdoc/
src/site/xdoc/ taglib/src/site/ taglib/src/site/xdoc/
Author: husted
Date: Tue Jul 11 07:22:16 2006
New Revision: 420866
URL: http://svn.apache.org/viewvc?rev=420866&view=rev
Log:
STR-2898 : Updates through Taglib.
Modified:
struts/struts1/trunk/faces/src/site/xdoc/index.xml
struts/struts1/trunk/src/site/xdoc/index.xml
struts/struts1/trunk/taglib/src/site/site.xml
struts/struts1/trunk/taglib/src/site/xdoc/building_view.xml
struts/struts1/trunk/taglib/src/site/xdoc/faq.xml
struts/struts1/trunk/taglib/src/site/xdoc/index.xml
struts/struts1/trunk/taglib/src/site/xdoc/indexedprops.xml
Modified: struts/struts1/trunk/faces/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/struts/struts1/trunk/faces/src/site/xdoc/index.xml?rev=420866&r1=420865&r2=420866&view=diff
==============================================================================
--- struts/struts1/trunk/faces/src/site/xdoc/index.xml (original)
+++ struts/struts1/trunk/faces/src/site/xdoc/index.xml Tue Jul 11 07:22:16 2006
@@ -24,24 +24,38 @@
<body>
- <section name="Struts and JavaServer Faces Integration Library">
+ <section name="Struts Faces">
<a name="welcome"/>
- <p>The "Struts-Faces" package contains an add-on library that supports the use of
- JavaServer Faces (JSF) user interface technology in a Struts-based web
- application, in place of the Struts custom tag libraries.</p>
+ <p>
+ The "Struts Faces" component contains an add-on library that supports
+ the use of JavaServer Faces (JSF) user interface technology in a
+ Struts-based web application, in place of the Struts custom tag libraries.
+ </p>
- <p>The Struts-Faces Integration Library should work with any implementation
- of JavaServer Faces, version 1.0 or later. It has primarily been tested
- against version 1.1 of the JavaServer Faces reference implementation,
- available at:
- <a href="http://java.sun.com/j2ee/javaserverfaces/">
- http://java.sun.com/j2ee/javaserverfaces/
- </a>
+ <p>
+ The Struts-Faces Integration Library should work with any implementation
+ of JavaServer Faces, version 1.0 or later. It has primarily been tested
+ against <a href="http://java.sun.com/j2ee/javaserverfaces/">
+ version 1.1 of the JavaServer Faces reference implementation.</a>
</p>
- <p>For more information, consult the
- <a href="README.txt" target="_blank">README</a> file.
+ <p>
+ For more information, consult the
+ <a href="README.txt" target="_blank">README</a> file.
+ </p>
+
+ <p>
+ Note that the Struts Faces component is intended as a "bridge" between
+ Struts 1 and JavaServer Faces.
+ The typical use case is a team that would like to experiment with JSF
+ components but does not want to completely rework an existing application.
+ </p>
+
+ <p>
+ For better JavaServer Faces support,
+ consider using Struts 2 or
+ <a href="http://shale.apache.org/">Apache Shale.</a>
</p>
</section>
@@ -49,8 +63,8 @@
<a name="issue"/>
<p>Please report any bugs, or log any enhancement requests, in the
- <a href="http://issues.apache.org/struts/">Struts JIRA Issue Tracker</a>,
- using <code>Struts</code> and <code>Faces</code>.</p>
+ <a href="http://issues.apache.org/struts/">Struts JIRA Issue Tracker</a>
+ to the <code>Faces</code> component under <code>Struts 1.</code></p>
</section>
Modified: struts/struts1/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/struts/struts1/trunk/src/site/xdoc/index.xml?rev=420866&r1=420865&r2=420866&view=diff
==============================================================================
--- struts/struts1/trunk/src/site/xdoc/index.xml (original)
+++ struts/struts1/trunk/src/site/xdoc/index.xml Tue Jul 11 07:22:16 2006
@@ -263,8 +263,7 @@
<section>
<p class="right">
Next:
- <a href="learning.html">Learning about Struts
- Framework</a>
+ <a href="learning.html">Learning about Struts</a>
</p>
</section>
Modified: struts/struts1/trunk/taglib/src/site/site.xml
URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/site/site.xml?rev=420866&r1=420865&r2=420866&view=diff
==============================================================================
--- struts/struts1/trunk/taglib/src/site/site.xml (original)
+++ struts/struts1/trunk/taglib/src/site/site.xml Tue Jul 11 07:22:16 2006
@@ -16,17 +16,17 @@
<item name="Struts 1" href="http://struts.apache.org/1.x" />
<item name="Struts 2" href="http://struts.apache.org/2.0" />
</links>
- <menu name="Struts JSP Taglib Guides">
- <item name="Bean" href="dev_bean.html"/>
- <item name="HTML" href="dev_html.html"/>
- <item name="Logic" href="dev_logic.html"/>
- <item name="Nested" href="dev_nested.html"/>
- </menu>
<menu name="FAQs and HOWTOs">
<item name="Taglib FAQ" href="faq.html"/>
<item name="Building View Components" href="building_view.html"/>
<item name="Indexed Properties" href="indexedprops.html"/>
</menu>
+ <menu name="Struts Taglib Guides">
+ <item name="Bean" href="dev_bean.html"/>
+ <item name="HTML" href="dev_html.html"/>
+ <item name="Logic" href="dev_logic.html"/>
+ <item name="Nested" href="dev_nested.html"/>
+ </menu>
<menu name="Components">
Modified: struts/struts1/trunk/taglib/src/site/xdoc/building_view.xml
URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/site/xdoc/building_view.xml?rev=420866&r1=420865&r2=420866&view=diff
==============================================================================
--- struts/struts1/trunk/taglib/src/site/xdoc/building_view.xml (original)
+++ struts/struts1/trunk/taglib/src/site/xdoc/building_view.xml Tue Jul 11 07:22:16 2006
@@ -25,10 +25,9 @@
<body>
<section name="How to Build View Components">
- <subsection name="Overview">
<p>
- This chapter focuses on the task of building the
+ This section focuses on the task of building the
<em>View</em>
components
for use with Struts.
@@ -44,7 +43,6 @@
briefly discussed.
</p>
- </subsection>
<subsection name="Internationalized Messages">
Modified: struts/struts1/trunk/taglib/src/site/xdoc/faq.xml
URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/site/xdoc/faq.xml?rev=420866&r1=420865&r2=420866&view=diff
==============================================================================
--- struts/struts1/trunk/taglib/src/site/xdoc/faq.xml (original)
+++ struts/struts1/trunk/taglib/src/site/xdoc/faq.xml Tue Jul 11 07:22:16 2006
@@ -124,34 +124,37 @@
</subsection>
- <a name="jsf"/>
- <subsection name="What about JSTL and JavaServer Faces?">
- <p>
- The framework works well with the
+ <a name="jstl"/>
+ <subsection name="What about JSTL?">
+ <p>
+ There is overlap between Struts Taglib and the
<a href="http://java.sun.com/products/jsp/jstl/">
- JavaServer Standard Tag Library.</a>
- For a JSTL rendition of the original Struts JSP tags,
- see the
- <a href="http://struts.apache.org/struts-el/index.html">
- Struts EL subproject.</a>
- </p>
+ JavaServer Standard Tag Library (JSTL).</a>
+ To make the best use of JSTL,
+ use the <a href="../struts-el/index.html">
+ Struts EL component</a> instead.
+ </p>
+ </subsection>
+ <a name="jsf"/>
+ <subsection name="What about JSF?">
+
<p>
- If you'd like to start using
- <a href="http://java.sun.com/j2ee/javaserverfaces/">
- JavaServer Faces</a>
- components in your application,
- please see the
- <a href="http://struts.apache.org/struts-faces/index.html">
- Struts Faces</a>
- subproject.
- If you'd like to get a fresh start in a pure JSF
- environment,
- please see the
- <a href="http://shale.apache.org/">Struts
- Shale</a>
- framework.
- </p>
+ Struts 1 is <strong>not</strong> the best choice if you'd
+ like to use JavaServer Faces components in your
+ application.
+ The Struts Faces component provides some interoperability
+ with JSF,
+ but Faces is really only intended as a stop gap for teams
+ experimenting with JSF.
+ </p>
+
+ <p>
+ For better JavaServer Faces support,
+ consider using Struts 2 or
+ <a href="http://shale.apache.org/">Apache Shale.</a>
+ </p>
+
</subsection>
<a name="xhtml"/>
@@ -223,8 +226,7 @@
There is more than one way to achieve this functionality.
</p>
<p>
- The way that is suggested by the framework is right out of the
- javadoc for
+ One popular approach is to use a
<a href="../api/org/apache/struts/actions/LookupDispatchAction.html">
<code>LookupDispatchAction.</code>
</a>
@@ -280,6 +282,18 @@
<a href="http://issues.apache.org/struts/browse/STR-899">
JIRA ticket.</a>
</p>
+
+ <p>
+ Another approach is to use a separate JavaScript that
+ automatically focusses the first enabled field on the
+ first form on a page.
+ See the article
+ <a href="http://www.codeproject.com/jscript/FocusFirstInput.asp">
+ Set Focus to First Input on Web Page</a>
+ for a working example that you can use in your own
+ applications.
+ </p>
+
</subsection>
<a name="checkbox"/>
Modified: struts/struts1/trunk/taglib/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/site/xdoc/index.xml?rev=420866&r1=420865&r2=420866&view=diff
==============================================================================
--- struts/struts1/trunk/taglib/src/site/xdoc/index.xml (original)
+++ struts/struts1/trunk/taglib/src/site/xdoc/index.xml Tue Jul 11 07:22:16 2006
@@ -25,12 +25,74 @@
<body>
<section name="Welcome to Struts Taglib">
<p>
- The Struts JSP Taglib project provides JSP tag libraries to make developing
- applications easier. These tags help with everything from displaying error messages
- to dealing with nested ActionForm beans. A good place to begin is to browse the
- tag guides in the left menu.
+ The Struts Taglib component provides a set of JSP custom tag
+ libraries that help developers create interactive form-based
+ applications.
+ There are tags to help with everything from displaying error
+ messages to dealing with nested ActionForm beans.
</p>
+
+ <p>
+ Struts Taglib is composed of four distinct tag libraries:
+ Bean, HTML, Logic, and Nested.
+ </p>
+ <table>
+ <tr>
+ <th>
+ <a href="dev_bean.html">Bean</a>
+ </th>
+ <td>
+ The bean tags are useful in defining new beans (in
+ any scope) from a variety of possible sources, as well
+ as a tag to render a particular bean (or bean property)
+ to the output response.
+ </td>
+ </tr>
+ <tr>
+ <th>
+ <a href="dev_html.html">HTML</a>
+ </th>
+ <td>
+ The HTML tags are used to create input forms,
+ as well as other tags generally useful in the creation of
+ HTML-based user interfaces.
+ The output is HTML 4.01 compliant or XHTML 1.0 when in
+ XHTML mode.
+ </td>
+ </tr>
+ <tr>
+ <th>
+ <a href="dev_logic.html">Logic</a>
+ </th>
+ <td>
+ The Logic tags that are useful in managing conditional
+ generation of output text, looping
+ over object collections for repetitive generation of output
+ text, and application flow management
+ </td>
+ </tr>
+ <tr>
+ <th>
+ <a href="dev_nexted.html">Nested</a>
+ </th>
+ <td>
+ The Nested tags extend the base Struts tags to allow
+ them to relate to each other in a nested nature.
+ The fundamental logic of the original tags doesn't change,
+ except in that all references to beans and bean properties
+ will be managed in a nested context.
+ </td>
+ </tr>
+ </table>
+ </section>
+
+ <section>
+ <p class="right">
+ Next:
+ <a href="faq.html">FAQ</a>
+ </p>
</section>
+
</body>
</document>
Modified: struts/struts1/trunk/taglib/src/site/xdoc/indexedprops.xml
URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/site/xdoc/indexedprops.xml?rev=420866&r1=420865&r2=420866&view=diff
==============================================================================
--- struts/struts1/trunk/taglib/src/site/xdoc/indexedprops.xml (original)
+++ struts/struts1/trunk/taglib/src/site/xdoc/indexedprops.xml Tue Jul 11 07:22:16 2006
@@ -518,13 +518,11 @@
engine that
performs these evaluations is often called just "EL"
(expression language)
- for short. After the JSTL was created, a derivative of the
- Struts tag
- library called Struts-EL was created. In short, this does
- everything that
- the Struts tag library does, but it uses the JSTL EL
- engine to evaluate
- attribute values.
+ for short. After the JSTL was created, a derivative of
+ Struts Taglib called Struts-EL was created. In short,
+ this component does everything that Struts Taglib does,
+ but it uses the JSTL EL engine to evaluate attribute
+ values.
</p>
<p>
If you use Struts-EL, you can get back some of the
@@ -558,6 +556,13 @@
</html-el:form>
</body>
</html></pre>
+
+ <p>
+ If you are using JSTL in your application (and we
+ recommend that you do!),
+ then use Struts EL in place of Struts Taglib.
+ </p>
+
</subsection>
</section>
</body>