org.jboss.msc.service
Interface ServiceTarget

All Known Subinterfaces:

BatchServiceTarget, ServiceContainer

All Known Implementing Classes:

DelegatingServiceContainer, DelegatingServiceTarget

public interface ServiceTarget

The target of ServiceBuilder installations. ServicesBuilders to be installed on a target should be retrieved by calling one of the addService methods (addService(ServiceName, Service), addServiceValue(ServiceName, Value). Notice that installation will only take place after ServiceBuilder.install() is invoked. ServiceBuilders that are not installed are ignored.

Author:

Flavia Rainone, Richard Opalka

Method Summary

ServiceTarget	addDependency(Collection<ServiceName> dependencies) Add a collection of dependencies that will be added to the all ServiceBuilders installed in this target
ServiceTarget	addDependency(ServiceName... dependencies) Add a list of dependencies that will be added to the all ServiceBuilders installed in this target.
ServiceTarget	addDependency(ServiceName dependency) Add a dependency that will be added to the all ServiceBuilders installed in this target.
ServiceTarget	addListener(Collection<ServiceListener<Object>> listeners) Add a collection of service listener that will be added to all ServiceBuilders installed in this target.
ServiceTarget	addListener(ServiceListener<Object>... listeners) Add a list of service listener that will be added to all ServiceBuilders installed in this target.
ServiceTarget	addListener(ServiceListener<Object> listener) Add a service listener that will be added to all the ServiceBuilders installed in this target.
ServiceTarget	addMonitor(StabilityMonitor monitor) Add a stability monitor that will be added to all the ServiceBuilders installed in this target.
ServiceTarget	addMonitors(StabilityMonitor... monitors) Add a stability monitors that will be added to all the ServiceBuilders installed in this target.
<T> ServiceBuilder<T>	addService(ServiceName name, Service<T> service) Get a builder which can be used to add a service to this target.
<T> ServiceBuilder<T>	addServiceValue(ServiceName name, Value<? extends Service<T>> value) Get a builder which can be used to add a service to this target.
BatchServiceTarget	batchTarget() Create a new batch service target, which is used to install described services in this target.
Set<ServiceName>	getDependencies() Returns a set of all dependencies added to this target.
Set<ServiceListener<Object>>	getListeners() Returns a set of the listeners added to this target.
Set<StabilityMonitor>	getMonitors() Returns a set of the monitors added to this target.
ServiceTarget	removeDependency(ServiceName dependency) Remove a dependency from this target.
ServiceTarget	removeListener(ServiceListener<Object> listener) Remove a listener from this target, if it exists.
ServiceTarget	removeMonitor(StabilityMonitor monitor) Remove a monitor from this target, if it exists.
ServiceTarget	subTarget() Create a sub-target using this as the parent target.

Method Detail

addServiceValue

<T> ServiceBuilder<T> addServiceValue(ServiceName name,
                                      Value<? extends Service<T>> value)

Get a builder which can be used to add a service to this target.

Parameters:

name - the service name

value - the service value

Returns:

the builder for the service

addService

<T> ServiceBuilder<T> addService(ServiceName name,
                                 Service<T> service)

Get a builder which can be used to add a service to this target.

Parameters:

name - the service name

service - the service

Returns:

the builder for the service

addMonitor

ServiceTarget addMonitor(StabilityMonitor monitor)

Add a stability monitor that will be added to all the ServiceBuilders installed in this target.

Parameters:

monitor - the monitor to add to the target

Returns:

this target

addMonitors

ServiceTarget addMonitors(StabilityMonitor... monitors)

Add a stability monitors that will be added to all the ServiceBuilders installed in this target.

Parameters:

monitors - the monitors to add to the target

Returns:

this target

addListener

ServiceTarget addListener(ServiceListener<Object> listener)

Add a service listener that will be added to all the ServiceBuilders installed in this target.

Parameters:

listener - the listener to add to the target

Returns:

this target

addListener

ServiceTarget addListener(ServiceListener<Object>... listeners)

Add a list of service listener that will be added to all ServiceBuilders installed in this target.

Parameters:

listeners - a list of listeners to add to the target

Returns:

this target

addListener

ServiceTarget addListener(Collection<ServiceListener<Object>> listeners)

Add a collection of service listener that will be added to all ServiceBuilders installed in this target.

Parameters:

listeners - a collection of listeners to add to the target

Returns:

this target

removeMonitor

ServiceTarget removeMonitor(StabilityMonitor monitor)

Remove a monitor from this target, if it exists.

Parameters:

monitor - the monitor to remove

Returns:

this target

removeListener

ServiceTarget removeListener(ServiceListener<Object> listener)

Remove a listener from this target, if it exists.

Parameters:

listener - the listener to remove

Returns:

this target

getMonitors

Set<StabilityMonitor> getMonitors()

Returns a set of the monitors added to this target.

Returns:

the monitors added to this target

getListeners

Set<ServiceListener<Object>> getListeners()

Returns a set of the listeners added to this target.

Returns:

the listeners added to this target

addDependency

ServiceTarget addDependency(ServiceName dependency)

Add a dependency that will be added to the all ServiceBuilders installed in this target.

Parameters:

dependency - the dependency to add to the target

Returns:

this target

addDependency

ServiceTarget addDependency(ServiceName... dependencies)

Add a list of dependencies that will be added to the all ServiceBuilders installed in this target.

Parameters:

dependencies - a list of dependencies to add to the target

Returns:

this target

addDependency

ServiceTarget addDependency(Collection<ServiceName> dependencies)

Add a collection of dependencies that will be added to the all ServiceBuilders installed in this target

Parameters:

dependencies - a collection of dependencies to add to this target

Returns:

this target

removeDependency

ServiceTarget removeDependency(ServiceName dependency)

Remove a dependency from this target. Subsequently defined services will not have this dependency.

Parameters:

dependency - the dependency

Returns:

this target

getDependencies

Set<ServiceName> getDependencies()

Returns a set of all dependencies added to this target.

Returns:

all dependencies of this target

subTarget

ServiceTarget subTarget()

Create a sub-target using this as the parent target.

Returns:

the new service target

batchTarget

BatchServiceTarget batchTarget()

Create a new batch service target, which is used to install described services in this target.

Returns:

the new batch service target