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>
