You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by cr...@locus.apache.org on 2000/09/07 03:37:27 UTC
cvs commit: jakarta-struts/src/doc/stylesheets tld.xsl
craigmcc 00/09/06 18:37:27
Modified: src/doc installation.xml project.xml struts-bean.xml
src/doc/stylesheets tld.xsl
Added: src/doc struts-logic.xml
Log:
Update the installation documentation, and add documentation on the new
"logic library" custom tags.
Revision Changes Path
1.3 +23 -4 jakarta-struts/src/doc/installation.xml
Index: installation.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/installation.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- installation.xml 2000/08/29 00:28:53 1.2
+++ installation.xml 2000/09/07 01:37:25 1.3
@@ -131,6 +131,11 @@
You can install this web application on any servlet container
compatible with the Servlet 2.2 (or later) and JSP 1.1 (or later)
specifications.</li>
+ <li><strong>webapps/struts-test.war</strong> - This web application
+ contains test pages for the various custom tags supported by Struts.
+ It is primarily of use to developers who are enhancing the Struts
+ custom tag libraries, but may also be useful as simple examples of
+ the usage of various Struts tags.</li>
</ul>
<p>To use Struts in your own application, you will need to follow
@@ -139,8 +144,9 @@
<li>Copy the file <code>lib/struts.jar</code> from the Struts distribution
into the <code>WEB-INF/lib</code> directory of your web application.
</li>
- <li>Copy the file <code>lib/struts.tld</code> from the Struts distribution
- into the <code>WEB-INF</code> directory of your web application.</li>
+ <li>Copy the all of the files that match <code>lib/struts*.tld</code>
+ from the Struts distribution into the <code>WEB-INF</code> directory
+ of your web application.</li>
<li>Modify the <code>WEB-INF/web.xml</code> file for your web application
to include a <code><servlet></code> element to define the
controller servlet, and a <code><servlet-mapping></code> element
@@ -148,12 +154,22 @@
<code>WEB-INF/web.xml</code> file from the Struts example application
for a detailed example of the required syntax.</li>
<li>Modify the <code>WEB-INF/web.xml</code> file of your web application
- to include the following tag library declaration:
+ to include the following tag library declarations:
<pre>
<taglib>
<taglib-uri>/WEB-INF/struts.tld</taglib-uri>
<taglib-location>/WEB-INF/struts.tld</taglib-location>
</taglib>
+
+ <taglib>
+ <taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri>
+ <taglib-location>/WEB-INF/struts-bean.tld</taglib-location>
+ </taglib>
+
+ <taglib>
+ <taglib-uri>/WEB-INF/struts-logic.tld</taglib-uri>
+ <taglib-location>/WEB-INF/struts-logic.tld</taglib-location>
+ </taglib>
</pre>
</li>
<li>Create a file <code>WEB-INF/action.xml</code> that defines the action
@@ -161,9 +177,12 @@
<code>action.xml</code> file from the Struts example application
for a detailed example of the required syntax.</li>
<li>At the top of each JSP page that will use the Struts custom tags,
- add a line declaring the Struts custom tag library, like this:
+ add line(s) declaring the Struts custom tag libraries used on
+ this particular page, like this:
<pre>
<@ taglib uri="/WEB-INF/struts.tld" prefix="struts" %>
+ <@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
+ <@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>
</pre>
</li>
<li>When compiling the Java classes that comprise your application, be sure
1.4 +9 -10 jakarta-struts/src/doc/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/project.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- project.xml 2000/08/30 02:28:35 1.3
+++ project.xml 2000/09/07 01:37:26 1.4
@@ -8,22 +8,21 @@
<menu name="Overview">
<item name="Home" href="index.html"/>
<item name="Installation" href="installation.html"/>
- </menu>
-
- <menu name="Old Documents">
- <item name="TODO" href="todo.txt"/>
- <item name="User's Guide" href="users_guide.html"/>
- <item name="Tag Library (Old)" href="tags.html"/>
<item name="API Javadoc" href="api/index.html"/>
</menu>
- <menu name="New Documents">
+
+ <menu name="New Tag Library Reference">
<item name="Bean/Property Tags" href="struts-bean.html"/>
-<!--
- <item name="Form Tags" href="struts-form.html"/>
<item name="Logic Tags" href="struts-logic.html"/>
- <item name="Message Tags" href="struts-message.html"/>
+<!--
<item name="Template Tags" href="struts-template.html"/>
-->
+ </menu>
+
+ <menu name="Old Documents">
+ <item name="Tag Library (Old)" href="tags.html"/>
+ <item name="TODO" href="todo.txt"/>
+ <item name="User's Guide" href="users_guide.html"/>
</menu>
</project>
1.4 +1 -1 jakarta-struts/src/doc/struts-bean.xml
Index: struts-bean.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/struts-bean.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- struts-bean.xml 2000/09/05 21:25:44 1.3
+++ struts-bean.xml 2000/09/07 01:37:26 1.4
@@ -1,5 +1,5 @@
<?xml version="1.0"?>
-<document url="./installation.xml">
+<document url="./struts-bean.xml">
<properties>
<author>Craig R. McClanahan</author>
1.1 jakarta-struts/src/doc/struts-logic.xml
Index: struts-logic.xml
===================================================================
<?xml version="1.0"?>
<document url="./struts-logic.xml">
<properties>
<author>Craig R. McClanahan</author>
<title>The Struts Framework Project - Logic Tags</title>
</properties>
<body>
<taglib>
<tlibversion>1.0</tlibversion>
<jspversion>1.1</jspversion>
<shortname>Struts Logic Tags</shortname>
<display-name>Struts Logic Tags</display-name>
<uri>http://jakarta.apache.org/struts/tags-logic-1.0</uri>
<info>
<p>This 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>
<p>For tags that do value comparisons (<code>equal</code>,
<code>greaterEqual</code>, <code>greaterThan</code>, <code>lessEqual</code>,
<code>lessThan</code>, <code>notEqual</code>), the following rules apply:</p>
<ul>
<li>The specified value is examined. If it can be converted successfully
to a <code>double</code> or a <code>long</code>, it is assumed that the
ultimate comparison will be numeric (either floating point or integer).
Otherwise, a String comparison will be performed.</li>
<li>The variable to be compared to is retrieved, based on the selector
attribute(s) (<code>cookie</code>, <code>header</code>,
<code>name</code>, <code>parameter</code>, <code>property</code>)
present on this tag. It will be converted to the appropriate type
for the comparison, as determined above.</li>
<li>A request time exception will be thrown if the specified variable
cannot be retrieved, or has a null value.</li>
<li>The specific comparison for this tag will be performed, and the nested
body content of this tag will be evaluated if the comparison returns
a <code>true</code> result.</li>
</ul>
<p>For tags that do substring matching (<code>match</code>,
<code>notMatch</code>), the following rules apply:</p>
<ul>
<li>The specified variable is retrieved, based on the selector attribute(s)
(<code>cookie</code>, <code>header</code>, <code>name</code>,
<code>parameter</code>, <code>property</code>) present on this tag.
The variable is converted to a String, if necessary.</li>
<li>A request time exception will be thrown if the specified variable
cannot be retrieved, or has a null value.</li>
<li>The specified value is checked for existence as a substring of the
variable, in the position specified by the <code>location</code>
attribute, as follows: at the beginning (if location is set to
<code>start</code>), at the end (if location is set to
<code>end</code>), or anywhere (if location is not specified).</li>
</ul>
</info>
<tag>
<name>equal</name>
<summary>
Evaluate the nested body content of this tag if the requested
variable is equal to the specified value.
</summary>
<tagclass>org.apache.struts.taglib.logic.EqualTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable and value are <strong>equal</strong>.
</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the cookie whose
name is specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the JSP bean specified by this
attribute, if <code>property</code> is not specified, or the value
of the specified property of this bean, if <code>property</code>
is specified.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the property (of the bean specified
by the <code>name</code> attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.</p>
</info>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.</p>
</info>
</attribute>
</tag>
<tag>
<name>forward</name>
<summary>
Forward control to the page specified by the specified ActionForward
entry.
</summary>
<tagclass>org.apache.struts.taglib.logic.ForwardTag</tagclass>
<bodycontent>empty</bodycontent>
<info>
<p>Performs a <code>PageContext.forward()</code> or
<code>HttpServletResponse.sendRedirect()</code> call for the global
<code>ActionForward</code> entry for the specified name. URL
rewriting will occur automatically if a redirect is performed.</p>
</info>
<attribute>
<name>name</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The logical name of the global <code>ActionForward</code> entry
that identifies the destination, and forwarding approach, to be used.
</p>
</info>
</attribute>
</tag>
<tag>
<name>greaterEqual</name>
<summary>
Evaluate the nested body content of this tag if the requested
variable is greater than or equal to the specified value.
</summary>
<tagclass>org.apache.struts.taglib.logic.GreaterEqualTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable is <strong>greater than or equal</strong>
to the value.</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the cookie whose
name is specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the JSP bean specified by this
attribute, if <code>property</code> is not specified, or the value
of the specified property of this bean, if <code>property</code>
is specified.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the property (of the bean specified
by the <code>name</code> attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.</p>
</info>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.</p>
</info>
</attribute>
</tag>
<tag>
<name>greaterThan</name>
<summary>
Evaluate the nested body content of this tag if the requested
variable is greater than the specified value.
</summary>
<tagclass>org.apache.struts.taglib.logic.GreaterThanTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable is <strong>greater than</strong>
the value.</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the cookie whose
name is specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the JSP bean specified by this
attribute, if <code>property</code> is not specified, or the value
of the specified property of this bean, if <code>property</code>
is specified.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the property (of the bean specified
by the <code>name</code> attribute) specified by this attribute.
The property reference can be simple, nested, or indexed.</p>
</info>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.</p>
</info>
</attribute>
</tag>
<tag>
<name>iterate</name>
<summary>
Repeat the nested body content of this tag over a specified collection.
</summary>
<tagclass>org.apache.struts.taglib.logic.IterateTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Repeats the nested body content of this tag once for every element
of the specified collection, which must be an <code>Iterator</code>,
a <code>Collection</code>, a <code>Map</code> (whose values are to be
iterated over), or an array. The collection to be iterated over must be
specified in one of the following ways:</p>
<ul>
<li>As a runtime expression specified as the value of the
<code>collection</code> attribute.</li>
<li>As a JSP bean specified by the <code>name</code> attribute.</li>
<li>As the property, specified by the <code>property</code>, of the
JSP bean specified by the <code>name</code> attribute.</li>
</ul>
<p><strong>WARNING</strong> - Currently, this tag cannot deal with
arrays of primitive data types. Only arrays of Java objects (including
Strings) are supported.</p>
<p><strong>WARNING</strong> - This tag requires a Java2 (JDK 1.2 or later)
runtime environment.</p>
</info>
<attribute>
<name>collection</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>A runtime expression that evaluates to a collection (conforming to
the requirements listed above) to be iterated over.</p>
</info>
</attribute>
<attribute>
<name>id</name>
<required>true</required>
<rtexprvalue>false</rtexprvalue>
<info>
<p>The name of a page scope JSP bean that will contain the current
element of the collection on each iteration.</p>
</info>
</attribute>
<attribute>
<name>length</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The maximum number of entries (from the underlying collection) to be
iterated through on this page. This can be either an integer that
directly expresses the desired value, or the name of a JSP bean (in
any scope) of type <code>java.lang.Integer</code> that defines the
desired value. If not present, there will be no limit on the number
of iterations performed.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<info>
<p>The name of the JSP bean containing the collection to be iterated
(if <code>property</code> is not specified), or the JSP bean whose
property getter returns the collection to be iterated (if
<code>property</code> is specified).</p>
</info>
</attribute>
<attribute>
<name>offset</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The zero-relative index of the starting point at which entries from
the underlying collection will be iterated through. This can be either
an integer that directly expresses the desired value, or the name of a
JSP bean (in any scope) of type <code>java.lang.Integer</code> that
defines the desired value. If not present, zero is assumed (meaning
that the collection will be iterated from the beginning.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>false</rtexprvalue>
<info>
<p>Name of the property, of the JSP bean specified by <code>name</code>,
whose getter returns the collection to be iterated.</p>
</info>
</attribute>
<attribute>
<name>type</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Fully qualified Java class name of the element to be exposed through
the JSP bean named from the <code>id</code> attribute. If not present,
no type conversions will be performed. NOTE: The actual elements of
the collection must be assignment-compatible with this class, or a
request time ClassCastException will occur.</p>
</info>
</attribute>
</tag>
<tag>
<name>lessEqual</name>
<summary>
Evaluate the nested body content of this tag if the requested
variable is greater than or equal to the specified value.
</summary>
<tagclass>org.apache.struts.taglib.logic.LessEqualTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable is <strong>less than or equal</strong>
to the value.</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the cookie whose
name is specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the JSP bean specified by this
attribute, if <code>property</code> is not specified, or the value
of the specified property of this bean, if <code>property</code>
is specified.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the property (of the bean specified
by the <code>name</code> attribute) specified by this attribute.
The property reference can be simple, nested, or indexed.</p>
</info>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.</p>
</info>
</attribute>
</tag>
<tag>
<name>lessThan</name>
<summary>
Evaluate the nested body content of this tag if the requested
variable is less than the specified value.
</summary>
<tagclass>org.apache.struts.taglib.logic.LessThanTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable is <strong>less than</strong>
the value.</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the cookie whose
name is specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the JSP bean specified by this
attribute, if <code>property</code> is not specified, or the value
of the specified property of this bean, if <code>property</code>
is specified.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the property (of the bean specified
by the <code>name</code> attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.</p>
</info>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.</p>
</info>
</attribute>
</tag>
<tag>
<name>match</name>
<summary>
Evaluate the nested body content of this tag if the specified value
is an appropriate substring of the requested variable.
</summary>
<tagclass>org.apache.struts.taglib.logic.MatchTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Matches the variable specified by one of the selector attributes
(as a String) against the specified constant value. If the value is
a substring (appropriately limited by the <code>location</code>
attribute), the nested body content of this tag is evaluated.</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the value of the cookie whose
name is specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>location</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>If not specified, a match between the variable and the value may
occur at any position within the variable string. If specified, the
match must occur at the specified location (either <code>start</code>
or <code>end</code>) of the variable string.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the JSP bean specified by this
attribute, if <code>property</code> is not specified, or the value
of the specified property of this bean, if <code>property</code>
is specified.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the first, or only, value of the
request parameter specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the property (of the bean specified
by the <code>name</code> attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.</p>
</info>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The constant value which is checked for existence as a substring
of the specified variable.</p>
</info>
</attribute>
</tag>
<tag>
<name>notMatch</name>
<summary>
Evaluate the nested body content of this tag if the specified value
is not an appropriate substring of the requested variable.
</summary>
<tagclass>org.apache.struts.taglib.logic.NotMatchTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Matches the variable specified by one of the selector attributes
(as a String) against the specified constant value. If the value is
not a substring (appropriately limited by the <code>location</code>
attribute), the nested body content of this tag is evaluated.</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the value of the cookie whose
name is specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>location</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>If not specified, a match between the variable and the value may
occur at any position within the variable string. If specified, the
match must occur at the specified location (either <code>start</code>
or <code>end</code>) of the variable string.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the JSP bean specified by this
attribute, if <code>property</code> is not specified, or the value
of the specified property of this bean, if <code>property</code>
is specified.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the first, or only, value of the
request parameter specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be matched is the property (of the bean specified
by the <code>name</code> attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.</p>
</info>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The constant value which is checked for existence as a substring
of the specified variable.</p>
</info>
</attribute>
</tag>
<tag>
<name>notEqual</name>
<summary>
Evaluate the nested body content of this tag if the requested
variable is not equal to the specified value.
</summary>
<tagclass>org.apache.struts.taglib.logic.NotEqualTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Compares the variable specified by one of the selector attributes
against the specified constant value. The nested body content of this
tag is evaluated if the variable and value are <strong>not equal</strong>.
</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the cookie whose
name is specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the value of the header whose
name is specified by this attribute. The name match is performed
in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the JSP bean specified by this
attribute, if <code>property</code> is not specified, or the value
of the specified property of this bean, if <code>property</code>
is specified.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the first, or only, value of the
request parameter specified by this attribute.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The variable to be compared is the property (of the bean specified
by the <code>name</code> attribute) specified by this attribute.
The property reference can be simple, nested, and/or indexed.</p>
</info>
</attribute>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The constant value to which the variable, specified by other
attribute(s) of this tag, will be compared.</p>
</info>
</attribute>
</tag>
<tag>
<name>notPresent</name>
<summary>
Generate the nested body content of this tag if the specified
value is not present in this request.
</summary>
<tagclass>org.apache.struts.taglib.logic.NotPresentTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Depending on which attribute is specified, this tag checks the
current request, and evaluates the nested body content of this tag
only if the specified value <strong>is not</strong> present. Only one
of the attributes may be used in one occurrence of this tag, unless
you use the <code>property</code> attribute, in which case the
<code>name</code> attribute is also required.</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of a cookie with the specified name.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of an HTTP header with the specified
name. The name match is performed in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of a JSP bean, in any scope, with the
specified name. If <code>property</code> is also specified, checks
for a non-null property value for the specified property.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of at least one occurrence of the
specified request parameter on this request, even if the parameter
value is a zero-length string.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of a non-null property value, returned
by a property getter method on the JSP bean (in any scope) that is
specified by the <code>name</code> attribute. Property references
can be simple, nested, and/or indexed.</p>
</info>
</attribute>
</tag>
<tag>
<name>present</name>
<summary>
Generate the nested body content of this tag if the specified
value is present in this request.
</summary>
<tagclass>org.apache.struts.taglib.logic.PresentTag</tagclass>
<bodycontent>JSP</bodycontent>
<info>
<p>Depending on which attribute is specified, this tag checks the
current request, and evaluates the nested body content of this tag
only if the specified value <strong>is</strong> present. Only one
of the attributes may be used in one occurrence of this tag, unless
you use the <code>property</code> attribute, in which case the
<code>name</code> attribute is also required.</p>
</info>
<attribute>
<name>cookie</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of a cookie with the specified name.</p>
</info>
</attribute>
<attribute>
<name>header</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of an HTTP header with the specified
name. The name match is performed in a case insensitive manner.</p>
</info>
</attribute>
<attribute>
<name>name</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of a JSP bean, in any scope, with the
specified name. If <code>property</code> is also specified, checks
for a non-null property value for the specified property.</p>
</info>
</attribute>
<attribute>
<name>parameter</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of at least one occurrence of the
specified request parameter on this request, even if the parameter
value is a zero-length string.</p>
</info>
</attribute>
<attribute>
<name>property</name>
<required>false</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>Checks for the existence of a non-null property value, returned
by a property getter method on the JSP bean (in any scope) that is
specified by the <code>name</code> attribute. Property references
can be simple, nested, and/or indexed.</p>
</info>
</attribute>
</tag>
<tag>
<name>redirect</name>
<summary>
Perform an HTTP redirect to the specified URL.
</summary>
<tagclass>org.apache.struts.taglib.logic.RedirectTag</tagclass>
<bodycontent>empty</bodycontent>
<info>
<p>Performs a <code>HttpServletResponse.sendRedirect()</code> to the
specified URL, after applying URL rewriting as needed.</p>
</info>
<attribute>
<name>href</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
<info>
<p>The relative or absolute URL to which the client should be
redirected.</p>
</info>
</attribute>
</tag>
</taglib>
</body>
</document>
1.3 +1 -1 jakarta-struts/src/doc/stylesheets/tld.xsl
Index: tld.xsl
===================================================================
RCS file: /home/cvs/jakarta-struts/src/doc/stylesheets/tld.xsl,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- tld.xsl 2000/08/30 02:28:35 1.2
+++ tld.xsl 2000/09/07 01:37:26 1.3
@@ -8,7 +8,7 @@
<xsl:output
method="xml"
indent="yes"
- doctype-public="-//Sun Microsystems, Inc.//DTD JSP Tag Librayr 1.1//EN"
+ doctype-public="-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN"
doctype-system="http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd"/>
<xsl:strip-space elements="taglib tag attribute"/>