com.bea.wlw.netui.tags.html
Class BindingUpdateErrors

java.lang.Object
  javax.servlet.jsp.tagext.TagSupport
      javax.servlet.jsp.tagext.BodyTagSupport
          com.bea.wlw.netui.tags.AbstractBaseTag
              com.bea.wlw.netui.tags.html.BindingUpdateErrors

All Implemented Interfaces:

HtmlConstants, Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag

public class BindingUpdateErrors
extends AbstractBaseTag

Renders the set of error messages found during the process of resolving data binding expressions ({pageFlow.firstname}, {request.firstname}, etc.).

These errors are treated as warnings. By default, this tag is only active in Development mode and the warning are not displayed in Production mode. The tag is intended for development use.

Attribute Descriptions
Attribute	Required	Runtime Expression Evaluation	Data Bindable
alwaysReport	No	No	No
	This attribute will override the default behavior of only showing errors in iterative development mode, so they are also shown in production mode.
expression	No	No	No
	This attribute will display errors only for the specified expression.

See Also:

Serialized Form

Example:

In this first sample, because the <netui:bindingUpdateErrors/> tag is unqualified, messages will be displayed if any data binding errors occurred when a form was posted. The messages are displayed on the page and in the Server console.

<netui:bindingUpdateErrors />

In this next sample, only binding errors for the expression {actionForm.firstName} will be displayed.

<netui:bindingUpdateErrors expression="{actionForm.firstName}"/>

Code Sample

[BEA_HOME]/weblogic81/samples/workshop/SamplesApp/WebApp/tagSamples/netui/bindingUpdateErrors/index.jsp

Beadoc.see:

<netui:bindingUpdateErrors> Tag Sample

Beadoc.tagdescription:

Renders the set of error messages found during the process of resolving data binding expressions ({pageFlow.firstname}, {request.firstname}, etc.). By default, the error messages are only rendered when WebLogic Server is in Development mode; the messages are not displayed in Production mode. The tag is intended for development use, not for error reporting in deployed applications.

Field Summary

Fields inherited from class com.bea.wlw.netui.tags.AbstractBaseTag

ATTR_GENERAL, ATTR_GENERAL_EXPRESSION, ATTR_JAVASCRIPT, ATTR_STYLE, JAVASCRIPT_STATUS, NETUI_UNIQUE_CNT

Fields inherited from class javax.servlet.jsp.tagext.BodyTagSupport

bodyContent

Fields inherited from class javax.servlet.jsp.tagext.TagSupport

id, pageContext

Fields inherited from interface com.bea.wlw.netui.tags.html.HtmlConstants

ACCEPT, ACCESSKEY, ACTION, ALIGN, ALINK, ALT, ANCHOR, BACKGROUND, BASE, BGCOLOR, BODY, BORDER, BR, CAPTION, CELLPADDING, CELLSPACING, CHAR, CHAROFF, CHARSET, CHECKED, CLASS, COLS, COORDS, DIR, DISABLED, DIV, ENCTYPE, FOR, FORM, FORM_GET, FORM_POST, FRAME, HEIGHT, HREF, HREFLANG, HSPACE, HTML, ID, IMAGE, INPUT, INPUT_BUTTON, INPUT_CHECKBOX, INPUT_FILE, INPUT_HIDDEN, INPUT_IMAGE, INPUT_PASSWORD, INPUT_RADIO, INPUT_RESET, INPUT_SUBMIT, INPUT_TEXT, ISMAP, LABEL, LANG, LINK, LONGDESC, MAXLENGTH, METHOD, NAME, ONBLUR, ONCHANGE, ONCLICK, ONDBLCLICK, ONFOCUS, ONKEYDOWN, ONKEYPRESS, ONKEYUP, ONLOAD, ONMOUSEDOWN, ONMOUSEMOVE, ONMOUSEOUT, ONMOUSEOVER, ONMOUSEUP, ONRESET, ONSELECT, ONSUBMIT, ONUNLOAD, OPTION, READONLY, REL, REV, ROWS, RULES, SELECT, SHAPE, SIZE, SPAN, SRC, STYLE, SUMMARY, TABINDEX, TABLE, TARGET, TD, TEXT, TEXTAREA, TITLE, TR, TYPE, USEMAP, VALIGN, VALUE, VLINK, VSPACE, WIDTH

Fields inherited from interface javax.servlet.jsp.tagext.BodyTag

EVAL_BODY_BUFFERED, EVAL_BODY_TAG

Fields inherited from interface javax.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Fields inherited from interface javax.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

BindingUpdateErrors()

Method Summary

int	doStartTag() Render the specified error messages if there are any.
String	getExpression() Returns the expression to match for binding errors.
String	getTagName() Return the name of the Tag.
boolean	isAlwaysReport() Returns true if errors are reported in production mode.
protected void	localRelease() Release any acquired resources.
void	setAlwaysReport(boolean alwaysReport) Set the value which will override the default behavior of not showing errors in production mode.
void	setExpression(String expression) Sets the expression to match for binding errors.

Methods inherited from class com.bea.wlw.netui.tags.AbstractBaseTag

addTagIdMapping, containsExpression, evaluateAttributeToString, evaluateExpression, filter, filter, formatErrorString, formatString, getAttribute, getErrorsReport, getExpressionEvaluator, getJavaScriptUtils, getNearestForm, getNextId, getQualifiedBundleName, getScriptReporter, getUserLocale, hasErrors, isExpression, prepForRendering, registerAttribute, registerError, registerTagError, release, removeAttribute, renderAttribute, renderAttributes, reportErrors, rewriteName, setPageContext, updateExpression, write

Methods inherited from class javax.servlet.jsp.tagext.BodyTagSupport

doAfterBody, doEndTag, doInitBody, getBodyContent, getPreviousOut, setBodyContent

Methods inherited from class javax.servlet.jsp.tagext.TagSupport

findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setParent, setValue

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.servlet.jsp.tagext.Tag

getParent, setParent

Constructor Detail

BindingUpdateErrors

public BindingUpdateErrors()

Method Detail

getTagName

public String getTagName()

Return the name of the Tag.

Specified by:

getTagName in class AbstractBaseTag

getExpression

public String getExpression()

Returns the expression to match for binding errors. If an expression is set, only binding errors for that expression will be displayed. Otherwise, all errors will be displayed.

Returns:

the expression being match

setExpression

public void setExpression(String expression)

Sets the expression to match for binding errors. If an expression is set, only binding errors for that expression will be displayed. Otherwise, all errors will be displayed.

Parameters:

expression - The expression to match against.

Beadoc.attributedescription:

String. The data binding expression to match for binding errors. If an data binding expression is specified, only binding errors for that expression will be displayed. Otherwise, all errors will be displayed.

Beadoc.attributesyntaxvalue:

string_databinding_expression

Beadoc.databindable:

false

isAlwaysReport

public boolean isAlwaysReport()

Returns true if errors are reported in production mode. The default behavior is to only display errors in interative development.

Returns:

the boolean value indicating if errors are reported in production mode.

setAlwaysReport

public void setAlwaysReport(boolean alwaysReport)

Set the value which will override the default behavior of not showing errors in production mode.

Parameters:

alwaysReport - a boolean that if true will cause the errors to always be displayed. The default is false

Beadoc.attributedescription:

Boolean. If isAlwaysReport is set to true, then the errors will be displayed in Production mode as well as in Development mode. Otherwise, the errors will be displayed only in Development mode.

Beadoc.attributesyntaxvalue:

boolean_always_report

Beadoc.databindable:

false

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.BodyTagSupport

Throws:

javax.servlet.jsp.JspException - if a JSP exception has occurred

localRelease

protected void localRelease()

Release any acquired resources.

Overrides:

localRelease in class AbstractBaseTag