|
BEA NetUI tags and APIs are included for backward compatibility only. For new applications, use the Beehive tags and APIs. | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.servlet.jsp.tagext.TagSupport javax.servlet.jsp.tagext.BodyTagSupport com.bea.wlw.netui.tags.AbstractBaseTag com.bea.wlw.netui.tags.databinding.invoke.AbstractCallMethod com.bea.wlw.netui.tags.databinding.invoke.CallMethod com.bea.wlw.netui.tags.databinding.invoke.CallPageFlow
public class CallPageFlow
A tag that is used to call a method on the current PageFlowController
.
The PageFlow on which to call the method is found given the location of the JSP page in the
webapp; if no PageFlow is found in the current directory, an ObjectNotFoundException
is
thrown and the tag execution fails.
This tag extends the CallMethod
tag, which defines additional attributes.
Once the method has been called, any return value is 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 |
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 | Yes | No | No |
Name of the method in the page flow that will be invoked. | |||
resultId | No | No | No |
The PageContext attribute name where the result,
if non-null, is stored. |
MethodParameter
,
CallMethod
,
CallControl
,
Serialized FormLabel
tag
accesses the result through the {pageContext...} data binding context.
<netui-data:callPageFlow method="sumCartItems" resultId="cartSum"> <netui-data:methodParameter value="{pageFlow.cart.lineItemList}"/> </netui-data:callPageFlow> ... <netui:label value="{pageContext.cartSum}"/>
[BEA_HOME]/weblogic81/samples/workshop/SamplesApp/tagSamples/netui_databinding/callPageFlow/callPageFlow.jsp
ObjectNotFoundException
is
thrown and the tag execution fails.
Any return value is stored in the
{pageContext...}
data binding context object under the
attribute specified by the resultId
attribute.
For example, if you call the hello
method with the following <netui-data:callPageFlow> tag...
<netui-data:callPageFlow method="hello" resultId="helloMessage" />
...the result of the call is stored in the {pageContext...}
data binding context under the
attribute helloMessage
.
The result can be retrieved with the data binding expression
{pageContext.helloMessage}
<netui:label value="{pageContext.helloMessage}"/>In a scriptlet, the result can be retrieved by calling the
getAttribute()
method on the
javax.servlet.jsp.PageContext
object:
<%= pageContext.getAttribute("helloMessage") %>
Note that only synchronous methods can be called with <netui-data:callPageFlow>. For handling asynchronous methods see the help topic Calling Web Services and Custom Java Controls From A Page Flow
Nested Class Summary |
---|
Nested classes/interfaces inherited from class com.bea.wlw.netui.tags.databinding.invoke.AbstractCallMethod |
---|
AbstractCallMethod.ParamNode |
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 | |
---|---|
CallPageFlow()
|
Method Summary | |
---|---|
protected String |
getObjectName()
Get the name of the object that is the target of the invocation. |
String |
getTagName()
Get the name of this tag. |
protected Object |
resolveObject()
Get the PageFlow for the using JSP's directory. |
Methods inherited from class com.bea.wlw.netui.tags.databinding.invoke.CallMethod |
---|
findMethod, getObject, localRelease, setObject |
Methods inherited from class com.bea.wlw.netui.tags.databinding.invoke.AbstractCallMethod |
---|
addParameter, doEndTag, doStartTag, getFailOnError, getMethod, getParameterNodes, getResultId, handleReturnValue, setFailOnError, setMethod, setResultId |
Methods inherited from class javax.servlet.jsp.tagext.BodyTagSupport |
---|
doAfterBody, 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 |
---|
public CallPageFlow()
Method Detail |
---|
public String getTagName()
getTagName
in class CallMethod
protected String getObjectName()
getObjectName
in class CallMethod
protected Object resolveObject() throws ObjectNotFoundException
CallMethod.resolveObject()
method that finds the current PageFlow
using the PageFlowUtils.getCurrentPageFlow(HttpServletRequest)
method.
resolveObject
in class CallMethod
ObjectNotFoundException
will
be thrown.
@inheritDoc
ObjectNotFoundException
- if an exception occurred attempting to resolve an object
|
BEA NetUI tags and APIs are included for backward compatibility only. For new applications, use the Beehive tags and APIs. | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |