org.jboss.msc.service

Interface StartContext

All Superinterfaces:

Executor, LifecycleContext

public interface StartContext
extends LifecycleContext

The start lifecycle context.

Author:

David M. Lloyd

Method Summary

Methods

Modifier and Type	Method and Description
void	failed(StartException reason) Call when an asynchronous start lifecycle action has failed for some reason.
ServiceTarget	getChildTarget() Get a service target which may be used to add child services.

Methods inherited from interface org.jboss.msc.service.LifecycleContext

asynchronous, complete, execute, getController, getElapsedTime

Method Detail

failed

void failed(StartException reason)
            throws IllegalStateException

Call when an asynchronous start lifecycle action has failed for some reason.

Parameters:

reason - the reason for the failure

Throws:

IllegalStateException - if called before LifecycleContext.asynchronous() is called, or if the action was already completed

getChildTarget

ServiceTarget getChildTarget()

Get a service target which may be used to add child services. Child services have an implicit dependency on their parent, and are automatically removed when the parent service stops (or if the parent service fails during startup).

Any listeners added directly to this service target will be added to child services when they are installed. Listeners added directly to this service target will be applied recursively to descendants as well, as long as the listener exists on this service target. To avoid this recursive behavior, apply listeners to any sub-target of this this target (see ServiceTarget.subTarget() for more information about sub-targets).

Note that any listeners existing on the starting service are not applied to child services automatically; they must be explicitly added to the child service target.

Returns:

the child target