Package com.google.common.util.concurrent

Class ServiceManager.ServiceListener

java.lang.Object

com.google.common.util.concurrent.Service.Listener

com.google.common.util.concurrent.ServiceManager.ServiceListener

Enclosing class:

ServiceManager

private static final class ServiceManager.ServiceListener
extends Service.Listener

A Service that wraps another service and times how long it takes for it to start and also calls the ServiceManager.ServiceManagerState.transitionService(Service, State, State), to record the state transitions.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) Service	service
(package private) java.lang.ref.WeakReference<ServiceManager.ServiceManagerState>	state

Constructor Summary

Constructors

Constructor	Description
ServiceListener(Service service, java.lang.ref.WeakReference<ServiceManager.ServiceManagerState> state)

Method Summary

Modifier and Type	Method	Description
void	failed(Service.State from, java.lang.Throwable failure)	Called when the service transitions to the FAILED state.
void	running()	Called when the service transitions from STARTING to RUNNING.
void	starting()	Called when the service transitions from NEW to STARTING.
void	stopping(Service.State from)	Called when the service transitions to the STOPPING state.
void	terminated(Service.State from)	Called when the service transitions to the TERMINATED state.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

service

final Service service

state

final java.lang.ref.WeakReference<ServiceManager.ServiceManagerState> state

Constructor Detail

ServiceListener

ServiceListener(Service service,
                java.lang.ref.WeakReference<ServiceManager.ServiceManagerState> state)

Method Detail

starting

public void starting()

Description copied from class: Service.Listener

Called when the service transitions from NEW to STARTING. This occurs when Service.startAsync() is called the first time.

Overrides:

starting in class Service.Listener

running

public void running()

Description copied from class: Service.Listener

Called when the service transitions from STARTING to RUNNING. This occurs when a service has successfully started.

Overrides:

running in class Service.Listener

stopping

public void stopping(Service.State from)

Description copied from class: Service.Listener

Called when the service transitions to the STOPPING state. The only valid values for from are STARTING or RUNNING. This occurs when Service.stopAsync() is called.

Overrides:

stopping in class Service.Listener

Parameters:

from - The previous state that is being transitioned from.

terminated

public void terminated(Service.State from)

Description copied from class: Service.Listener

Called when the service transitions to the TERMINATED state. The TERMINATED state is a terminal state in the transition diagram. Therefore, if this method is called, no other methods will be called on the Service.Listener.

Overrides:

terminated in class Service.Listener

Parameters:

from - The previous state that is being transitioned from. Failure can occur in any state with the exception of FAILED and TERMINATED.

failed

public void failed(Service.State from,
                   java.lang.Throwable failure)

Description copied from class: Service.Listener

Called when the service transitions to the FAILED state. The FAILED state is a terminal state in the transition diagram. Therefore, if this method is called, no other methods will be called on the Service.Listener.

Overrides:

failed in class Service.Listener

Parameters:

from - The previous state that is being transitioned from. Failure can occur in any state with the exception of NEW or TERMINATED.

failure - The exception that caused the failure.