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>