Class Service.Listener

  • Enclosing interface:
    Service

    public abstract static class Service.Listener
    extends java.lang.Object
    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)
    Author:
    Luke Sandberg
    • Method Detail

      • running

        public void running()
        Called when the service transitions from STARTING to RUNNING. This occurs when a service has successfully started.
      • terminated

        public void terminated​(Service.State from)
        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.
        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)
        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.
        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.