oracle.jdeveloper.deploy

Interface Stateful

All Known Subinterfaces:

CompositeState, Runnable, StatefulDeployer, StatefulDescriptorPackager, StatefulDescriptorPackager, StatefulFileGroupPackager, StatefulFileGroupPackager, StatefulFileGroupsPackager, StatefulFileGroupsPackager, StatefulPackager<T>, StatefulProcessor<T>, StatefulProcessor<T>

All Known Implementing Classes:

AbstractJLibraryProcessor, AbstractOffsetPathProcessor, AbstractStatefulDeployer, ArchiveDeployer, ArchivePreviewer, BatchDeployer, BuildDeployer, DefaultCompositeState, DefaultState, DefaultStatefulProcessor, DeploymentModule, DynamicDeployer, ModulePackager, NullDeployer, oracle.jdevimpl.deploy.common.ProfileDeployer, StatefulDeployment

public interface Stateful

State of an object.

A Stateful object transitions through the following states: Uninitialized --> Initialized --> Valid --> Released.

After the object is created, the client is responsible for initializing it prior to using the object its intended purpose.

First-use of the object should transition it to a 'Valid' state. The exact operation that constitutes first-use is left for the object to define. Invoking the operation again in a Valid state should yield delta results, i.e. only changes between current and last invocation should be returned or processed.

The client can at any time invalidate an initialized object, this should generate an internal transition back to the 'Initialized' state. Invoking the operation should again put it back in a valid state, and operation should yield the same results as if it has been invoked the first time.

Client is responsible for releasing the state.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Stateful.State

Method Summary

Methods

Modifier and Type	Method and Description
void	initializeState() Transition from 'Uninitialized' to 'Initialized'.
void	invalidateState() Transition from 'Valid' to 'Initialized' state.
void	releaseState() Release state and any resources its holding.

Method Detail

initializeState

void initializeState()
                     throws StateException

Transition from 'Uninitialized' to 'Initialized'.

Throws:

StateException - if state could not be initialized.

invalidateState

void invalidateState()
                     throws StateException

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

Throws:

StateException - if called on a released or uninitialized object.

releaseState

void releaseState()
                  throws StateException

Release state and any resources its holding.

Throws:

StateException - if called on an uninitialized or released object.