Package org.jboss.msc.service

Interface ServiceController<S>

Type Parameters:

S - the service type

All Superinterfaces:

Value<S>

All Known Implementing Classes:

DelegatingServiceController

public interface ServiceController<S>
extends Value<S>

A controller for a single service instance.

Author:

David M. Lloyd, Richard Opalka

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	ServiceController.Mode	The controller mode for a service.
static class	ServiceController.State	A possible state for a service controller.

Method Summary

Modifier and Type	Method	Description
void	addListener(LifecycleListener listener)	Add a service lifecycle listener.
S	awaitValue()	Deprecated. this method will be removed in a future release
S	awaitValue(long time, TimeUnit unit)	Deprecated. this method will be removed in a future release
boolean	compareAndSetMode(ServiceController.Mode expected, ServiceController.Mode newMode)	Compare the current mode against expected; if it matches, change it to newMode.
ServiceName[]	getAliases()	Deprecated. Use ServiceController#provides() instead.
ServiceController.Mode	getMode()	Get the service controller's current mode.
ServiceName	getName()	Deprecated. Use ServiceController#provides() instead.
ServiceController<?>	getParent()	Get this service's parent service, or null if there is none.
Service<S>	getService()	Deprecated. this method will be removed in a future release
ServiceContainer	getServiceContainer()	Get the service container associated with this controller.
StartException	getStartException()	Get the reason why the last start failed.
ServiceController.State	getState()	Get the current service controller state.
Collection<ServiceName>	getUnavailableDependencies()	Deprecated. Use ServiceController#missing() instead.
S	getValue()	Deprecated. this method will be removed in a future release
Set<ServiceName>	missing()	Get the names of all missing values this service require.
Set<ServiceName>	provides()	Get the names of all values this service provide.
void	removeListener(LifecycleListener listener)	Remove a lifecycle listener.
Set<ServiceName>	requires()	Get the names of all values this service require.
void	retry()	Retry a failed service.
void	setMode(ServiceController.Mode mode)	Change the service controller's current mode.

Method Detail

getParent

ServiceController<?> getParent()

Get this service's parent service, or null if there is none.

Returns:

the parent service or null if this service has no parent

getServiceContainer

ServiceContainer getServiceContainer()

Get the service container associated with this controller.

Returns:

the container

getMode

ServiceController.Mode getMode()

Get the service controller's current mode.

Returns:

the controller mode

compareAndSetMode

boolean compareAndSetMode(ServiceController.Mode expected,
                          ServiceController.Mode newMode)

Compare the current mode against expected; if it matches, change it to newMode. The return value is true when the mode was matched and changed.

Parameters:

expected - the expected mode

newMode - the new mode

Returns:

true if the mode was changed

setMode

void setMode(ServiceController.Mode mode)

Change the service controller's current mode. Might result in the service starting or stopping. The mode may only be changed if it was not already set to ServiceController.Mode.REMOVE. Calling this method with the controller's current mode has no effect and is always allowed.

Parameters:

mode - the new controller mode

Throws:

IllegalStateException - if the mode given is null, or the caller attempted to change the service's mode from ServiceController.Mode.REMOVE to a different mode

getState

ServiceController.State getState()

Get the current service controller state.

Returns:

the current state

getValue

@Deprecated
S getValue()
    throws IllegalStateException

Deprecated.

this method will be removed in a future release

Get the service value.

Specified by:

getValue in interface Value<S>

Returns:

the service value

Throws:

IllegalStateException - if the service is not available (i.e. it is not up)

awaitValue

@Deprecated
S awaitValue()
      throws IllegalStateException,
             InterruptedException

Deprecated.

this method will be removed in a future release

Wait for a service to come up, and then return its value.

Returns:

the service value

Throws:

IllegalStateException - if the service is not available (i.e. it was removed or failed)

InterruptedException - if the wait operation was interrupted

awaitValue

@Deprecated
S awaitValue(long time,
             TimeUnit unit)
      throws IllegalStateException,
             InterruptedException,
             TimeoutException

Deprecated.

this method will be removed in a future release

Wait for a service to come up for a certain amount of time, and then return its value.

Parameters:

time - the amount of time to wait

unit - the unit of time to wait

Returns:

the service value

Throws:

IllegalStateException - if the service is not available (i.e. it was removed or failed)

InterruptedException - if the wait operation was interrupted

TimeoutException

getService

@Deprecated
Service<S> getService()
               throws IllegalStateException

Deprecated.

this method will be removed in a future release

Get the service.

Returns:

the service

Throws:

IllegalStateException - if the service is not available (i.e. it is not up)

getName

@Deprecated
ServiceName getName()

Deprecated.

Use ServiceController#provides() instead. This method will be removed in a future release.

Get the name of this service, if any.

Returns:

the name, or null if none was specified.

See Also:

provides()

getAliases

@Deprecated
ServiceName[] getAliases()

Deprecated.

Use ServiceController#provides() instead. This method will be removed in a future release.

Get other names this service is known as.

Returns:

the aliases

See Also:

provides()

requires

Set<ServiceName> requires()

Get the names of all values this service require.

Returns:

names of required values

provides

Set<ServiceName> provides()

Get the names of all values this service provide.

Returns:

names of provided values

missing

Set<ServiceName> missing()

Get the names of all missing values this service require.

Returns:

names of missing values

addListener

void addListener(LifecycleListener listener)

Add a service lifecycle listener.

Parameters:

listener - the lifecycle listener

removeListener

void removeListener(LifecycleListener listener)

Remove a lifecycle listener.

Parameters:

listener - the lifecycle listener to remove

getStartException

StartException getStartException()

Get the reason why the last start failed.

Returns:

the last start exception, or null if the last start succeeded or the service has not yet started

retry

void retry()

Retry a failed service. Does nothing if the state is not ServiceController.State.START_FAILED.

getUnavailableDependencies

@Deprecated
Collection<ServiceName> getUnavailableDependencies()

Deprecated.

Use ServiceController#missing() instead. This method will be removed in a future release.

Get the complete list of dependencies that are unavailable.

Returns:

a set containing the names of all unavailable dependencies