org.jboss.dna.repository.services
Class AbstractServiceAdministrator

java.lang.Object
  org.jboss.dna.repository.services.AbstractServiceAdministrator

All Implemented Interfaces:

ServiceAdministrator

@ThreadSafe
public abstract class AbstractServiceAdministrator
extends java.lang.Object
implements ServiceAdministrator

Simple abstract implementation of the service administrator interface that can be easily subclassed by services that require an administrative interface.

Author:

Randall Hauch

Nested Class Summary

Nested classes/interfaces inherited from interface org.jboss.dna.repository.services.ServiceAdministrator

ServiceAdministrator.State

Method Summary

ServiceAdministrator.State	getState() Return the current state of this service.
boolean	isPaused() Return whether this service is currently paused.
boolean	isShutdown() Return whether this service is stopped and unable to be restarted.
boolean	isStarted() Return whether this service has been started and is currently running.
ServiceAdministrator	pause() Temporarily stop monitoring and sequencing events.
ServiceAdministrator	setState(ServiceAdministrator.State state) Set the state of the service.
ServiceAdministrator	setState(java.lang.String state) Set the state of the service.
ServiceAdministrator	shutdown() Permanently stop monitoring and sequencing events.
ServiceAdministrator	start() Start monitoring and sequence the events.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jboss.dna.repository.services.ServiceAdministrator

awaitTermination

Method Detail

getState

public ServiceAdministrator.State getState()

Return the current state of this service.

Specified by:

getState in interface ServiceAdministrator

Returns:

the current state

setState

public ServiceAdministrator setState(ServiceAdministrator.State state)

Set the state of the service. This method does nothing if the desired state matches the current state.

Specified by:

setState in interface ServiceAdministrator

Parameters:

state - the desired state

Returns:

this object for method chaining purposes

See Also:

setState(String), start(), pause(), shutdown()

setState

public ServiceAdministrator setState(java.lang.String state)

Set the state of the service. This method does nothing if the desired state matches the current state.

Specified by:

setState in interface ServiceAdministrator

Parameters:

state - the desired state in string form

Returns:

this object for method chaining purposes

Throws:

java.lang.IllegalArgumentException - if the specified state string is null or does not match one of the predefined predefined enumerated values

See Also:

ServiceAdministrator.setState(State), start(), pause(), shutdown()

start

public ServiceAdministrator start()

Start monitoring and sequence the events. This method can be called multiple times, including after the service is paused. However, once the service is shutdown, it cannot be started or paused.

Specified by:

start in interface ServiceAdministrator

Returns:

this object for method chaining purposes

Throws:

java.lang.IllegalStateException - if called when the service has been shutdown.

See Also:

pause(), shutdown(), isStarted()

pause

public ServiceAdministrator pause()

Temporarily stop monitoring and sequencing events. This method can be called multiple times, including after the service is started. However, once the service is shutdown, it cannot be started or paused.

Specified by:

pause in interface ServiceAdministrator

Returns:

this object for method chaining purposes

Throws:

java.lang.IllegalStateException - if called when the service has been shutdown.

See Also:

start(), shutdown(), isPaused()

shutdown

public ServiceAdministrator shutdown()

Permanently stop monitoring and sequencing events. This method can be called multiple times, but only the first call has an effect. Once the service has been shutdown, it may not be restarted or paused.

Specified by:

shutdown in interface ServiceAdministrator

Returns:

this object for method chaining purposes

See Also:

start(), pause(), isShutdown()

isStarted

public boolean isStarted()

Return whether this service has been started and is currently running.

Specified by:

isStarted in interface ServiceAdministrator

Returns:

true if started and currently running, or false otherwise

See Also:

start(), pause(), isPaused(), isShutdown()

isPaused

public boolean isPaused()

Return whether this service is currently paused.

Specified by:

isPaused in interface ServiceAdministrator

Returns:

true if currently paused, or false otherwise

See Also:

pause(), start(), isStarted(), isShutdown()

isShutdown

public boolean isShutdown()

Return whether this service is stopped and unable to be restarted.

Specified by:

isShutdown in interface ServiceAdministrator

Returns:

true if currently shutdown, or false otherwise

See Also:

shutdown(), isPaused(), isStarted()