dmkarr 2002/10/22 22:10:35 Added: contrib/struts-el/src/share/org/apache/strutsel/taglib/bean package.html contrib/struts-el/src/share/org/apache/strutsel/taglib/logic package.html Log: package descriptions for bean-el and logic-el Revision Changes Path 1.1 jakarta-struts/contrib/struts-el/src/share/org/apache/strutsel/taglib/bean/package.html Index: package.html =================================================================== <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <base/> <title>Package Documentation for org.apache.strutsel.taglib.bean Package</title> </head> <body bgcolor="white"> <p> The "struts-bean-el" tag library contains JSP custom tags useful in defining new beans (in any desired scope) from a variety of possible sources, as well as a tag to render a particular bean (or bean property) to the output response. </p> <br> <a name="doc.Description"></a> <div align="Center"> <a href="#doc.Intro">[Introduction]</a> <a href="#doc.Functionality">[Bean-EL Functionality]</a> <a href="#doc.Examples">[Bean-EL Examples]</a> </div> <hr> <a name="doc.Intro"></a> <h3>Introduction</h3> <p> The functionality of this tag library is entirely provided by the base "struts-bean" tag library in the Struts distribution. This derived tag library, "struts-bean-el", only provides a different way to evaluate attribute values, which is using the JavaServer Pages Standard Tag Library expression language engine, or the "JSTL EL" for short. </p> <p> In general, the tags provided in the "struts-bean-el" library are a direct mapping from the "struts-bean" tag library. However, there are several tags in the base Struts tag library which were not "ported" to the "struts-bean-el" tag library, as it was determined that all of their functionality was provided by the JSTL. Information about these "non-ported" tags is provided in the information for the "org.apache.strutsel" package. </p> <a name="doc.Functionality"></a> <h3>Bean-EL Functionality</h3> <p> The functionality of the "bean-el" tags can be almost entirely understood from the documentation of the "struts-bean" base tag library. </p> <a name="doc.Examples"></a> <h3>Bean-EL Examples</h3> <p> The following are discrete examples of uses of the "bean-el" tags, in no paticular order, but emphasizing the use of JSTL EL values as attribute values. </p> <p><i>Example:</i></p> <pre> <bean:message key="${messKey}" arg0="${arg}"/></pre> <p><i>Example:</i></p> <pre> <bean:resource id="var" name="${filename}" /></pre> <p><i>Example:</i></p> <pre> <%-- Size of pagescope hash table --%> <bean:size id="pageScopeSize" collection="${pageScope}" /></pre> <p><i>Example:</i></p> <pre> <bean:struts id="mapping" mapping="${actionName}" /></pre> </body> </html> 1.1 jakarta-struts/contrib/struts-el/src/share/org/apache/strutsel/taglib/logic/package.html Index: package.html =================================================================== <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <base/> <title>Package Documentation for org.apache.strutsel.taglib.logic Package</title> </head> <body bgcolor="white"> <p> The "struts-logic-el" tag library contains 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. </p> <br> <a name="doc.Description"></a> <div align="Center"> <a href="#doc.Intro">[Introduction]</a> <a href="#doc.Functionality">[Logic-EL Functionality]</a> <a href="#doc.Examples">[Logic-EL Examples]</a> </div> <hr> <a name="doc.Intro"></a> <h3>Introduction</h3> <p> The functionality of this tag library is entirely provided by the base "struts-logic" tag library in the Struts distribution. This derived tag library, "struts-logic-el", only provides a different way to evaluate attribute values, which is using the JavaServer Pages Standard Tag Library expression language engine, or the "JSTL EL" for short. </p> <p> In general, the tags provided in the "struts-logic-el" library are a direct mapping from the "struts-logic" tag library. However, there are several tags in the base Struts tag library which were not "ported" to the "struts-logic-el" tag library, as it was determined that all of their functionality was provided by the JSTL. Information about these "non-ported" tags is provided in the information for the "org.apache.strutsel" package. </p> <p> In addition, specific to the "struts-logic-el" library, two tags in this library have one additional attribute over their counterpart in the base Struts tag library. These tags are the <code>match</code> and <code>notMatch</code> tags, and the additional attribute is named <code>expr</code>, which is a value intended to be evaluated by the JSTL EL engine. More details about these tags and their attributes is provided in more detailed documentation about the package and its tags. </p> <a name="doc.Functionality"></a> <h3>Logic-EL Functionality</h3> <p> The functionality of the "logic-el" tags can be almost entirely understood from the documentation of the "struts-logic" base tag library. The only exception is the new attribute added to the <code>match</code> and <code>notMatch</code> tags, being the <code>expr</code> attribute. </p> <p> The <code>match</code> and <code>notMatch</code> tags provide the ability to check to see whether a specific value is (or is not) a substring of a value obtained from either a cookie, request header, request parameter, or bean property. The addition of the <code>expr</code> attribute allows the obtained value to come from an arbitrary expression language value. </p> <a name="doc.Examples"></a> <h3>Logic-EL Examples</h3> <p> The following are discrete examples of uses of the "logic-el" tags, in no paticular order, but emphasizing the use of JSTL EL values as attribute values. </p> <p><i>Example:</i></p> <pre> <logic:forward name="${forwardName}"/></pre> <p><i>Example:</i></p> <pre> <%-- Iterates through all HTTP headers. --%> <logic:iterate id="item" collection="${header}"> <tr> <td><c:out value="${item}.key"/></td> <td><c:out value="${item}.value"/></td> </tr> </logic:iterate></pre> <p><i>Example:</i></p> <pre> <logic:match cookie="${cookieName}" value="${cookieValue}"> Match succeeded. </logic:match></pre> <p><i>Example:</i></p> <pre> <logic:match expr='${hash["foo"]}' value="${matchValue}"> Match succeeded. </logic:match></pre> <p><i>Example:</i></p> <pre> <logic:messagesPresent property="${messageKey}"> Message found. </logic:messagesPresent></pre> <p><i>Example:</i></p> <pre> <logic:redirect href="http://localhost:${portnum}/factory" /> </body> </html>
-- To unsubscribe, e-mail: <mailto:struts-dev-unsubscribe@;jakarta.apache.org> For additional commands, e-mail: <mailto:struts-dev-help@;jakarta.apache.org>