com.hazelcast.multimap.impl

Class MultiMapService

java.lang.Object

com.hazelcast.multimap.impl.MultiMapService

All Implemented Interfaces:

EventPublishingService<EventData,EntryListener>, ManagedService, MigrationAwareService, RemoteService, StatisticsAwareService, TransactionalService

public class MultiMapService
extends Object
implements ManagedService, RemoteService, MigrationAwareService, EventPublishingService<EventData,EntryListener>, TransactionalService, StatisticsAwareService

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERVICE_NAME

Constructor Summary

Constructors

Constructor and Description
MultiMapService(NodeEngine nodeEngine)

Method Summary

Modifier and Type	Method and Description
String	addListener(String name, EventListener listener, Data key, boolean includeValue, boolean local)
void	beforeMigration(PartitionMigrationEvent partitionMigrationEvent) Called before migration process starts, on both source and destination members.
void	commitMigration(PartitionMigrationEvent event) Commits the migration process for this service, on both source and destination members.
DistributedObject	createDistributedObject(String name) Creates a distributed object.
LocalMultiMapStats	createStats(String name)
<T extends TransactionalObject> T	createTransactionalObject(String name, Transaction transaction)
void	destroyDistributedObject(String name) Destroys a distributed object.
void	dispatchEvent(EventData event, EntryListener listener)
LocalMultiMapStatsImpl	getLocalMultiMapStatsImpl(String name)
NodeEngine	getNodeEngine()
MultiMapContainer	getOrCreateCollectionContainer(int partitionId, String name)
MultiMapPartitionContainer	getPartitionContainer(int partitionId)
SerializationService	getSerializationService()
Map<String,LocalMultiMapStats>	getStats()
void	init(NodeEngine nodeEngine, Properties properties) Initializes this ManagedService
void	insertMigratedData(int partitionId, Map<String,Map> map)
Set<Data>	localKeySet(String name)
Operation	prepareReplicationOperation(PartitionReplicationEvent event) Returns an operation to replicate service data and/or state for a specific partition replica on another cluster member.
void	publishEntryEvent(String multiMapName, EntryEventType eventType, Data key, Object newValue, Object oldValue)
void	publishMultiMapEvent(String mapName, EntryEventType eventType, int numberOfEntriesAffected)
boolean	removeListener(String name, String registrationId)
void	reset() reset this ManagedService back to initial state.
void	rollbackMigration(PartitionMigrationEvent event) Rollback the migration process for this service, on both source and destination members.
void	rollbackTransaction(String transactionId)
void	shutdown(boolean terminate) Shuts down this ManagedService.

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

See Also:

Constant Field Values

Constructor Detail

MultiMapService

public MultiMapService(NodeEngine nodeEngine)

Method Detail

init

public void init(NodeEngine nodeEngine,
                 Properties properties)

Description copied from interface: ManagedService

Initializes this ManagedService

Specified by:

init in interface ManagedService

Parameters:

nodeEngine - the NodeEngine that this ManagedService belongs to.

properties - the Properties. Can be used to pass settings to the service.

reset

public void reset()

Description copied from interface: ManagedService

reset this ManagedService back to 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 ManagedService. todo: what is the purpose of the terminate variable.

Specified by:

shutdown in interface ManagedService

Parameters:

terminate - true to shut down the ManagedService

getOrCreateCollectionContainer

public MultiMapContainer getOrCreateCollectionContainer(int partitionId,
                                                        String name)

getPartitionContainer

public MultiMapPartitionContainer getPartitionContainer(int partitionId)

createDistributedObject

public DistributedObject createDistributedObject(String name)

Description copied from interface: RemoteService

Creates a distributed object.

Specified by:

createDistributedObject in interface RemoteService

Parameters:

name - the name for the created distributed object

Returns:

the created distributed object

destroyDistributedObject

public void destroyDistributedObject(String name)

Description copied from interface: RemoteService

Destroys a distributed object.

Specified by:

destroyDistributedObject in interface RemoteService

Parameters:

name - the name of the distributed object to destroy

localKeySet

public Set<Data> localKeySet(String name)

getSerializationService

public SerializationService getSerializationService()

getNodeEngine

public NodeEngine getNodeEngine()

publishMultiMapEvent

public void publishMultiMapEvent(String mapName,
                                 EntryEventType eventType,
                                 int numberOfEntriesAffected)

publishEntryEvent

public final void publishEntryEvent(String multiMapName,
                                    EntryEventType eventType,
                                    Data key,
                                    Object newValue,
                                    Object oldValue)

addListener

public String addListener(String name,
                          EventListener listener,
                          Data key,
                          boolean includeValue,
                          boolean local)

removeListener

public boolean removeListener(String name,
                              String registrationId)

beforeMigration

public void beforeMigration(PartitionMigrationEvent partitionMigrationEvent)

Description copied from interface: MigrationAwareService

Called before migration process starts, on both source and destination members.

Service can take actions required before migration. Migration process will block until this method returns. If this method fails by throwing an exception, migration process for specific partition will fail and will be rolled back.

Specified by:

beforeMigration in interface MigrationAwareService

Parameters:

partitionMigrationEvent - migration event

prepareReplicationOperation

public Operation prepareReplicationOperation(PartitionReplicationEvent event)

Description copied from interface: MigrationAwareService

Returns an operation to replicate service data and/or state for a specific partition replica on another cluster member.

This method will be called on source member whenever partitioning system requires to copy/replicate a partition replica. Returned operation will be executed on destination member. If operation fails by throwing exception, migration process will fail and will be rolled back.

Returning null is allowed and means service does not have anything to replicate.

Specified by:

prepareReplicationOperation in interface MigrationAwareService

Parameters:

event - replication

Returns:

replication operation or null if nothing will be replicated

insertMigratedData

public void insertMigratedData(int partitionId,
                               Map<String,Map> map)

commitMigration

public void commitMigration(PartitionMigrationEvent event)

Description copied from interface: MigrationAwareService

Commits the migration process for this service, on both source and destination members. This method will be called after all replication operations are executed successfully on destination and master member receives success response from all participants.

Commit is not expected to fail at this point, all exceptions will be suppressed and logged.

Specified by:

commitMigration in interface MigrationAwareService

Parameters:

event - migration event

rollbackMigration

public void rollbackMigration(PartitionMigrationEvent event)

Description copied from interface: MigrationAwareService

Rollback the migration process for this service, on both source and destination members. This method will be called when migration process fails at any moment. Reasons for failure may be an exception thrown on any migration step or failure(s) of any of the migration participants; either master or source or destination.

Rollback is not expected to fail at this point, all exceptions will be suppressed and logged.

Specified by:

rollbackMigration in interface MigrationAwareService

Parameters:

event - migration event

createStats

public LocalMultiMapStats createStats(String name)

getLocalMultiMapStatsImpl

public LocalMultiMapStatsImpl getLocalMultiMapStatsImpl(String name)

createTransactionalObject

public <T extends TransactionalObject> T createTransactionalObject(String name,
                                                                   Transaction transaction)

Specified by:

createTransactionalObject in interface TransactionalService

rollbackTransaction

public void rollbackTransaction(String transactionId)

Specified by:

rollbackTransaction in interface TransactionalService

dispatchEvent

public void dispatchEvent(EventData event,
                          EntryListener listener)

Specified by:

dispatchEvent in interface EventPublishingService<EventData,EntryListener>

getStats

public Map<String,LocalMultiMapStats> getStats()

Specified by:

getStats in interface StatisticsAwareService