Package com.tangosol.net
Interface Service
- All Superinterfaces:
ClassLoaderAware
,Controllable
,Service
- All Known Subinterfaces:
CacheService
,DistributedCacheService
,InvocationService
,NameService
,PagedTopicService
,PartitionedService
,ProxyService
,TopicService
- All Known Implementing Classes:
WrapperCacheService
,WrapperInvocationService
,WrapperService
This Service interface represents a controllable service that operates in a
clustered network environment.
- Since:
- Coherence 1.1
- Author:
- gg 2002.02.08
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic interface
MemberJoinAction is taken to allow a new member to join a clustered Service. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addMemberListener
(MemberListener listener) Add a Member listener.Return the Cluster object that this Service is a part of.Return the service's dependencies.getInfo()
Return the ServiceInfo object for this Service.Retrieves a Service scopedResourceRegistry
.Return a Serializer used by this Service.Return the user context object associated with this Service.boolean
Returnstrue
if this service is currently suspended.void
removeMemberListener
(MemberListener listener) Remove a Member listener.void
Configure the Service.void
setUserContext
(Object oCtx) Associate a user context object with this Service.Methods inherited from interface com.tangosol.io.ClassLoaderAware
getContextClassLoader, setContextClassLoader
Methods inherited from interface com.tangosol.util.Controllable
configure, isRunning, shutdown, start, stop
Methods inherited from interface com.tangosol.util.Service
addServiceListener, removeServiceListener
-
Method Details
-
getCluster
Cluster getCluster()Return the Cluster object that this Service is a part of.- Returns:
- the Cluster object
-
getInfo
ServiceInfo getInfo()Return the ServiceInfo object for this Service.- Returns:
- the ServiceInfo object
-
addMemberListener
Add a Member listener.MemberListeners will be invoked in the order in which they are registered.
- Parameters:
listener
- theMemberListener
to add
-
removeMemberListener
Remove a Member listener.- Parameters:
listener
- theMemberListener
to remove
-
getUserContext
Object getUserContext()Return the user context object associated with this Service.The data type and semantics of this context object are entirely application specific and are opaque to the Service itself.
- Returns:
- an associated user context object or null if a context has not been set
- Since:
- Coherence 3.0
-
setUserContext
Associate a user context object with this Service.- Parameters:
oCtx
- a user context object- Since:
- Coherence 3.0
-
getSerializer
Serializer getSerializer()Return a Serializer used by this Service.- Returns:
- the Serializer object
- Since:
- Coherence 3.4
-
setDependencies
Configure the Service.This method can only be called before the Service is started.
- Parameters:
deps
- the dependencies object carrying configuration information specific to this Service- Throws:
IllegalStateException
- thrown if the Service is already runningIllegalArgumentException
- thrown if the configuration information is invalid- Since:
- Coherence 12.1.3
-
getDependencies
ServiceDependencies getDependencies()Return the service's dependencies.- Returns:
- the service's dependencies
- Since:
- Coherence 12.2.1
-
getResourceRegistry
ResourceRegistry getResourceRegistry()Retrieves a Service scopedResourceRegistry
. The resource registry is used to:- Register resources with the Service and make them accessible to the application code bound to this Service.
- Dispose of resources when the Service is shut down; see
the
ResourceRegistry
API for details on how to enable cleanup of resources.
- Returns:
- a Service scoped resource registry
- Since:
- Coherence 12.2.1
-
isSuspended
boolean isSuspended()Returnstrue
if this service is currently suspended.- Returns:
true
if this service is currently suspended- Since:
- 22.06
- See Also:
-