Class Service.Listener
java.lang.Object
com.google.common.util.concurrent.Service.Listener
- Direct Known Subclasses:
ServiceManager.ServiceListener
- Enclosing interface:
Service
A listener for the various state changes that a
Service goes through in its lifecycle.
All methods are no-ops by default, implementors should override the ones they care about.
- Since:
- 15.0 (present as an interface in 13.0)
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidfailed(Service.State from, Throwable failure) Called when the service transitions to the FAILED state.voidrunning()voidstarting()voidstopping(Service.State from) Called when the service transitions to the STOPPING state.voidterminated(Service.State from) Called when the service transitions to the TERMINATED state.
-
Constructor Details
-
Listener
public Listener()
-
-
Method Details
-
starting
public void starting()Called when the service transitions from NEW to STARTING. This occurs whenService.startAsync()is called the first time. -
running
public void running() -
stopping
Called when the service transitions to the STOPPING state. The only valid values forfromare STARTING or RUNNING. This occurs whenService.stopAsync()is called.- Parameters:
from- The previous state that is being transitioned from.
-
terminated
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 theService.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
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 theService.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.
-