Package org.apache.strutsel.taglib.logic

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.

See:
          Description

Class Summary
ELForwardTag Perform a forward or redirect to a page that is looked up in the configuration information associated with our application.
ELForwardTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.logic.ELForwardTag class.
ELIterateTag Custom tag that iterates the elements of a collection, which can be either an attribute or the property of an attribute.
ELIterateTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.bean.ELIterateTag class.
ELMatchTag Evalute the nested body content of this tag if the specified value is a substring of the specified variable.
ELMatchTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.logic.ELMatchTag class.
ELMessagesNotPresentTag Evalute to false if an ActionMessages class or a class that can be converted to an ActionMessages class is in request scope under the specified key and there is at least one message in the class or for the property specified.
ELMessagesNotPresentTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.logic.ELMessagesNotPresentTag class.
ELMessagesPresentTag Evalute to true if an ActionMessages class or a class that can be converted to an ActionMessages class is in request scope under the specified key and there is at least one message in the class or for the property specified.
ELMessagesPresentTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.logic.ELMessagesPresentTag class.
ELNotMatchTag Evalute the nested body content of this tag if the specified value is a substring of the specified variable.
ELNotMatchTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.logic.ELNotMatchTag class.
ELNotPresentTag Evaluates the nested body content of this tag if the specified value is not present for this request.
ELNotPresentTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.logic.ELNotPresentTag class.
ELPresentTag Evaluates the nested body content of this tag if the specified value is present for this request.
ELPresentTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.logic.ELPresentTag class.
ELRedirectTag Generate a URL-encoded redirect to the specified URI.
ELRedirectTagBeanInfo This is the BeanInfo descriptor for the org.apache.strutsel.taglib.logic.ELRedirectTag class.
 

Package org.apache.strutsel.taglib.logic Description

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.


[Introduction] [Logic-EL Functionality] [Logic-EL Examples]

Introduction

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.

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.

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 match and notMatch tags, and the additional attribute is named expr, 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.

Logic-EL Functionality

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 match and notMatch tags, being the expr attribute.

The match and notMatch 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 expr attribute allows the obtained value to come from an arbitrary expression language value.

Logic-EL Examples

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.

Example:

    <logic-el:forward name="${forwardName}"/>

Example:

    <%-- Iterates through all HTTP headers. --%>
    <logic-el:iterate id="item" collection="${header}">
    <tr>
    <td><c:out value="${item}.key"/></td>
    <td><c:out value="${item}.value"/></td>
    </tr>
    </logic-el:iterate>

Example:

    <logic-el:match cookie="${cookieName}" value="${cookieValue}">
    Match succeeded.
    </logic-el:match>

Example:

    <logic-el:match expr='${hash["foo"]}' value="${matchValue}">
    Match succeeded.
    </logic-el:match>

Example:

    <logic-el:messagesPresent property="${messageKey}">
    Message found.
    </logic-el:messagesPresent>

Example:

    <logic-el:redirect href="http://localhost:${portnum}/factory" />



Copyright © 2000-2008 Apache Software Foundation. All Rights Reserved.