com.hazelcast.client.impl

Class ClientEngineImpl

java.lang.Object

com.hazelcast.client.impl.ClientEngineImpl

All Implemented Interfaces:

ClientEngine, ClientMessageHandler, CoreService, EventPublishingService<ClientEvent,ClientListener>, ManagedService, MembershipAwareService, PreJoinAwareService

public class ClientEngineImpl
extends Object
implements ClientEngine, CoreService, PreJoinAwareService, ManagedService, MembershipAwareService, EventPublishingService<ClientEvent,ClientListener>

Class that requests, listeners from client handled in node side.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERVICE_NAME Service name to be used in requests.

Constructor Summary

Constructors

Constructor and Description
ClientEngineImpl(Node node)

Method Summary

Modifier and Type	Method and Description
String	addOwnershipMapping(String clientUuid, String ownerUuid)
void	bind(ClientEndpoint endpoint)
void	dispatchEvent(ClientEvent event, ClientListener listener) Notifies the service of a published event.
int	getClientEndpointCount()
ClientExceptionFactory	getClientExceptionFactory()
ExecutorService	getClientManagementExecutor()
Collection<Client>	getClients()
Map<String,String>	getClientStatistics() The statistics is a String that is composed of key=value pairs separated by ',' .
ClusterService	getClusterService()
Config	getConfig()
Map<ClientType,Integer>	getConnectedClientStats() Returns Map which contains number of connected clients to the cluster.
ConnectionListener	getConnectionListener()
ClientEndpointManager	getEndpointManager()
EventService	getEventService()
MemberImpl	getLocalMember()
ILogger	getLogger(Class clazz)
Address	getMasterAddress()
String	getOwnerUuid(String clientUuid)
ClientPartitionListenerService	getPartitionListenerService()
IPartitionService	getPartitionService()
Operation	getPreJoinOperation() An operation to be executed on the joining member before it is set as joined.
ProxyService	getProxyService()
SecurityContext	getSecurityContext()
SerializationService	getSerializationService() Returns the SerializationService.
Address	getThisAddress()
String	getThisUuid()
TransactionManagerService	getTransactionManagerService()
void	handle(ClientMessage clientMessage, Connection connection) Received message to be processed
void	init(NodeEngine nodeEngine, Properties properties) Initializes this service.
void	memberAdded(MembershipServiceEvent event) Invoked when a new member is added to the cluster.
void	memberAttributeChanged(MemberAttributeServiceEvent event) Invoked when a member attribute is changed.
void	memberRemoved(MembershipServiceEvent event) Invoked when an existing member leaves the cluster.
boolean	removeOwnershipMapping(String clientUuid, String memberUuid)
void	reset() Resets this service back to its initial state.
void	shutdown(boolean terminate) Shuts down this service.
boolean	trySetLastAuthenticationCorrelationId(String clientUuid, long newCorrelationId)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SERVICE_NAME

public static final String SERVICE_NAME

Service name to be used in requests.

See Also:

Constant Field Values

Constructor Detail

ClientEngineImpl

public ClientEngineImpl(Node node)

Method Detail

getClientManagementExecutor

public ExecutorService getClientManagementExecutor()

getConnectionListener

public ConnectionListener getConnectionListener()

getSerializationService

public SerializationService getSerializationService()

Description copied from interface: ClientEngine

Returns the SerializationService.

Specified by:

getSerializationService in interface ClientEngine

Returns:

the SerializationService

getClientEndpointCount

public int getClientEndpointCount()

Specified by:

getClientEndpointCount in interface ClientEngine

handle

public void handle(ClientMessage clientMessage,
                   Connection connection)

Description copied from interface: ClientMessageHandler

Received message to be processed

Specified by:

handle in interface ClientMessageHandler

Parameters:

clientMessage - the ClientMessage the process

connection - the connection responsible for creating the message

getPartitionService

public IPartitionService getPartitionService()

Specified by:

getPartitionService in interface ClientEngine

getClusterService

public ClusterService getClusterService()

Specified by:

getClusterService in interface ClientEngine

getEventService

public EventService getEventService()

Specified by:

getEventService in interface ClientEngine

getProxyService

public ProxyService getProxyService()

Specified by:

getProxyService in interface ClientEngine

getMasterAddress

public Address getMasterAddress()

Specified by:

getMasterAddress in interface ClientEngine

getThisAddress

public Address getThisAddress()

Specified by:

getThisAddress in interface ClientEngine

getThisUuid

public String getThisUuid()

Specified by:

getThisUuid in interface ClientEngine

getLocalMember

public MemberImpl getLocalMember()

Specified by:

getLocalMember in interface ClientEngine

getConfig

public Config getConfig()

Specified by:

getConfig in interface ClientEngine

getLogger

public ILogger getLogger(Class clazz)

Specified by:

getLogger in interface ClientEngine

getEndpointManager

public ClientEndpointManager getEndpointManager()

getClientExceptionFactory

public ClientExceptionFactory getClientExceptionFactory()

getSecurityContext

public SecurityContext getSecurityContext()

Specified by:

getSecurityContext in interface ClientEngine

bind

public void bind(ClientEndpoint endpoint)

dispatchEvent

public void dispatchEvent(ClientEvent event,
                          ClientListener listener)

Description copied from interface: EventPublishingService

Notifies the service of a published event.

Specified by:

dispatchEvent in interface EventPublishingService<ClientEvent,ClientListener>

Parameters:

event - the published event

listener - the listener registered for this event

memberAdded

public void memberAdded(MembershipServiceEvent event)

Description copied from interface: MembershipAwareService

Invoked when a new member is added to the cluster. Should be non-blocking.

Specified by:

memberAdded in interface MembershipAwareService

Parameters:

event - the event for a new member added to the cluster

memberRemoved

public void memberRemoved(MembershipServiceEvent event)

Description copied from interface: MembershipAwareService

Invoked when an existing member leaves the cluster. Should be non-blocking.

Specified by:

memberRemoved in interface MembershipAwareService

Parameters:

event - the event for an existing member leaving the cluster

memberAttributeChanged

public void memberAttributeChanged(MemberAttributeServiceEvent event)

Description copied from interface: MembershipAwareService

Invoked when a member attribute is changed.

Specified by:

memberAttributeChanged in interface MembershipAwareService

Parameters:

event - the event for a member attribute being changed

getClients

public Collection<Client> getClients()

init

public void init(NodeEngine nodeEngine,
                 Properties properties)

Description copied from interface: ManagedService

Initializes this service.

Specified by:

init in interface ManagedService

Parameters:

nodeEngine - the NodeEngine that this service belongs to

properties - the Properties (can be used to pass settings to the service)

reset

public void reset()

Description copied from interface: ManagedService

Resets this service back to its initial state.

TODO: what is the purpose of reset

Specified by:

reset in interface ManagedService

shutdown

public void shutdown(boolean terminate)

Description copied from interface: ManagedService

Shuts down this service.

TODO: what is the purpose of the terminate variable

Specified by:

shutdown in interface ManagedService

Parameters:

terminate - true to shut down this service

trySetLastAuthenticationCorrelationId

public boolean trySetLastAuthenticationCorrelationId(String clientUuid,
                                                     long newCorrelationId)

addOwnershipMapping

public String addOwnershipMapping(String clientUuid,
                                  String ownerUuid)

removeOwnershipMapping

public boolean removeOwnershipMapping(String clientUuid,
                                      String memberUuid)

getOwnerUuid

public String getOwnerUuid(String clientUuid)

Specified by:

getOwnerUuid in interface ClientEngine

getTransactionManagerService

public TransactionManagerService getTransactionManagerService()

getPartitionListenerService

public ClientPartitionListenerService getPartitionListenerService()

getPreJoinOperation

public Operation getPreJoinOperation()

Description copied from interface: PreJoinAwareService

An operation to be executed on the joining member before it is set as joined. As is the case with PostJoinAwareService.getPostJoinOperation()s, no partition locks, no key-based locks, no service level locks, no database interaction are allowed. Additionally, a pre-join operation is executed while the cluster lock is being held on the joining member, so it is important that the operation finishes quickly and does not interact with other locks. The Operation.getPartitionId() method should return a negative value. This means that the operations should not implement PartitionAwareOperation.

Pre join operations should return response, which may also be a null response.

Specified by:

getPreJoinOperation in interface PreJoinAwareService

Returns:

an operation to be executed on joining member before it is set as joined. Can be null.

getConnectedClientStats

public Map<ClientType,Integer> getConnectedClientStats()

Description copied from interface: ClientEngine

Returns Map which contains number of connected clients to the cluster. The returned map can be used to get information about connected clients to the cluster.

Specified by:

getConnectedClientStats in interface ClientEngine

Returns:

Map .

getClientStatistics

public Map<String,String> getClientStatistics()

Description copied from interface: ClientEngine

The statistics is a String that is composed of key=value pairs separated by ',' . The following characters are escaped in IMap and ICache names by the escape character '\' : '=' '.' ',' '\' The statistics key identify the category and name of the statistics. It is formatted as: mainCategory.subCategory.statisticName An e.g. Operating system committedVirtualMemorySize path would be: os.committedVirtualMemorySize The statistics key names can be one of the following (Used IMap named and ICache Named and assuming that the Near Cache is configured): clientType clusterConnectionTimestamp credentials.principal clientAddress clientName enterprise lastStatisticsCollectionTime nearcache..creationTime nearcache..evictions nearcache..expirations nearcache..hits nearcache..lastPersistenceDuration nearcache..lastPersistenceFailure nearcache..lastPersistenceKeyCount nearcache..lastPersistenceTime nearcache..lastPersistenceWrittenBytes nearcache..misses nearcache..ownedEntryCount nearcache..ownedEntryMemoryCost nearcache.hz/.creationTime nearcache.hz/.evictions nearcache.hz/.expirations nearcache.hz/.hits nearcache.hz/.lastPersistenceDuration nearcache.hz/.lastPersistenceFailure nearcache.hz/.lastPersistenceKeyCount nearcache.hz/.lastPersistenceTime nearcache.hz/.lastPersistenceWrittenBytes nearcache.hz/.misses nearcache.hz/.ownedEntryCount nearcache.hz/.ownedEntryMemoryCost os.committedVirtualMemorySize os.freePhysicalMemorySize os.freeSwapSpaceSize os.maxFileDescriptorCount os.openFileDescriptorCount os.processCpuTime os.systemLoadAverage os.totalPhysicalMemorySize os.totalSwapSpaceSize runtime.availableProcessors runtime.freeMemory runtime.maxMemory runtime.totalMemory runtime.uptime runtime.usedMemory userExecutor.queueSize Not: Please observe that the name for the ICache appears to be the hazelcast instance name "hz" followed by "/" and followed by the cache name provided which is StatTestCacheName.

Specified by:

getClientStatistics in interface ClientEngine

Returns:

Map of [client UUID String, client statistics String]