struts-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From hus...@apache.org
Subject svn commit: r376792 - in /struts/el/trunk: web/test/jspRedirector.jsp xdocs/index.xml xdocs/navigation.xml xdocs/struts-el.xml
Date Fri, 10 Feb 2006 18:32:50 GMT
Author: husted
Date: Fri Feb 10 10:32:49 2006
New Revision: 376792

URL: http://svn.apache.org/viewcvs?rev=376792&view=rev
Log:
Checkstyle Roundup 
* EL package reformatted with latest Jalopy settings. Stylistic changes only.


Modified:
    struts/el/trunk/web/test/jspRedirector.jsp
    struts/el/trunk/xdocs/index.xml
    struts/el/trunk/xdocs/navigation.xml
    struts/el/trunk/xdocs/struts-el.xml

Modified: struts/el/trunk/web/test/jspRedirector.jsp
URL: http://svn.apache.org/viewcvs/struts/el/trunk/web/test/jspRedirector.jsp?rev=376792&r1=376791&r2=376792&view=diff
==============================================================================
--- struts/el/trunk/web/test/jspRedirector.jsp (original)
+++ struts/el/trunk/web/test/jspRedirector.jsp Fri Feb 10 10:32:49 2006
@@ -1,7 +1,8 @@
-<%@page import="org.apache.cactus.server.*,
-                org.apache.cactus.util.log.LogService" session="true" %><%
+<%@ page import="org.apache.cactus.server.JspImplicitObjects,
+                 org.apache.cactus.server.JspTestRedirector" session="true" %>
+<%
 
-    /**                                                
+    /**
      *                                                 
      * Note:                                           
      * It is very important not to put any character between the end
@@ -20,8 +21,7 @@
     /**
      * Initialise logging if not already initialised
      */
-    if (!LogService.getInstance().isInitialized())
-    {
+    if (!LogService.getInstance().isInitialized()) {
         LogService.getInstance().init("/log_server.properties");
     }
 

Modified: struts/el/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewcvs/struts/el/trunk/xdocs/index.xml?rev=376792&r1=376791&r2=376792&view=diff
==============================================================================
--- struts/el/trunk/xdocs/index.xml (original)
+++ struts/el/trunk/xdocs/index.xml Fri Feb 10 10:32:49 2006
@@ -17,114 +17,200 @@
 // ======================================================================== 78
 -->
 <document>
-<properties>
-    <title>Welcome</title>
-  </properties>
-
-  <body>
-
-    <section name="Welcome to Struts EL">
-    <a name="welcome"/>
-    
-<p>
-This subproject is an extension of the Struts tag library.  Each JSP custom tag
-in this library is a subclass of an associated tag in the Struts tag library.
-One difference is that this tag library does not use "rtexprvalues", it uses
-the expression evaluation engine in the Jakarta Taglibs implementation of the
-JSP Standard Tag Library (version 1.0) to evaluate attribute values.
-</p>
-<p>
-In addition, some of the Struts tags were not ported to this library, as it was
-determined that their functionality was entirely supplied by the JSTL.  These
-particular Struts tags, and the reason for their non-porting will be described
-in the documentation for this library.
-</p>
-<p>
-In order to fully understand the correct utilization of this library, you must
-understand the use and operation of the Struts tag library, and the use and
-operation of the JavaServer Pages Standard Tag Library (hereafter called the
-"JSTL"), along with the expression language (sometimes called the "EL") used
-for evaluating attribute values.
-</p>
-</section>
-
-<section name="Tag Mapping">
-<p>
-In implementing the Struts-EL library, every Struts tag that provides a feature
-that is not covered by the JSTL (1.0) library is mapped into the Struts-EL
-library.  This section reviews which Struts tags are NOT implemented in the
-Struts-EL library, and which JSTL tags provide that feature.
-</p>
-<p>
-Many of the non-porting decisions were based on the fact that the JSTL
-expression language itself provides the same functionality.  In those cases, in
-addition to a possible JSTL tag name, the symbol "EL" will be listed.
-</p>
-<subsection name="Bean Tag Library Tags NOT Implemented in Struts-EL">
-<table>
-<tr><th>Struts Tag</th><th>JSTL Tag</th></tr>
-<tr><td>cookie</td><td>c:set, EL</td></tr>
-<tr><td>define</td><td>c:set, EL</td></tr>
-<tr><td>header</td><td>c:set, EL</td></tr>
-<tr><td>include</td><td>c:import</td></tr>
-<tr><td>parameter</td><td>c:set, EL</td></tr>
-<tr><td>write</td><td>c:out</td></tr>
-</table>
-</subsection>
-
-<subsection name="Logic Tag Library Tags NOT Implemented in Struts-EL">
-<table>
-<tr><th>Struts Tag</th><th>JSTL Tag</th></tr>
-<tr><td>empty</td><td>c:if, c:when, EL</td></tr>
-<tr><td>equal</td><td>c:if, c:when, EL</td></tr>
-<tr><td>greaterEqual</td><td>c:if, c:when, EL</td></tr>
-<tr><td>greaterThan</td><td>c:if, c:when, EL</td></tr>
-<tr><td>lessEqual</td><td>c:if, c:when, EL</td></tr>
-<tr><td>lessThan</td><td>c:if, c:when, EL</td></tr>
-<tr><td>notEmpty</td><td>c:if, c:when, EL</td></tr>
-<tr><td>notEqual</td><td>c:if, c:when, EL</td></tr>
-</table>
-<p>
-(Note that the "iterate" tag was originally ported, even with the presence of
-the "c:forEach" tag, as the "indexed tag" functionality was not supported when
-using "c:forEach" instead of "logic:iterate".  This has since been rectified,
-such that the "indexed tag" functionality checks for being contained in a
-"c:forEach" tag, in addition to the "logic:iterate" tag.  However, the ported
-"iterate" tag has not been removed from Struts-EL, for backward compatibility.)
-</p>
-</subsection>
-
-<subsection name="Html Tag Library Tags NOT Implemented in Struts-EL">
-<p>
-None (all of them were ported).
-</p>
-</subsection>
-</section>
-
-<section name="Attribute Mapping">
-<p>
-At this point of the implementation, there is only one change (to two similar
-tags) to the set of attributes between the Struts tags, and the Struts-EL tags.
-The "logic:match" and "logic:notMatch" tags have an additional attribute named
-"expr", which can take any value, and will be used as the value to compare
-against, in addition to the choices of "cookie", "header", "name"/"property",
-and "parameter".
-</p>
-</section>
-
-<section name="Usage Requirements">
-<p>
-The Struts-EL tag library requires the use of the Struts tag library, and the
-Java Server Pages Standard Tag Library.  It is not necessary for JSP pages
-using the Struts-EL tag library to also use the Struts tags or the JSTL tags,
-but the Struts and JSTL tag libraries need to be part of the application
-utilizing the Struts-EL tag library.
-</p>
-<p>
-This is because the Struts-EL tag classes are all subclasses of Struts tag
-classes, and their implementation uses classes provided by the JSTL.
-</p>
-</section>
-</body>
+    <properties>
+        <title>Welcome</title>
+    </properties>
+
+    <body>
+
+        <section name="Welcome to Struts EL">
+            <a name="welcome"/>
+
+            <p>
+                This subproject is an extension of the Struts tag library.
+                Each JSP custom tag
+                in this library is a subclass of an associated tag in the
+                Struts tag library.
+                One difference is that this tag library does not use
+                "rtexprvalues", it uses
+                the expression evaluation engine in the Jakarta Taglibs
+                implementation of the
+                JSP Standard Tag Library (version 1.0) to evaluate attribute
+                values.
+            </p>
+            <p>
+                In addition, some of the Struts tags were not ported to this
+                library, as it was
+                determined that their functionality was entirely supplied by
+                the JSTL. These
+                particular Struts tags, and the reason for their non-porting
+                will be described
+                in the documentation for this library.
+            </p>
+            <p>
+                In order to fully understand the correct utilization of this
+                library, you must
+                understand the use and operation of the Struts tag library,
+                and the use and
+                operation of the JavaServer Pages Standard Tag Library
+                (hereafter called the
+                "JSTL"), along with the expression language (sometimes called
+                the "EL") used
+                for evaluating attribute values.
+            </p>
+        </section>
+
+        <section name="Tag Mapping">
+            <p>
+                In implementing the Struts-EL library, every Struts tag that
+                provides a feature
+                that is not covered by the JSTL (1.0) library is mapped into
+                the Struts-EL
+                library. This section reviews which Struts tags are NOT
+                implemented in the
+                Struts-EL library, and which JSTL tags provide that feature.
+            </p>
+            <p>
+                Many of the non-porting decisions were based on the fact that
+                the JSTL
+                expression language itself provides the same functionality. In
+                those cases, in
+                addition to a possible JSTL tag name, the symbol "EL" will be
+                listed.
+            </p>
+            <subsection
+                    name="Bean Tag Library Tags NOT Implemented in Struts-EL">
+                <table>
+                    <tr>
+                        <th>Struts Tag</th>
+                        <th>JSTL Tag</th>
+                    </tr>
+                    <tr>
+                        <td>cookie</td>
+                        <td>c:set, EL</td>
+                    </tr>
+                    <tr>
+                        <td>define</td>
+                        <td>c:set, EL</td>
+                    </tr>
+                    <tr>
+                        <td>header</td>
+                        <td>c:set, EL</td>
+                    </tr>
+                    <tr>
+                        <td>include</td>
+                        <td>c:import</td>
+                    </tr>
+                    <tr>
+                        <td>parameter</td>
+                        <td>c:set, EL</td>
+                    </tr>
+                    <tr>
+                        <td>write</td>
+                        <td>c:out</td>
+                    </tr>
+                </table>
+            </subsection>
+
+            <subsection
+                    name="Logic Tag Library Tags NOT Implemented in Struts-EL">
+                <table>
+                    <tr>
+                        <th>Struts Tag</th>
+                        <th>JSTL Tag</th>
+                    </tr>
+                    <tr>
+                        <td>empty</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>equal</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>greaterEqual</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>greaterThan</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>lessEqual</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>lessThan</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>notEmpty</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>notEqual</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                </table>
+                <p>
+                    (Note that the "iterate" tag was originally ported, even
+                    with the presence of
+                    the "c:forEach" tag, as the "indexed tag" functionality
+                    was not supported when
+                    using "c:forEach" instead of "logic:iterate". This has
+                    since been rectified,
+                    such that the "indexed tag" functionality checks for being
+                    contained in a
+                    "c:forEach" tag, in addition to the "logic:iterate" tag.
+                    However, the ported
+                    "iterate" tag has not been removed from Struts-EL, for
+                    backward compatibility.)
+                </p>
+            </subsection>
+
+            <subsection
+                    name="Html Tag Library Tags NOT Implemented in Struts-EL">
+                <p>
+                    None (all of them were ported).
+                </p>
+            </subsection>
+        </section>
+
+        <section name="Attribute Mapping">
+            <p>
+                At this point of the implementation, there is only one change
+                (to two similar
+                tags) to the set of attributes between the Struts tags, and
+                the Struts-EL tags.
+                The "logic:match" and "logic:notMatch" tags have an additional
+                attribute named
+                "expr", which can take any value, and will be used as the
+                value to compare
+                against, in addition to the choices of "cookie", "header",
+                "name"/"property",
+                and "parameter".
+            </p>
+        </section>
+
+        <section name="Usage Requirements">
+            <p>
+                The Struts-EL tag library requires the use of the Struts tag
+                library, and the
+                Java Server Pages Standard Tag Library. It is not necessary
+                for JSP pages
+                using the Struts-EL tag library to also use the Struts tags or
+                the JSTL tags,
+                but the Struts and JSTL tag libraries need to be part of the
+                application
+                utilizing the Struts-EL tag library.
+            </p>
+            <p>
+                This is because the Struts-EL tag classes are all subclasses
+                of Struts tag
+                classes, and their implementation uses classes provided by the
+                JSTL.
+            </p>
+        </section>
+    </body>
 </document>
 

Modified: struts/el/trunk/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/struts/el/trunk/xdocs/navigation.xml?rev=376792&r1=376791&r2=376792&view=diff
==============================================================================
--- struts/el/trunk/xdocs/navigation.xml (original)
+++ struts/el/trunk/xdocs/navigation.xml Fri Feb 10 10:32:49 2006
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <project name="Struts EL">
-<title>Apache Struts - Struts EL</title>
+    <title>Apache Struts - Struts EL</title>
     <body>
         <menu name="Struts EL Taglib">
-            <item name="Welcome" href="index.html"/>    
+            <item name="Welcome" href="index.html"/>
             <item name="FAQ" href="struts-el.html"/>
         </menu>
         <menu name="Struts EL Taglib Reference">
-            <item name="Bean EL" href="tagreference-struts-bean-el.html"/>    
+            <item name="Bean EL" href="tagreference-struts-bean-el.html"/>
             <item name="HTML EL" href="tagreference-struts-html-el.html"/>
             <item name="Logic EL" href="tagreference-struts-logic-el.html"/>
             <item name="Tiles EL" href="tagreference-struts-tiles-el.html"/>

Modified: struts/el/trunk/xdocs/struts-el.xml
URL: http://svn.apache.org/viewcvs/struts/el/trunk/xdocs/struts-el.xml?rev=376792&r1=376791&r2=376792&view=diff
==============================================================================
--- struts/el/trunk/xdocs/struts-el.xml (original)
+++ struts/el/trunk/xdocs/struts-el.xml Fri Feb 10 10:32:49 2006
@@ -17,204 +17,320 @@
 // ======================================================================== 78
 -->
 <document>
-<properties>
-<title>FAQ</title>
-</properties>
-<body>
-<section href="faq" name="Struts EL Extension">
-
-    <subsection name="Preface">
-    
-    <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 Taglib 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:</p>
-    <source>
-    <![CDATA[<bean:message key='<%= stringvar %>'/>]]>
-    </source>
-
-    <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:</p>
-    <source>
-    <![CDATA[<bean-el:message key="${stringvar}"/>]]>
-    </source>
-
-    <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:
-    </p>
-    
-    <ul>
-    
-        <li>
-        The Struts Taglib
-        </li>
-
-        <li>
-        The JavaServer Pages Standard tag library
-        </li>
-
-    </ul>
-
-
-    <p>
-    Once you understand how to use these two, consider the Struts Taglib
-    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 Taglib, not all of the tags in the
-    Struts Taglib 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>
-
-</subsection>
-
-
-    <subsection name="Introduction">
-
-    <p>
-        This subproject is an extension of Struts Taglib.  Each JSP custom tag
-       in this library is a subclass of an associated tag in Struts Taglib.
-       One difference is that this tag library does not use "rtexprvalues", it uses
-       the expression evaluation engine in the Jakarta Taglibs implementation of the
-       JSP Standard Tag Library (version 1.0) to evaluate attribute values.
-    </p>
-
-    <p>
-       In addition, some of the Struts tags were not ported to this library, as it was
-       determined that their functionality was entirely supplied by the JSTL.  These
-       particular Struts tags, and the reason for their non-porting will be described
-       in the documentation for this library.
-    </p>
-
-    <p>
-       In order to fully understand the correct utilization of this library, you must
-       understand the use and operation of Struts Taglib, and the use and
-       operation of the JavaServer Pages Standard Tag Library (hereafter called the
-       "JSTL"), along with the expression language (sometimes called the "EL") used
-       for evaluating attribute values.
-    </p>
-
-    </subsection>
-
-       <a name="TagMapping"/>
-       <subsection name="Tag Mapping">
-
-    <p>
-       In implementing the Struts-EL library, every Struts tag that provides a feature
-       that is not covered by the JSTL (1.0) library is mapped into the Struts-EL
-       library.  This section reviews which Struts tags are NOT implemented in the
-       Struts-EL library, and which JSTL tags provide that feature.
-    </p>
-
-    <p>
-       Many of the non-porting decisions were based on the fact that the JSTL
-       expression language itself provides the same functionality.  In those cases, in
-       addition to a possible JSTL tag name, the symbol "EL" will be listed.
-    </p>
-
-    <p>
-       <strong> Bean Tags NOT Implemented in Struts-EL</strong>
-    </p>
-
-    <table>
-    <tr><th>Struts Tag</th><th>JSTL Tag</th></tr>
-    <tr><td>cookie</td><td>c:set, EL</td></tr>
-    <tr><td>define</td><td>c:set, EL</td></tr>
-    <tr><td>header</td><td>c:set, EL</td></tr>
-    <tr><td>include</td><td>c:import</td></tr>
-    <tr><td>parameter</td><td>c:set, EL</td></tr>
-    <tr><td>write</td><td> c:out</td></tr>
-    </table>
-
-    <p>
-       <strong>Logic Tags NOT Implemented in Struts-EL</strong>
-    </p>
-
-    <table>
-    <tr><th>Struts Tag</th><th>JSTL Tag</th></tr>
-    <tr><td>empty</td><td>c:if, c:when, EL</td></tr>
-    <tr><td>equal</td><td>c:if, c:when, EL</td></tr>
-    <tr><td>greaterEqual</td><td>c:if, c:when, EL</td></tr>
-    <tr><td>greaterThan</td><td>c:if, c:when, EL</td></tr>
-    <tr><td>lessEqual</td><td>c:if, c:when, EL</td></tr>
-    <tr><td>lessThan</td><td>c:if, c:when, EL</td></tr>
-    <tr><td>notEmpty</td><td>c:if, c:when, EL</td></tr>
-    <tr><td>notEqual</td><td>c:if, c:when, EL</td></tr>
-    </table>
-
-    <p>
-       (Note that the "iterate" tag was originally ported, even with the presence of
-       the "c:forEach" tag, as the "indexed tag" functionality was not supported when
-       using "c:forEach" instead of "logic:iterate".  This has since been rectified,
-       such that the "indexed tag" functionality checks for being contained in a
-       "c:forEach" tag, in addition to the "logic:iterate" tag.  However, the ported
-       "iterate" tag has not been removed from Struts-EL, for backward compatibility.)
-    </p>
-
-    <p>
-       <strong>HTML Tags NOT Implemented in Struts-EL</strong>
-    </p>
-
-    <p>
-       None (all of them were ported).
-    </p>
-
-    </subsection>
-
-    <a name="AttributeMapping"/>
-    <subsection name="Attribute Mapping">
-
-    <p>
-       At this point of the implementation, there is only one change (to two similar
-       tags) to the set of attributes between the Struts Taglib tags and the Struts-EL tags.
-       The "logic:match" and "logic:notMatch" tags have an additional attribute named
-       "expr", which can take any value, and will be used as the value to compare
-       against, in addition to the choices of "cookie", "header", "name"/"property",
-       and "parameter".
-    </p>
-
-    </subsection>
-
-    <a name="UsageRequirements"/>
-    <subsection name="Usage Requirements">
-
-    <p>
-       The Struts-EL tag library requires the use of Struts Taglib, and the
-       Java Server Pages Standard Tag Library.  It is not necessary for JSP pages
-       using the Struts-EL tag library to also use the Struts tags or the JSTL tags,
-       but the Struts and JSTL tag libraries need to be part of the application
-       utilizing the Struts-EL tag library.
-    </p>
-
-    <p>
-       This is because the Struts-EL tag classes are all subclasses of Struts tag
-       classes, and their implementation uses classes provided by the JSTL.
-    </p>
-
-    </subsection>
-
-</section></body></document>
+    <properties>
+        <title>FAQ</title>
+    </properties>
+    <body>
+        <section href="faq" name="Struts EL Extension">
+
+            <subsection name="Preface">
+
+                <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 Taglib 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:
+                </p>
+                <source>
+                    <![CDATA[<bean:message key='<%= stringvar %>'/>]]>
+                </source>
+
+                <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:
+                </p>
+                <source>
+                    <![CDATA[<bean-el:message key="${stringvar}"/>]]>
+                </source>
+
+                <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:
+                </p>
+
+                <ul>
+
+                    <li>
+                        The Struts Taglib
+                    </li>
+
+                    <li>
+                        The JavaServer Pages Standard tag library
+                    </li>
+
+                </ul>
+
+
+                <p>
+                    Once you understand how to use these two, consider the
+                    Struts Taglib
+                    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 Taglib, not all of the tags in
+                    the
+                    Struts Taglib 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>
+
+            </subsection>
+
+
+            <subsection name="Introduction">
+
+                <p>
+                    This subproject is an extension of Struts Taglib. Each JSP
+                    custom tag
+                    in this library is a subclass of an associated tag in
+                    Struts Taglib.
+                    One difference is that this tag library does not use
+                    "rtexprvalues", it uses
+                    the expression evaluation engine in the Jakarta Taglibs
+                    implementation of the
+                    JSP Standard Tag Library (version 1.0) to evaluate
+                    attribute values.
+                </p>
+
+                <p>
+                    In addition, some of the Struts tags were not ported to
+                    this library, as it was
+                    determined that their functionality was entirely supplied
+                    by the JSTL. These
+                    particular Struts tags, and the reason for their
+                    non-porting will be described
+                    in the documentation for this library.
+                </p>
+
+                <p>
+                    In order to fully understand the correct utilization of
+                    this library, you must
+                    understand the use and operation of Struts Taglib, and the
+                    use and
+                    operation of the JavaServer Pages Standard Tag Library
+                    (hereafter called the
+                    "JSTL"), along with the expression language (sometimes
+                    called the "EL") used
+                    for evaluating attribute values.
+                </p>
+
+            </subsection>
+
+            <a name="TagMapping"/>
+            <subsection name="Tag Mapping">
+
+                <p>
+                    In implementing the Struts-EL library, every Struts tag
+                    that provides a feature
+                    that is not covered by the JSTL (1.0) library is mapped
+                    into the Struts-EL
+                    library. This section reviews which Struts tags are NOT
+                    implemented in the
+                    Struts-EL library, and which JSTL tags provide that
+                    feature.
+                </p>
+
+                <p>
+                    Many of the non-porting decisions were based on the fact
+                    that the JSTL
+                    expression language itself provides the same
+                    functionality. In those cases, in
+                    addition to a possible JSTL tag name, the symbol "EL" will
+                    be listed.
+                </p>
+
+                <p>
+                    <strong>Bean Tags NOT Implemented in Struts-EL</strong>
+                </p>
+
+                <table>
+                    <tr>
+                        <th>Struts Tag</th>
+                        <th>JSTL Tag</th>
+                    </tr>
+                    <tr>
+                        <td>cookie</td>
+                        <td>c:set, EL</td>
+                    </tr>
+                    <tr>
+                        <td>define</td>
+                        <td>c:set, EL</td>
+                    </tr>
+                    <tr>
+                        <td>header</td>
+                        <td>c:set, EL</td>
+                    </tr>
+                    <tr>
+                        <td>include</td>
+                        <td>c:import</td>
+                    </tr>
+                    <tr>
+                        <td>parameter</td>
+                        <td>c:set, EL</td>
+                    </tr>
+                    <tr>
+                        <td>write</td>
+                        <td>c:out</td>
+                    </tr>
+                </table>
+
+                <p>
+                    <strong>Logic Tags NOT Implemented in Struts-EL</strong>
+                </p>
+
+                <table>
+                    <tr>
+                        <th>Struts Tag</th>
+                        <th>JSTL Tag</th>
+                    </tr>
+                    <tr>
+                        <td>empty</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>equal</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>greaterEqual</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>greaterThan</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>lessEqual</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>lessThan</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>notEmpty</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                    <tr>
+                        <td>notEqual</td>
+                        <td>c:if, c:when, EL</td>
+                    </tr>
+                </table>
+
+                <p>
+                    (Note that the "iterate" tag was originally ported, even
+                    with the presence of
+                    the "c:forEach" tag, as the "indexed tag" functionality
+                    was not supported when
+                    using "c:forEach" instead of "logic:iterate". This has
+                    since been rectified,
+                    such that the "indexed tag" functionality checks for being
+                    contained in a
+                    "c:forEach" tag, in addition to the "logic:iterate" tag.
+                    However, the ported
+                    "iterate" tag has not been removed from Struts-EL, for
+                    backward compatibility.)
+                </p>
+
+                <p>
+                    <strong>HTML Tags NOT Implemented in Struts-EL</strong>
+                </p>
+
+                <p>
+                    None (all of them were ported).
+                </p>
+
+            </subsection>
+
+            <a name="AttributeMapping"/>
+            <subsection name="Attribute Mapping">
+
+                <p>
+                    At this point of the implementation, there is only one
+                    change (to two similar
+                    tags) to the set of attributes between the Struts Taglib
+                    tags and the Struts-EL tags.
+                    The "logic:match" and "logic:notMatch" tags have an
+                    additional attribute named
+                    "expr", which can take any value, and will be used as the
+                    value to compare
+                    against, in addition to the choices of "cookie", "header",
+                    "name"/"property",
+                    and "parameter".
+                </p>
+
+            </subsection>
+
+            <a name="UsageRequirements"/>
+            <subsection name="Usage Requirements">
+
+                <p>
+                    The Struts-EL tag library requires the use of Struts
+                    Taglib, and the
+                    Java Server Pages Standard Tag Library. It is not
+                    necessary for JSP pages
+                    using the Struts-EL tag library to also use the Struts
+                    tags or the JSTL tags,
+                    but the Struts and JSTL tag libraries need to be part of
+                    the application
+                    utilizing the Struts-EL tag library.
+                </p>
+
+                <p>
+                    This is because the Struts-EL tag classes are all
+                    subclasses of Struts tag
+                    classes, and their implementation uses classes provided by
+                    the JSTL.
+                </p>
+
+            </subsection>
+
+        </section>
+    </body>
+</document>



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org


Mime
View raw message