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

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

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 ParameterMap
extends AbstractBaseTag

Writes each in a map of URL parameters to a URL on its parent tag. The parent tag must implement URLParams.

Attribute Descriptions
Attribute	Required	Runtime Expression Evaluation	Data Bindable
map	Yes	No	Read Only
	An expression pointing to a map of parameters.

See Also:

Parameter, Serialized Form

Example:

Assume that there is a java.util.HashMap object in the Controller file.

      public HashMap hashMap = new HashMap();
      hashMap.put("q", "Socrates");
      hashMap.put("lr", "lang_el");
      hashMap.put("as_qdr", "m3");

The following set of tags will read the HashMap object and generate a link with a set of URL parameters.

      <netui:anchor href="http://www.google.com/search">
          Search Greek language web sites updated in the last three months with the query "Socrates".
          <netui:parameterMap map="{pageFlow.hashMap}"/>
      </netui:anchor>

The URL produced appears as follows:

      http://www.google.com/search?lr=lang_el&q=Socrates&as_qdr=m3

Sample Code

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

[BEA_HOME]/weblogic81/samples/workshop/SamplesApp/WebApp/handlingData/binaryFlow/detailsDocumentContent.jsp

[BEA_HOME]/weblogic81/samples/workshop/SamplesApp/WebApp/netui_databinding/grid/detailsItems.jsp

Beadoc.see:

<netui:parameterMap> Tag Sample

Beadoc.tagdescription:

Writes a group of name/value pairs to the URL or the parent tag.

The <netui:parameterMap> can be nested inside of the Anchor, Button, Form, and Image tags.

You can dynamically determine the value of the <netui:parameterMap> tag by pointing the map attribute at a java.util.HashMap object.

Field Summary

protected String	map
protected Map	paramMap

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

ParameterMap()

Method Summary

int	doStartTag() Add each parameter in the URL parameter map to the Parameter's parent.
String	getMap() Gets the map expression.
String	getTagName() Return the name of the Tag.
protected void	localRelease() Release any acquired resources.
void	setMap(String map) Sets the map expression.

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

Field Detail

map

protected String map

paramMap

protected Map paramMap

Constructor Detail

ParameterMap

public ParameterMap()

Method Detail

getTagName

public String getTagName()

Return the name of the Tag.

Specified by:

getTagName in class AbstractBaseTag

getMap

public String getMap()

Gets the map expression.

Returns:

the map expression.

setMap

public void setMap(String map)
            throws javax.servlet.jsp.JspException

Sets the map expression.

Parameters:

map - - the map expression.

Throws:

javax.servlet.jsp.JspException

Beadoc.attributedescription:

A data binding expression pointing to a java.util.Map of parameters. The expression can point at any implementation of the java.util.Map interface, including java.util.AbstractMap, java.util.HashMap, java.util.Hashtable, etc.

Beadoc.attributesyntaxvalue:

string_mapObject

Beadoc.databindable:

Read Only

doStartTag

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

Add each parameter in the URL parameter map to the Parameter's parent.

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