org.jboss.msc.service
Class AbstractService<T>

java.lang.Object
  extended by org.jboss.msc.service.AbstractService<T>
Type Parameters:
T - the value type
All Implemented Interfaces:
Service<T>, Value<T>

public abstract class AbstractService<T>
extends Object
implements Service<T>

An abstract service class which provides default implementations.

Author:
David M. Lloyd

Field Summary
 
Fields inherited from interface org.jboss.msc.service.Service
NULL, NULL_VALUE
 
Constructor Summary
AbstractService()
           
 
Method Summary
 T getValue()
          Get the actual value.
 void start(StartContext context)
          Start the service.
 void stop(StopContext context)
          Stop the service.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

AbstractService

public AbstractService()
Method Detail

start

public void start(StartContext context)
           throws StartException
Start the service. Do not return until the service has been fully started, unless an asynchronous service start is performed. All injections will be complete before this method is called.

If the service start involves any activities that may block, the asynchronous mechanism provided by the context should be used. See the class javadoc for details. This implementation does nothing.

Specified by:
start in interface Service<T>
Parameters:
context - the context which can be used to trigger an asynchronous service start
Throws:
StartException - if the service could not be started for some reason

stop

public void stop(StopContext context)
Stop the service. Do not return until the service has been fully stopped, unless an asynchronous service stop is performed. All injections will remain intact until the service is fully stopped. This method should not throw an exception.

If the service start involves any activities that may block, the asynchronous mechanism provided by the context should be used. See the class javadoc for details. This implementation does nothing.

Specified by:
stop in interface Service<T>
Parameters:
context - the context which can be used to trigger an asynchronous service stop

getValue

public T getValue()
           throws IllegalStateException
Get the actual value. This implementation returns null.

Specified by:
getValue in interface Value<T>
Returns:
the actual value
Throws:
IllegalStateException - if the value is time-sensitive and the current state does not allow retrieval.


Copyright © 2011. All Rights Reserved.