oracle.jdeveloper.deploy.common

Class AbstractStatefulDeployer

java.lang.Object

oracle.jdeveloper.deploy.common.AbstractDeployer

oracle.jdeveloper.deploy.common.AbstractStatefulDeployer

All Implemented Interfaces:

Deployer, ProgressListener, Stateful, StatefulDeployer

Direct Known Subclasses:

BatchDeployer, BuildDeployer, ModulePackager, oracle.jdevimpl.deploy.common.ProfileDeployer

public abstract class AbstractStatefulDeployer
extends AbstractDeployer
implements StatefulDeployer

A stateful deployer can persist for more than one deployment cycle. The first time its invoked, its expected to behave like a stateless deployer, the second and subsequent times, it should only perform incremental actions, since the previous invocation.

Any changes in the state of its own objects should be propagated to any state change listeners by calling one of the fireStateXXXX() methods.

Nested Class Summary

Nested classes/interfaces inherited from interface oracle.jdeveloper.deploy.Stateful

Stateful.State

Constructor Summary

Constructors

Constructor and Description
AbstractStatefulDeployer(int sequence)

Method Summary

Modifier and Type	Method and Description
protected void	addStateChangeListeners() Called when the first state change listener is registered into this Deployer.
StatefulDeployer.Handle	attachDisabledStateChangeListener(java.lang.Object listener)
StatefulDeployer.Handle	attachStateChangeListener(java.lang.Object listener) Attaches a listener for events from the DeployerStateChange category.
void	deploy(int deploySequenceId, DeployShell shell) Do the actual deployment task.
void	finish(int deploySequenceId, DeployShell shell) Called after the entire Deployment process has completed, perform any cleanup operations here.
protected void	fireStateChanged()
protected void	fireStateInvalidated()
protected void	fireStateReleased()
void	initializeState() Transition from 'Uninitialized' to 'Initialized'.
void	invalidateState() Transition from 'Valid' to 'Initialized' state.
void	prepare(int deploySequenceId, DeployShell shell) Called to do any preparatory work before the actual deployment takes place.
void	releaseState() Release state and any resources its holding.
protected void	removeStateChangeListeners() Called when the last state change listener is unregistered into this Deployer.
protected java.lang.Object	stateLockObject()

Methods inherited from class oracle.jdeveloper.deploy.common.AbstractDeployer

cancel, cancelImpl, canDeploy, deployImpl, finishImpl, getName, getSequenceId, handleEvent, isDeploymentCancelled, prepareImpl, throwExceptionIfCancelEventReceived, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface oracle.jdeveloper.deploy.Deployer

cancel, canDeploy

Constructor Detail

AbstractStatefulDeployer

public AbstractStatefulDeployer(int sequence)

Method Detail

prepare

public void prepare(int deploySequenceId,
                    DeployShell shell)
             throws DeployException

Description copied from interface: Deployer

Called to do any preparatory work before the actual deployment takes place. No irreversible changes should be made in this method.

Specified by:

prepare in interface Deployer

Overrides:

prepare in class AbstractDeployer

Throws:

DeployException

finish

public void finish(int deploySequenceId,
                   DeployShell shell)

Description copied from interface: Deployer

Called after the entire Deployment process has completed, perform any cleanup operations here. This method should not throw a DeployException.

Specified by:

finish in interface Deployer

Overrides:

finish in class AbstractDeployer

attachStateChangeListener

public StatefulDeployer.Handle attachStateChangeListener(java.lang.Object listener)

Description copied from interface: StatefulDeployer

Attaches a listener for events from the DeployerStateChange category.

Specified by:

attachStateChangeListener in interface StatefulDeployer

Returns:

deploy

public void deploy(int deploySequenceId,
                   DeployShell shell)
            throws DeployException

Description copied from interface: Deployer

Do the actual deployment task.

Specified by:

deploy in interface Deployer

Overrides:

deploy in class AbstractDeployer

Throws:

DeployException

attachDisabledStateChangeListener

public StatefulDeployer.Handle attachDisabledStateChangeListener(java.lang.Object listener)

Specified by:

attachDisabledStateChangeListener in interface StatefulDeployer

stateLockObject

protected java.lang.Object stateLockObject()

initializeState

public void initializeState()

Description copied from interface: Stateful

Transition from 'Uninitialized' to 'Initialized'.

Specified by:

initializeState in interface Stateful

invalidateState

public void invalidateState()

Description copied from interface: Stateful

Transition from 'Valid' to 'Initialized' state. When 'operation' is performed, the state transition to valid again.

Specified by:

invalidateState in interface Stateful

releaseState

public void releaseState()

Description copied from interface: Stateful

Release state and any resources its holding.

Specified by:

releaseState in interface Stateful

fireStateChanged

protected void fireStateChanged()

fireStateInvalidated

protected void fireStateInvalidated()

fireStateReleased

protected void fireStateReleased()

addStateChangeListeners

protected void addStateChangeListeners()

Called when the first state change listener is registered into this Deployer. This is an opportunity for this deployer to add listeners of its own to other stateful objects it owns.

removeStateChangeListeners

protected void removeStateChangeListeners()

Called when the last state change listener is unregistered into this Deployer. This is an opportunity for this deployer to remove isteners of its own from other stateful objects it owns.