Skip navigation links

com.oracle.bpel.client
Interface IBPELProcessHandle

All Superinterfaces:

IBPELProcessConstants

public interface IBPELProcessHandle

extends IBPELProcessConstants

The IProcessHandle interface allows the user to introspect a BPEL process deployed on a BPEL process domain.

If this handle has been retrieved via the Locator or IBPELDomainHandle class, the process associated with this handle might not have been loaded successfully. In this case, most of the methods declared by this interface will not work. The list of methods that will work if the process has not been loaded is:

• getDomainId
• getProcessId
• getRevisionTag
• getErrors
• getSOAPLocation
• getWarnings
• getOpenInstanceCount
• getClosedInstanceCount
• listInstances
• listInstances( int, int )

Since:

1.0

Field Summary

Fields inherited from interface com.oracle.bpel.client.IBPELProcessConstants

LIFECYCLE_ACTIVE, LIFECYCLE_RETIRED, OP_TYPE_CONTINUE_POST, OP_TYPE_CONTINUE_REQUEST, OP_TYPE_INITIAL_POST, OP_TYPE_INITIAL_REQUEST, OP_TYPE_UNDEFINED, STATE_OFF, STATE_ON

Method Summary

IActivationAgentHandle	getActivationAgentHandle(java.lang.String className) Returns a handle to the activation agent registered for this BPEL process.
int	getClosedInstanceCount() Returns the number of closed instances that belong to this BPEL process.
java.lang.String	getContent(java.lang.String rPath) Returns the content of the embedded process file with the relative path specified by rPath.
com.collaxa.cube.rm.suitcase.ProcessDescriptor	getDescriptor() Returns the process descriptor for this BPEL process.
java.lang.Throwable[]	getErrors() Returns the list of errors that have been reported during the loading of this BPEL process.
java.lang.String	getFormContent(java.lang.String partnerLinkName, java.lang.String roleName, java.lang.String operationName) Returns the HTML form content for the callback page for this process.
java.lang.String	getInitiateFormContent(java.lang.String operationName) Returns the HTML form content for the initiation page for this process.
java.lang.String[]	getInitiateOperationNames() Returns the operation of the process that can initiate an instance (that is, a receive tag in the BPEL source that looks like
com.oracle.bpel.client.BPELProcessMetaData	getMetaData() Returns the revision information for this BPEL process.
int	getOpenInstanceCount() Returns the number of open instances that belong to this BPEL process.
int	getOperationType(java.lang.String operationName) Returns the operation type for the given operation name.
int	getOperationType(java.lang.String partnerLinkName, java.lang.String roleName, java.lang.String operationName) Returns the operation type for the operation defined for the given partner and role.
BPELProcessId	getProcessId() Returns the identifier of this process.
java.lang.String	getProcessModel() Returns the debugger XML model of this BPEL process.
java.lang.String	getSensorActionDefinitions() Returns this process's sensor action definitions.
java.lang.String	getSensorDefinitions() Returns this process's sensor definitions.
java.lang.String	getSOAPLocation() Returns the URL of the SOAP listening post for this process.
java.lang.String[]	getWarnings() Returns the list of warnings that have been reported during the loading of this BPEL process.
boolean	isDefaultRevision() Returns true if this BPEL process is the default revision.
boolean	isLoaded() Returns true if the BPEL process been loaded successfully (that is, without any initialization errors).
IInstanceHandle[]	listInstances() Returns a list of active instances associated with this BPEL process.
IInstanceHandle[]	listInstances(int listStart, int listSize) Returns a list of active instances associated with this BPEL process.
void	markAsDefaultRevision() Schedules this BPEL process to be marked as the default revision.
java.util.Map	readFormContentAsString(java.lang.String partnerLinkName, java.lang.String roleName, java.lang.String operationName, Parameters req) Parses the HTML request parameters according to the format expected for this process into a series of String objects.
java.util.Map	readInitiateFormContentAsString(java.lang.String operationName, Parameters req) Parses the HTML request parameters according to the format expected for this process into a series of String objects.
void	startActivationAgent(java.lang.String partnerLinkName)
void	startAllActivationAgents()
void	stopActivationAgent(java.lang.String partnerLinkName)
void	stopAllActivationAgents()
void	updateDescriptor(com.collaxa.cube.rm.suitcase.ProcessDescriptor pd) Updates the process descriptor of the BPEL process with the values contained in the passed descriptor.
void	updateMetaData(com.oracle.bpel.client.BPELProcessMetaData md) Updates the BPEL process with the values contained in the passed revision class.

Method Detail

getOperationType

int getOperationType(java.lang.String operationName)
                     throws ServerException

Returns the operation type for the given operation name.

Valid operation types are:

• -1 - undefined
• 0 - initial post (asynchronous)

  <receive createInstance="yes">
  

  with an optional

  <reply>
  

• 1 - initial request (synchronous)

  <receive createInstance="yes">
  

  with a

  <reply>
  

• 2 - continue post (asynchronous)

  <receive>, <onMessage>
  

  without a

  <reply>
  

• 3 - continue request (synchronous)

  <receive>, <onMessage>
  

  with a

  <reply>
  

Throws:

ServerException - if there is a problem connecting to the process.

getOperationType

int getOperationType(java.lang.String partnerLinkName,
                     java.lang.String roleName,
                     java.lang.String operationName)
                     throws ServerException

Returns the operation type for the operation defined for the given partner and role. See getOperationType( String ) for list of operation types returned.

Throws:

ServerException - if there is a problem connecting to the process.

getInitiateOperationNames

java.lang.String[] getInitiateOperationNames()
                                             throws ServerException

Returns the operation of the process that can initiate an instance (that is, a receive tag in the BPEL source that looks like

<receive createInstance="yes">

).

Throws:

ServerException - if there is a problem connecting to the process.

isLoaded

boolean isLoaded()

Returns true if the BPEL process been loaded successfully (that is, without any initialization errors). If the process has been loaded, there may still be warnings associated with the loading process.

See Also:

getErrors(), getWarnings()

getProcessId

BPELProcessId getProcessId()

Returns the identifier of this process.

getErrors

java.lang.Throwable[] getErrors()
                                throws ServerException

Returns the list of errors that have been reported during the loading of this BPEL process. If the process has been loaded successfully, the BPEL process will not have any errors associated with it.

Throws:

ServerException - if there is a problem connecting to the process.

getSOAPLocation

java.lang.String getSOAPLocation()
                                 throws ServerException

Returns the URL of the SOAP listening post for this process.

Throws:

ServerException - if there is a problem connecting to the process.

getWarnings

java.lang.String[] getWarnings()
                               throws ServerException

Returns the list of warnings that have been reported during the loading of this BPEL process. Warnings may be reported even though the BPEL process has successfully been loaded.

Throws:

ServerException - if there is a problem connecting to the process.

getDescriptor

com.collaxa.cube.rm.suitcase.ProcessDescriptor getDescriptor()
                                                             throws ServerException

Returns the process descriptor for this BPEL process. The process descriptor contains run-time properties such as service locations.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process.

updateDescriptor

void updateDescriptor(com.collaxa.cube.rm.suitcase.ProcessDescriptor pd)
                      throws ServerException

Updates the process descriptor of the BPEL process with the values contained in the passed descriptor.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process or if there is a problem updating the process.

getMetaData

com.oracle.bpel.client.BPELProcessMetaData getMetaData()
                                                       throws ServerException

Returns the revision information for this BPEL process. The revision information class contains state, lifecycle and revision details.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process.

updateMetaData

void updateMetaData(com.oracle.bpel.client.BPELProcessMetaData md)
                    throws ServerException

Updates the BPEL process with the values contained in the passed revision class.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process or if there is a problem updating the process.

isDefaultRevision

boolean isDefaultRevision()
                          throws ServerException

Returns true if this BPEL process is the default revision. The default revision is selected if an invocation message does not specify the revision tag of the process to invoke.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process.

markAsDefaultRevision

void markAsDefaultRevision()
                           throws ServerException

Schedules this BPEL process to be marked as the default revision. The default revision is selected if an invocation message does not specify the revision tag of the process to invoke.

The process will not be marked as the default immediately; the action will be scheduled by the server to be performed asynchronously.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process.

getProcessModel

java.lang.String getProcessModel()
                                 throws ServerException

Returns the debugger XML model of this BPEL process. This model describes the layout of the lower-level components that comprise a process method after it has been transformed by the bpelc tool.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process.

getContent

java.lang.String getContent(java.lang.String rPath)
                            throws ServerException

Returns the content of the embedded process file with the relative path specified by rPath. When a process archive is generated using the bpelc tool files may be embedded within the archive. The content of these files can be accessed using this method.

The path to access the file is the same as it is in the BPEL process archive file.

This method will throw a ServerException if the process has not loaded successfully.

Parameters:

rPath - the relative path of the file

Throws:

ServerException - if there is a problem connecting to the process or if there is a problem fetching the file content.

getInitiateFormContent

java.lang.String getInitiateFormContent(java.lang.String operationName)
                                        throws ServerException

Returns the HTML form content for the initiation page for this process.

This method will throw a ServerException if the process has not loaded successfully.

Parameters:

operationName - the initiate operation name

Throws:

ServerException - if there is a problem connecting to the process.

getFormContent

java.lang.String getFormContent(java.lang.String partnerLinkName,
                                java.lang.String roleName,
                                java.lang.String operationName)
                                throws ServerException

Returns the HTML form content for the callback page for this process.

This method will throw a ServerException if the process has not loaded successfully.

Parameters:

partnerLink - the aame of the partnerLink of the BPEL receive

role - the name of the BPEL receive

operationName - the initiate operation name of the BPEL receive

Throws:

ServerException - if there is a problem connecting to the process.

readInitiateFormContentAsString

java.util.Map readInitiateFormContentAsString(java.lang.String operationName,
                                              Parameters req)
                                              throws ServerException

Parses the HTML request parameters according to the format expected for this process into a series of String objects.

This method will throw a ServerException if the process has not loaded successfully.

Parameters:

operationName - the initiate operation name

req - the HTML request parameters

Throws:

ServerException - if there is a problem connecting to the process or parsing the request parameters.

readFormContentAsString

java.util.Map readFormContentAsString(java.lang.String partnerLinkName,
                                      java.lang.String roleName,
                                      java.lang.String operationName,
                                      Parameters req)
                                      throws ServerException

Parses the HTML request parameters according to the format expected for this process into a series of String objects.

This method will throw a ServerException if the process has not loaded successfully.

Parameters:

partnerLinkName - the name of the parterLink of the BPEL receive

roleName - the name of the role of the partnerLink of the BPEL receive

operationName - the initiate operation name of the BPEL receive

req - the HTML request parameters

Throws:

ServerException - if there is a problem connecting to the process or parsing the request parameters.

getOpenInstanceCount

int getOpenInstanceCount()
                         throws ServerException

Returns the number of open instances that belong to this BPEL process. An instance is considered open if it contains active activities.

Throws:

ServerException - if there is a problem connecting to the process or if there is problem querying the domain datasource.

getClosedInstanceCount

int getClosedInstanceCount()
                           throws ServerException

Returns the number of closed instances that belong to this BPEL process. An instance is considered closed once it is completed.

Throws:

ServerException - if there is a problem connecting to the process or if there is problem querying the domain datasource.

listInstances

IInstanceHandle[] listInstances()
                                throws ServerException

Returns a list of active instances associated with this BPEL process.

Throws:

ServerException - if there is a problem connecting to the process or if there is problem querying the domain datasource.

listInstances

IInstanceHandle[] listInstances(int listStart,
                                int listSize)
                                throws ServerException

Returns a list of active instances associated with this BPEL process. This method allows the user to specify how many instances to return from the result set; listStart specifies the starting point within the result set from the beginning (0 being the first index), and listSize being the number of instances to return starting from the starting index.

Parameters:

listStart - the starting point within the result set.

listSize - the total number of items to return.

Throws:

ServerException - if there is a problem connecting to the process or if there is problem querying the domain datasource.

getActivationAgentHandle

IActivationAgentHandle getActivationAgentHandle(java.lang.String className)
                                                throws ServerException

Returns a handle to the activation agent registered for this BPEL process. Activation agents specify an alternate method of invoking a BPEL process (other than the API or through SOAP).

This method will throw a ServerException if the process has not loaded successfully.

Parameters:

className - the class name of the activation agent as specified in the BPEL process descriptor.

Throws:

ServerException - if there is a problem connecting to the process or if the specified activation agent has not been registered with the process.

getSensorDefinitions

java.lang.String getSensorDefinitions()
                                      throws ServerException

Returns this process's sensor definitions. Sensors provide a flexible process monitoring framework.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process.

getSensorActionDefinitions

java.lang.String getSensorActionDefinitions()
                                            throws ServerException

Returns this process's sensor action definitions. Sensor actions are responsible for publishing data captured by sensors.

This method will throw a ServerException if the process has not loaded successfully.

Throws:

ServerException - if there is a problem connecting to the process.

startActivationAgent

void startActivationAgent(java.lang.String partnerLinkName)
                          throws ServerException

Throws:

ServerException

startAllActivationAgents

void startAllActivationAgents()
                              throws ServerException

Throws:

ServerException

stopActivationAgent

void stopActivationAgent(java.lang.String partnerLinkName)
                         throws ServerException

Throws:

ServerException

stopAllActivationAgents

void stopAllActivationAgents()
                             throws ServerException

Throws:

ServerException

Skip navigation links