Show / Hide Table of Contents

Interface IService

This IService interface represents a controllable service that operates in a clustered network environment.

Inherited Members
IService.ServiceStarting
IService.ServiceStarted
IService.ServiceStopping
IService.ServiceStopped
IControllable.Configure(IXmlElement)
IControllable.Start()
IControllable.IsRunning
IControllable.Shutdown()
IControllable.Stop()
Namespace: Tangosol.Net
Assembly: Coherence.dll
Syntax
public interface IService : IService, IControllable

Properties

Info

Gets the IServiceInfo object for this IService.

Declaration
IServiceInfo Info { get; }
Property Value
Type Description
IServiceInfo

The IServiceInfo object.

Serializer

The ISerializer used to serialize and deserialize objects by this IService.

Declaration
ISerializer Serializer { get; }
Property Value
Type Description
ISerializer

The ISerializer for this IService.

UserContext

Gets or sets the user context object associated with this IService.

Declaration
object UserContext { get; set; }
Property Value
Type Description
object

User context object associated with this IService.

Remarks

The data type and semantics of this context object are entirely application specific and are opaque to the IService itself.

Events

MemberJoined

Invoked when an IMember has joined the service.

Declaration
event MemberEventHandler MemberJoined
Event Type
Type Description
MemberEventHandler
Remarks

Note: this event could be called during the service restart on in which case the event handler should not attempt to use any cache or service functionality.

The most critical situation arises when a number of threads are waiting for a local service restart, being blocked by a IService object synchronization monitor. Since the Joined event should be fired only once, it is called on a client thread while holding a synchronization monitor. An attempt to use other service functionality during this local event notification may result in a deadlock.

MemberLeaving

Invoked when an IMember is leaving the service.

Declaration
event MemberEventHandler MemberLeaving
Event Type
Type Description
MemberEventHandler

MemberLeft

Invoked when an IMember has left the service.

Declaration
event MemberEventHandler MemberLeft
Event Type
Type Description
MemberEventHandler
Remarks

Note: this event could be called during the service restart in which case the event handler should not attempt to use any cache or service functionality.

In this article
Back to top Copyright © 2000, 2024, Oracle and/or its affiliates.