|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.cabo.ui.DeprecatedUINode | +--oracle.cabo.ui.BaseUINode | +--oracle.cabo.ui.BaseMutableUINode | +--oracle.cabo.ui.beans.BaseWebBean | +--oracle.cabo.ui.beans.MarlinBean | +--oracle.cabo.ui.beans.ProcessingBean
This bean is not supported on the following agent types: pda.
A processing
element can be used to give users
an understanding that there is a back end process in progress.
The processing
element visually stacks a
processing icon and the indexed children. If you know the percent complete,
then the processing icon indicates how far along
the process is. If the percent complete is unknown, then the processing icon
indicates that there is no estimate of the completion time.
The indexed children describe the process.
If the percentComplete
attribute is
the UIConstant PERCENT_UNKNOWN,
then the icon is a spinning clock animated gif.
If the percentComplete
attribute is
an integer from 0 to 100 (inclusive), then the icon is a status bar indicating the
percent complete.
The processing
element triggers a
"refresh" event after the time interval specified by the
timeInterval
attribute (in milliseconds).
You should handle this event and determine whether or not the process is complete,
and if possible, determine the percent complete. You can databind the
percentComplete
attribute. You can also redirect
to a new page if the process is complete.
The processing element triggers the "refresh" event either as a form submit or as an URL with standard arguments. The parameters sent are:
event
source
If the processing element is within a form, then the form name is automatically detected, and the form will be submitted on every refresh along with special hidden field values, event and source. If the processing element is not within a form, then the "refresh" event parameters will be appended to the URL.
After the event is fired, the element will refresh either in Partial
Page Rendering (PPR) mode or a full page refresh, and the event will fire
again after the timeInterval
.
If PPR is enabled, then the processing
element, along with its indexed children, will be automatically
refreshed in PPR mode. Otherwise, a full refresh will occur. Be sure
to specify the id
attribute so that the processing
element can be refreshed in PPR mode when available.
For the indexed children which describe the process status, you should conform to a layout as specified in the Processing Layout BLAF. You should use the styleClass "OraProcessingStatusVariable" for the variable portion of the status and the styleClass "OraProcessingStatusFixed" for the fixed portion of the status.
Basic example to create a processing element when you know the percent complete:
<processing id="processing-widget" percentComplete="75" timeInterval="2000"> <contents> <styledText styleClass="OraProcessingStatusVariable" text="75%"/> <styledText styleClass="OraProcessingStatusFixed" text=" of the baking is done." /> </contents> </processing>
Basic example to create a processing element when you do not know the percent complete:
<processing id="processing-widget" percentComplete="unknown" timeInterval="2000"> <contents> <styledText styleClass="OraProcessingStatusFixed" text="The cake is baking." /> </contents> </processing>
UIConstants
Constructor Summary | |
|
ProcessingBean()
Construct an instance of the ProcessingBean. |
protected |
ProcessingBean(boolean ignored,
java.lang.String localName)
Construct an instance of the ProcessingBean. |
|
ProcessingBean(int timeInterval)
Construct an instance of the ProcessingBean. |
|
ProcessingBean(int percentComplete,
int timeInterval)
Construct an instance of the ProcessingBean. |
Method Summary | |
java.lang.String |
getDestination()
Gets The base URL used when firing the refresh event when a form is not used. |
static java.lang.String |
getDestination(MutableUINode bean)
Gets The base URL used when firing the refresh event when a form is not used. |
int |
getPercentComplete()
Gets An integer between 0 to 100 (inclusive), or the UIConstant PERCENT_UNKNOWN. |
static int |
getPercentComplete(MutableUINode bean)
Gets An integer between 0 to 100 (inclusive), or the UIConstant PERCENT_UNKNOWN. |
int |
getTimeInterval()
Gets The time between refresh events, in milliseconds. |
static int |
getTimeInterval(MutableUINode bean)
Gets The time between refresh events, in milliseconds. |
static void |
setDestination(MutableUINode bean,
java.lang.String destination)
Sets The base URL used when firing the refresh event when a form is not used. |
void |
setDestination(java.lang.String destination)
Sets The base URL used when firing the refresh event when a form is not used. |
void |
setPercentComplete(int percentComplete)
Sets An integer between 0 to 100 (inclusive), or the UIConstant PERCENT_UNKNOWN. |
static void |
setPercentComplete(MutableUINode bean,
int percentComplete)
Sets An integer between 0 to 100 (inclusive), or the UIConstant PERCENT_UNKNOWN. |
void |
setTimeInterval(int timeInterval)
Sets The time between refresh events, in milliseconds. |
static void |
setTimeInterval(MutableUINode bean,
int timeInterval)
Sets The time between refresh events, in milliseconds. |
Methods inherited from class oracle.cabo.ui.beans.MarlinBean |
isEqualMarlinName |
Methods inherited from class oracle.cabo.ui.BaseUINode |
getAttributeNames, getAttributeValue, getAttributeValueImpl, getChildArray, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getPreorderDescendentAttributeValue, getRawAttributeValue, getRenderedUINode, getRenderer, getRenderer, render, render, toString |
Methods inherited from class oracle.cabo.ui.DeprecatedUINode |
getAttributeValue, getChildNames, getNamedChild |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface oracle.cabo.ui.UINode |
getAttributeNames, getAttributeValue, getAttributeValue, getChildNames, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getRawAttributeValue, render, render |
Constructor Detail |
public ProcessingBean()
public ProcessingBean(int percentComplete, int timeInterval)
percentComplete
- An integer between 0 to 100 (inclusive), or
the UIConstant PERCENT_UNKNOWN.timeInterval
- The time between refresh events, in milliseconds.public ProcessingBean(int timeInterval)
timeInterval
- The time between refresh events, in milliseconds.protected ProcessingBean(boolean ignored, java.lang.String localName)
Method Detail |
public final java.lang.String getDestination()
public final void setDestination(java.lang.String destination)
public final int getPercentComplete()
public final void setPercentComplete(int percentComplete)
public final int getTimeInterval()
public final void setTimeInterval(int timeInterval)
public static java.lang.String getDestination(MutableUINode bean)
public static void setDestination(MutableUINode bean, java.lang.String destination)
public static int getPercentComplete(MutableUINode bean)
public static void setPercentComplete(MutableUINode bean, int percentComplete)
public static int getTimeInterval(MutableUINode bean)
public static void setTimeInterval(MutableUINode bean, int timeInterval)
|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |