JBoss Modular Service Kernel API 1.0.0.Beta1

org.jboss.msc.service
Interface ServiceListener<S>

All Known Implementing Classes:
AbstractServiceListener, RemovingServiceListener, TimingServiceListener

public interface ServiceListener<S>

A listener for service lifecycle events. The associated controller will not leave its current state until all listeners finish running.

Author:
David M. Lloyd

Method Summary
 void listenerAdded(ServiceController<? extends S> controller)
          The listener has been added to a controller.
 void serviceFailed(ServiceController<? extends S> controller, StartException reason)
          The service start has failed.
 void serviceRemoved(ServiceController<? extends S> controller)
          The service has been removed.
 void serviceStarted(ServiceController<? extends S> controller)
          The service is started (up).
 void serviceStarting(ServiceController<? extends S> controller)
          The service is starting.
 void serviceStopped(ServiceController<? extends S> controller)
          The service is stopped (down).
 void serviceStopping(ServiceController<? extends S> controller)
          The service is stopping.
 

Method Detail

listenerAdded

void listenerAdded(ServiceController<? extends S> controller)
The listener has been added to a controller.

Parameters:
controller - the controller that this listener was added to

serviceStarting

void serviceStarting(ServiceController<? extends S> controller)
The service is starting. Called after the state transitions from DOWN to STARTING.

Parameters:
controller - the controller

serviceStarted

void serviceStarted(ServiceController<? extends S> controller)
The service is started (up). Called after the state transitions from STARTING to UP.

Parameters:
controller - the controller

serviceFailed

void serviceFailed(ServiceController<? extends S> controller,
                   StartException reason)
The service start has failed. Called after the state transitions from STARTING to START_FAILED.

Parameters:
controller - the controller
reason - the reason for failure

serviceStopping

void serviceStopping(ServiceController<? extends S> controller)
The service is stopping. Called after the state transitions from UP to STOPPING.

Parameters:
controller - the controller

serviceStopped

void serviceStopped(ServiceController<? extends S> controller)
The service is stopped (down). Called after the state transitions from STOPPING to DOWN.

Parameters:
controller - the controller

serviceRemoved

void serviceRemoved(ServiceController<? extends S> controller)
The service has been removed. The listener will automatically be unregistered after this call. Called after the state transitions from DOWN to REMOVED.

Parameters:
controller - the controller

JBoss Modular Service Kernel API 1.0.0.Beta1

Copyright © 2010 JBoss, a division of Red Hat, Inc.