org.apache.strutsel.taglib.logic (Struts EL 1.3.10 API)

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## 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" />

          Overview
        Package
          Class
          Use
          Tree
          Deprecated
          Index
          Help

     PREV PACKAGE
     NEXT PACKAGE

      FRAMES
     NO FRAMES

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