# 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
Attribute | Required | Runtime Expression Evaluation | Data Bindable
--- | --- | --- | ---
controlId | No | No | Yes
A `PageContext``` attribute name whose value is the control to call.
failOnError | No | No | No
A boolean that if `true` will cause the tag to report any method invocation errors in-line in the rendered page.
method | No | No | No
Name of the method in the control that will be invoked.
resultId | No | No | No
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