ErrorsTag (Apache Struts API Documentation)
Keywords: org.apache.struts.taglib.html.ErrorsTag,ErrorsTag class

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.struts.taglib.html
Class ErrorsTag

    java.lang.Object
      |
      +--javax.servlet.jsp.tagext.TagSupport
            |
            +--org.apache.struts.taglib.html.ErrorsTag

All Implemented Interfaces:
  java.io.Serializable, javax.servlet.jsp.tagext.Tag

Direct Known Subclasses:
  NestedErrorsTag

public class ErrorsTag
extends javax.servlet.jsp.tagext.TagSupport

Custom tag that renders error messages if an appropriate request attribute has been created. The tag looks for a request attribute with a reserved key, and assumes that it is either a String, a String array, containing message keys to be looked up in the module's MessageResources, or an object of type `org.apache.struts.action.ActionErrors`.

The following optional message keys will be utilized if corresponding messages exist for them in the application resources:

- errors.header - If present, the corresponding message will be rendered prior to the individual list of error messages.
- errors.footer - If present, the corresponding message will be rendered following the individual list of error messages.
- errors.prefix - If present, the corresponding message will be rendered before each individual error message.
- errors.suffix - If present, the corresponding message will be rendered after each individual error message.

Version:
  $Revision: 1.1 $ $Date: 2003-08-26 13:57:44 +0100 (Tue, 26 Aug 2003) $
Author:
  Craig R. McClanahan
See Also:
  Serialized Form

Field Summary
`protected java.lang.String` | `bundle` The servlet context attribute key for our resources.
`protected static java.util.Locale` | `defaultLocale` Deprecated. Use Locale.getDefault() directly.
`protected static java.lang.String` | `lineEnd` The line ending string.
`protected java.lang.String` | `locale` The session attribute key for our locale.
`protected static MessageResources` | `messages` The message resources for this package.
`protected java.lang.String` | `name` The request attribute key for our error messages (if any).
`protected java.lang.String` | `property` The name of the property for which error messages should be returned, or `null` to return all errors.

Fields inherited from class javax.servlet.jsp.tagext.TagSupport
`id, pageContext`

Fields inherited from interface javax.servlet.jsp.tagext.Tag
`EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE`

Constructor Summary
`ErrorsTag()`

Method Summary
`int` | `doStartTag()` Render the specified error messages if there are any.
`java.lang.String` | `getBundle()`
`java.lang.String` | `getLocale()`
`java.lang.String` | `getName()`
`java.lang.String` | `getProperty()`
`void` | `release()` Release any acquired resources.
`void` | `setBundle(java.lang.String bundle)`
`void` | `setLocale(java.lang.String locale)`
`void` | `setName(java.lang.String name)`
`void` | `setProperty(java.lang.String property)`

Methods inherited from class javax.servlet.jsp.tagext.TagSupport
`doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### bundle

    protected java.lang.String bundle

  The servlet context attribute key for our resources.

### defaultLocale

    protected static java.util.Locale defaultLocale

  Deprecated. Use Locale.getDefault() directly.

  The default locale on our server.

### lineEnd

    protected static java.lang.String lineEnd

  The line ending string.

### locale

    protected java.lang.String locale

  The session attribute key for our locale.

### messages

    protected static MessageResources messages

  The message resources for this package.

### name

    protected java.lang.String name

  The request attribute key for our error messages (if any).

### property

    protected java.lang.String property

  The name of the property for which error messages should be returned, or `null` to return all errors.

Constructor Detail

### ErrorsTag

    public ErrorsTag()

Method Detail

### getBundle

    public java.lang.String getBundle()

### setBundle

    public void setBundle(java.lang.String bundle)

### getLocale

    public java.lang.String getLocale()

### setLocale

    public void setLocale(java.lang.String locale)

### getName

    public java.lang.String getName()

### setName

    public void setName(java.lang.String name)

### getProperty

    public java.lang.String getProperty()

### setProperty

    public void setProperty(java.lang.String property)

### doStartTag

    public int doStartTag()
                   throws javax.servlet.jsp.JspException

  Render the specified error messages if there are any.

  Specified by:
    `doStartTag` in interface `javax.servlet.jsp.tagext.Tag`
  Overrides:
    `doStartTag` in class `javax.servlet.jsp.tagext.TagSupport`
  Throws:
    `javax.servlet.jsp.JspException` - if a JSP exception has occurred

### release

    public void release()

  Release any acquired resources.

  Specified by:
    `release` in interface `javax.servlet.jsp.tagext.Tag`
  Overrides:
    `release` in class `javax.servlet.jsp.tagext.TagSupport`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2000-2003 - Apache Software Foundation