sk.stuba.fiit.perconik.core.services

Interface Service

All Superinterfaces:

Nameable, com.google.common.util.concurrent.Service

All Known Subinterfaces:

ListenerService, ResourceService

All Known Implementing Classes:

AbstractListenerService, AbstractResourceService

public interface Service
extends Nameable, com.google.common.util.concurrent.Service

An object with an operational state, plus asynchronous lifecycle methods to transition between states.

Uniqueness of a service is determined by its qualified name. Two Service instances with the same qualified name should be implemented by the same class, provide the same functionality and behave the same way.

Implementors of this interface are strongly encouraged to extend one of the abstract classes in this package which implement this interface and make the threading and state management easier.

Since:

1.0

Author:

Pavol Zbell

See Also:

Service

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.common.util.concurrent.Service

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

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o) Compares the specified object with this service for equality.
int	hashCode() Returns the hash code value for this service.

Methods inherited from interface sk.stuba.fiit.perconik.core.Nameable

getName

Methods inherited from interface com.google.common.util.concurrent.Service

addListener, awaitRunning, awaitRunning, awaitTerminated, awaitTerminated, failureCause, isRunning, startAsync, state, stopAsync

Method Detail

equals

boolean equals(@Nullable
               java.lang.Object o)

Compares the specified object with this service for equality. Returns true if the specified object is also service and the two services have the same name. This definition ensures that this method works properly across different implementations of the service interface.

Overrides:

equals in class java.lang.Object

Parameters:

o - an object to be compared for equality with this service

Returns:

true if the specified object is equal to this service, false otherwise

hashCode

int hashCode()

Returns the hash code value for this service. The hash code of a service should be equivalent to the hash code of the service's name.

Overrides:

hashCode in class java.lang.Object

Returns:

the hash code value for this service