dmkarr 2002/11/01 21:40:18
Modified: doc/userGuide building_view.xml preface.xml
Log:
I added a short paragraph about Struts-EL to section 0.8, and a longer section
as section 3.4.6 in the "Building View Components" chapter.
PR: 14166
Revision Changes Path
1.17 +50 -4 jakarta-struts/doc/userGuide/building_view.xml
Index: building_view.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/building_view.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- building_view.xml 29 Oct 2002 04:17:34 -0000 1.16
+++ building_view.xml 2 Nov 2002 05:40:18 -0000 1.17
@@ -678,6 +678,56 @@
return(null);
</pre>
+ </section>
+
+ <section name="3.4.6 The Struts-EL Tag Library" href="struts-el">
+ <p>
+ The <strong>Struts-EL</strong> tag library is a contributed library in
+ the Struts distribution. It represents an integration of the Struts
+ tag library with the JavaServer Pages Standard Tag Library, or at
+ least the "expression evaluation" engine that is used by the JSTL.
+ </p>
+ <p>
+ The base Struts tag library contains tags which rely on the evaluation
+ of "rtexprvalue"s (runtime scriptlet expressions) to evaluate dynamic
+ attribute values. For instance, to print a message from a properties
+ file based on a resource key, you would use the
+ <code>bean:write</code> tag, perhaps like this:
+ <pre>
+ <bean:message key='<%= stringvar %>'/></pre>
+ </p>
+ <p>
+ This assumes that <code>stringvar</code> exists as a JSP scripting
+ variable. If you're using the <strong>Struts-EL</strong> library, the
+ reference looks very similar, but slightly different, like this:
+ <pre>
+ <bean-el:message key="${stringvar}"/></pre></pre>
+ </p>
+ <p>
+ If you want to know how to properly use the <strong>Struts-EL</strong>
+ tag library, there are two important things you need to know:
+ <ul>
+ <li>The Struts tag library</li>
+ <li>The JavaServer Pages Standard tag library</li>
+ </ul>
+ </p>
+ <p>
+ Once you understand how to use these two, consider Struts tag
+ attribute values being evaluated the same way the JSTL tag attribute
+ values are. Past that, there is very little else you need to know to
+ effectively use the <strong>Struts-EL</strong> tag library.
+ </p>
+ <p>
+ Although the <strong>Struts-EL</strong> tag library is a direct "port"
+ of the tags from the Struts tag library, not all of the tags in the
+ Struts tag library were implemented in the <strong>Struts-EL</strong>
+ tag library. This was the case if it was clear that the functionality
+ of a particular Struts tag could be entirely fulfilled by a tag in the
+ JSTL. It is assumed that developers will want to use the
+ <strong>Struts-EL</strong> tag library along with the JSTL, so it is
+ reasonable to assume that they will use tags from the JSTL if they
+ fill their needs.
+ </p>
<p align="center">
Next: <a href="building_controller.html">Building Controller
Components</a>
</p>
@@ -686,7 +736,3 @@
</chapter>
</body>
</document>
-
-
-
-
1.11 +12 -2 jakarta-struts/doc/userGuide/preface.xml
Index: preface.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/preface.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- preface.xml 29 Oct 2002 05:32:26 -0000 1.10
+++ preface.xml 2 Nov 2002 05:40:18 -0000 1.11
@@ -541,10 +541,20 @@
in the Java Web Services Tutorial.</p>
<p>Struts also works well with the new
- <a href="http://java.sun.com/products/jsp/jstl";>Java Standard Tag Library</a>
+ <a href="http://java.sun.com/products/jsp/jstl";>JavaServer Pages Standard Tag
Library</a>
and taglibs from other sources, like
<a href="http://jsptags.com/";>JSP Tags</a> and
- <a href="http://jakarta.apache.org/taglibs/index.html";>Jarkata Taglibs</a>.
+ <a href="http://jakarta.apache.org/taglibs/index.html";>Jakarta Taglibs</a>.
+ </p>
+
+ <p>
+ One of the contributed libraries that comes with the Struts distribution,
+ called <strong>Struts-EL</strong>, is specifically designed to work well
+ with the JavaServer Pages Standard Tag Library. In particular, it uses
+ the same "expression language" engine for evaluating tag attribute values
+ as the JSTL. This is in contrast to the main Struts tag library, which
+ can only use "rtexprvalue"s (runtime scriptlet expressions) for dynamic
+ attribute values.
</p>
<p>There are also toolkits available that make Struts easy to use with
--
To unsubscribe, e-mail: <mailto:struts-dev-unsubscribe@;jakarta.apache.org>
For additional commands, e-mail: <mailto:struts-dev-help@;jakarta.apache.org>
