ProgressObject (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.enterprise.deploy.spi.status Interface ProgressObject


public interface ProgressObject

The ProgressObject interface tracks and reports the progress of the deployment activities, distribute, start, stop, undeploy.

This class has an optional cancel method. The support of the cancel function can be tested by the isCancelSupported method.

The ProgressObject structure allows the user the option of polling for status or to provide a callback.


方法摘要
 void addProgressListener(ProgressListener pol)
          Add a listener to receive Progress events on deployment actions.
 void cancel()
          (optional) A cancel request on an in-process operation stops all further processing of the operation and returns the environment to it original state before the operation was executed.
 ClientConfiguration getClientConfiguration(TargetModuleID id)
          Return the ClientConfiguration object associated with the TargetModuleID.
 DeploymentStatus getDeploymentStatus()
          Retrieve the status of this activity.
 TargetModuleID[] getResultTargetModuleIDs()
          Retrieve the list of TargetModuleIDs successfully processed or created by the associated DeploymentManager operation.
 boolean isCancelSupported()
          Tests whether the vendor supports a cancel opertation for deployment activities.
 boolean isStopSupported()
          Tests whether the vendor supports a stop opertation for deployment activities.
 void removeProgressListener(ProgressListener pol)
          Remove a ProgressObject listener.
 void stop()
          (optional) A stop request on an in-process operation allows the operation on the current TargetModuleID to run to completion but does not process any of the remaining unprocessed TargetModuleID objects.
 

方法详细信息

getDeploymentStatus

DeploymentStatus getDeploymentStatus()
Retrieve the status of this activity.

返回:
An object containing the status information.

getResultTargetModuleIDs

TargetModuleID[] getResultTargetModuleIDs()
Retrieve the list of TargetModuleIDs successfully processed or created by the associated DeploymentManager operation.

返回:
a list of TargetModuleIDs.

getClientConfiguration

ClientConfiguration getClientConfiguration(TargetModuleID id)
Return the ClientConfiguration object associated with the TargetModuleID.

返回:
ClientConfiguration for a given TargetModuleID or null if none exists.

isCancelSupported

boolean isCancelSupported()
Tests whether the vendor supports a cancel opertation for deployment activities.

返回:
true if canceling an activity is supported by this platform.

cancel

void cancel()
            throws OperationUnsupportedException
(optional) A cancel request on an in-process operation stops all further processing of the operation and returns the environment to it original state before the operation was executed. An operation that has run to completion cannot be cancelled.

抛出异常:
OperationUnsupportedException - this optional command is not supported by this implementation.

isStopSupported

boolean isStopSupported()
Tests whether the vendor supports a stop opertation for deployment activities.

返回:
true if canceling an activity is supported by this platform.

stop

void stop()
          throws OperationUnsupportedException
(optional) A stop request on an in-process operation allows the operation on the current TargetModuleID to run to completion but does not process any of the remaining unprocessed TargetModuleID objects. The processed TargetModuleIDs must be returned by the method getResultTargetModuleIDs.

抛出异常:
OperationUnsupportedException - this optional command is not supported by this implementation.

addProgressListener

void addProgressListener(ProgressListener pol)
Add a listener to receive Progress events on deployment actions.

参数:
pol - the listener to receive events
另请参见:
ProgressEvent

removeProgressListener

void removeProgressListener(ProgressListener pol)
Remove a ProgressObject listener.

参数:
pol - the listener being removed
另请参见:
ProgressEvent

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.