CallControl Class

com.bea.wlw.netui.tags.databinding.invoke
CallControl Class

public class CallControl

    extends AbstractCallMethod

A tag that is used to call a method on a control. The control on which to invoke the method is taken from the PageContext attribute map, and the given method is reflectively invoked using the parameters provided in any nested MethodParameter tags.

This tag extends the CallMethod tag, which defines additional attributes.

The controlId attribute is used to specify a Control in the PageContext attribute map; the method will be invoked on this Control. Any return value will be set in the PageContext attribute map under the resultId attribute that is provided on the CallMethod tag. In the case that the return value is a primitive type, the primitive type's object wrapper is set in the PageContext under the resultId key.

Attribute Descriptions
AttributeRequiredRuntime Expression EvaluationData Bindable
controlIdNoNoYes
A PageContext attribute name whose value is the control to call.
failOnErrorNoNoNo
A boolean that if true will cause the tag to report any method invocation errors in-line in the rendered page.
methodNoNoNo
Name of the method in the control that will be invoked.
resultIdNoNoNo
The PageContext attribute name where the result, if non-null, is stored.

Related Topics

<netui-data:callControl> Tag Sample
MethodParameter
CallMethod
CallPageFlow


Hierarchy
Object
  TagSupport
    BodyTagSupport
      AbstractBaseTag
        AbstractCallMethod
          CallControl
All Implemented Interfaces

BodyTag, IterationTag, Serializable, Tag

Field Summary

   
Fields from  com.bea.wlw.netui.tags.AbstractBaseTag
ATTR_GENERAL, ATTR_GENERAL_EXPRESSION, ATTR_JAVASCRIPT, ATTR_STYLE, CLASS, ID, JAVASCRIPT_STATUS, NAME, NETUI_UNIQUE_CNT, ONCLICK, ONDBLCLICK, ONKEYDOWN, ONKEYPRESS, ONKEYUP, ONMOUSEDOWN, ONMOUSEMOVE, ONMOUSEOUT, ONMOUSEOVER, ONMOUSEUP, STYLE, TABINDEX
 
Fields from  javax.servlet.jsp.tagext.BodyTagSupport
bodyContent
 
Fields from  javax.servlet.jsp.tagext.TagSupport
id, pageContext
 
Fields from interface javax.servlet.jsp.tagext.BodyTag
EVAL_BODY_BUFFERED, EVAL_BODY_TAG
 
Fields from interface javax.servlet.jsp.tagext.IterationTag
EVAL_BODY_AGAIN
 
Fields from interface javax.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 

Constructor Summary

CallControl()

 

Method Summary

public String
getControlId()
Get the String identifier of the Control that on which a method will be invoked.
protected String
getObjectName()
Get the name of the object that is the target of the invocation.
public String
getTagName()
Get the name of this tag.
protected void
localRelease()
Reset all of the fields of this tag.
protected Object
resolveObject()
Get the Control whose method to invoke.
public void
setControlId(String controlId)
Set the String which identifies the Control on which a method will be invoked.
 
Methods from  com.bea.wlw.netui.tags.databinding.invoke.AbstractCallMethod
addParameter, doEndTag, doStartTag, findMethod, getFailOnError, getMethod, getParameterNodes, getResultId, handleReturnValue, setFailOnError, setMethod, setResultId
 
Methods from  com.bea.wlw.netui.tags.AbstractBaseTag
addTagIdMapping, evaluateAttributeToString, filter, filter, getJavaScriptUtils, getNearestForm, getScriptReporter, getUserLocale, localRelease, registerTagError, release, renderAttribute, rewriteName, write
 
Methods from  javax.servlet.jsp.tagext.BodyTagSupport
doAfterBody, doEndTag, doInitBody, doStartTag, getBodyContent, getPreviousOut, release, setBodyContent
 
Methods from  javax.servlet.jsp.tagext.TagSupport
doAfterBody, doEndTag, doStartTag, findAncestorWithClass, getId, getParent, getValue, getValues, release, removeValue, setId, setPageContext, setParent, setValue
 
Methods from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
   
Methods from interface javax.servlet.jsp.tagext.BodyTag
doInitBody, setBodyContent
 
Methods from interface javax.servlet.jsp.tagext.IterationTag
doAfterBody
 
Methods from interface javax.servlet.jsp.tagext.Tag
doEndTag, doStartTag, getParent, release, setPageContext, setParent
 

Constructor Detail

CallControl

public CallControl()
 

Method Detail

getControlId() Method

public String getControlId()
Get the String identifier of the Control that on which a method will be invoked.

Returns

the String identifier that references the Control

getObjectName() Method

protected String getObjectName()
Get the name of the object that is the target of the invocation.

Overrides
AbstractCallMethod.getObjectName()

Returns

a name for the object on which the method will be invoked.

getTagName() Method

public String getTagName()
Get the name of this tag. This is used to identify the type of this tag for reporting tag errors.

Overrides
AbstractBaseTag.getTagName()

Returns

a constant String representing the name of this tag.

localRelease() Method

protected void localRelease()
Reset all of the fields of this tag.

Overrides
AbstractCallMethod.localRelease()

resolveObject() Method

protected Object resolveObject()
throws ObjectNotFoundException
Get the Control whose method to invoke. This is an implementation of the CallMethod.resolveObject() method that looks for a Control in the PageContext attribute map of the current JSP page.

Overrides
AbstractCallMethod.resolveObject()

Returns

the Control on which to invoke the method

Exceptions

ObjectNotFoundException

setControlId(String) Method

public void setControlId(String controlId)
Set the String which identifies the Control on which a method will be invoked.

Parameters

controlId
the String identifier that references the Control