Class ServiceEvent

  • All Implemented Interfaces:
    Serializable

    public class ServiceEvent
    extends EventObject
    An event which indicates that a Service state has changed:
    • a service is starting
    • a service has started
    • a service is stopping
    • a service has stopped
    A ServiceEvent object is sent as an argument to the ServiceListener interface methods.
    Author:
    jh 2007.11.12
    See Also:
    Service, ServiceListener, Serialized Form
    • Field Detail

      • SERVICE_STARTING

        public static final int SERVICE_STARTING
        This event indicates that a service is starting.
        See Also:
        Constant Field Values
      • SERVICE_STARTED

        public static final int SERVICE_STARTED
        This event indicates that a service has started.
        See Also:
        Constant Field Values
      • SERVICE_STOPPING

        public static final int SERVICE_STOPPING
        This event indicates that a service is stopping.
        See Also:
        Constant Field Values
      • SERVICE_STOPPED

        public static final int SERVICE_STOPPED
        This event indicates that a service has stopped.
        See Also:
        Constant Field Values
    • Constructor Detail

      • ServiceEvent

        public ServiceEvent​(Service service,
                            int nId)
        Constructs a new ServiceEvent.
        Parameters:
        service - the Service that fired the event
        nId - this event's ID, one of the SERVICE_* enum values
    • Method Detail

      • getId

        public int getId()
        Return this event's ID.
        Returns:
        the event ID, one of the SERVICE_* enum values
      • getService

        public Service getService()
        Return the Service that fired the event.
        Returns:
        the Service
      • toString

        public String toString()
        Returns a String representation of this ServiceEvent object.
        Overrides:
        toString in class EventObject
        Returns:
        a String representation of this ServiceEvent object
      • dispatch

        public void dispatch​(Listeners listeners)
        Dispatch this event to the specified listeners collection.
        Parameters:
        listeners - the listeners collection
        Throws:
        ClassCastException - if any of the targets is not an instance of the ServiceListener interface
      • dispatch

        public void dispatch​(EventListener[] aListeners)
        Dispatch this event to the specified array of listeners.
        Parameters:
        aListeners - the array of listeners
        Throws:
        ClassCastException - if any of the targets is not an instance of ServiceListener interface