com.bea.wlw.netui.tags
Class OptionsDataSourceTag

java.lang.Object
  javax.servlet.jsp.tagext.TagSupport
      javax.servlet.jsp.tagext.BodyTagSupport
          com.bea.wlw.netui.tags.AbstractBaseTag
              com.bea.wlw.netui.tags.DataSourceTag
                  com.bea.wlw.netui.tags.DefaultableDataSourceTag
                      com.bea.wlw.netui.tags.OptionsDataSourceTag

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

Direct Known Subclasses:

CheckBoxGroup, RadioButtonGroup, Select

public abstract class OptionsDataSourceTag
extends DefaultableDataSourceTag

Abstract tag class that adds support for an OptionsDataSource. OptionsDataSource is used to populate a set of option tag children for the containing tag.

For example, a set of CheckBoxOptions for a CheckBoxGroup.

See Also:

Serialized Form

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

OptionsDataSourceTag()

Method Summary

protected Object	evaluateOptionsDataSource()
String	getOptionsDataSource() Gets the options datasource value (an expression).
protected void	localRelease() Release any acquired resources.
void	setOptionsDataSource(String optionsDataSource) Sets the options datasource value (an expression).

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

evaluateDefaultValue, getDefaultValue, setDefaultValue

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

addNamingInterceptor, doNaming, evaluateDataSource, getDataSource, qualifyAttribute, removeNamingInterceptor, setDataSource

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, getTagName, 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, doStartTag, 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

OptionsDataSourceTag

public OptionsDataSourceTag()

Method Detail

getOptionsDataSource

public String getOptionsDataSource()

Gets the options datasource value (an expression).

Returns:

the options datasource

Beadoc.attributedescription:

The optionsDataSource attribute determines the set of options presented to the user.

In a <netui:select> tag, the options are rendered as a set of <netui:option> tags.
In a <netui:checkBoxGroup> tag, the options are rendered as a set of <netui:checkBox> tags.
In a <netui:radioButtonGroup> tag, the options are rendered as a set of <netui:radionButton> tags.

The options can be determined dynamically by pointing the optionsDataSource at a String[] object or an object that implements java.util.Map. In either case, a set of options will be rendered based on the content of the String[] or java.util.Map object. One option will be rendered for each element in the String[] or for each entry in the java.util.Map.

If a java.util.Map object is used, the display name and underlying value of each option may be set independently. (The display name will be rendered based on the value of each Map entry; the underlying value will be rendered based on the key of each Map entry.) If a String[] object is used, the display name and underlying value of each option will be identical. See the Description and Sample sections of this topic for details.

Use a data binding expression to point the optionsDataSource at the String[] or java.util.Map object. For instance, assuming that myStrArr is a member variable of the Controller file (= the JPF file), then the following optionsDataSource points at myStrArr.

optionsDataSource={pageFlow.myStrArr}

Beadoc.attributesyntaxvalue:

expression_datasource

Beadoc.databindable:

Read Only

setOptionsDataSource

public void setOptionsDataSource(String optionsDataSource)
                          throws javax.servlet.jsp.JspException

Sets the options datasource value (an expression).

Parameters:

optionsDataSource - - the options datasource

Throws:

javax.servlet.jsp.JspException

evaluateOptionsDataSource

protected Object evaluateOptionsDataSource()
                                    throws javax.servlet.jsp.JspException

Throws:

javax.servlet.jsp.JspException

Exclude:

localRelease

protected void localRelease()

Release any acquired resources.

Overrides:

localRelease in class DefaultableDataSourceTag