public class MultiMapService extends Object implements ManagedService, RemoteService, FragmentedMigrationAwareService, EventPublishingService<EventData,EntryListener>, TransactionalService, StatisticsAwareService<LocalMultiMapStats>, QuorumAwareService, SplitBrainHandlerService
Modifier and Type | Field and Description |
---|---|
static String |
SERVICE_NAME |
Constructor and Description |
---|
MultiMapService(NodeEngine nodeEngine) |
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> |
createTransactionalObject(String name,
Transaction transaction) |
void |
destroyDistributedObject(String name)
Destroys a distributed object.
|
void |
dispatchEvent(EventData event,
EntryListener listener)
Notifies the service of a published event.
|
void |
ensureQuorumPresent(String distributedObjectName,
QuorumType requiredQuorumPermissionType) |
Collection<ServiceNamespace> |
getAllServiceNamespaces(PartitionReplicationEvent event)
Returns all known namespaces for given replication event.
|
LocalMultiMapStatsImpl |
getLocalMultiMapStatsImpl(String name) |
NodeEngine |
getNodeEngine() |
MultiMapContainer |
getOrCreateCollectionContainer(int partitionId,
String name) |
MultiMapContainer |
getOrCreateCollectionContainerWithoutAccess(int partitionId,
String name) |
MultiMapPartitionContainer |
getPartitionContainer(int partitionId) |
String |
getQuorumName(String name)
Gets the name of the quorum associated with specified operation name.
|
SerializationService |
getSerializationService() |
Map<String,LocalMultiMapStats> |
getStats()
Return the service statistics for the local instance.
|
void |
init(NodeEngine nodeEngine,
Properties properties)
Initializes this service.
|
void |
insertMigratedData(int partitionId,
Map<String,Map<Data,MultiMapValue>> map) |
boolean |
isKnownServiceNamespace(ServiceNamespace namespace)
Returns true if namespace is known by this service, false otherwise
|
Set<Data> |
localKeySet(String name) |
Runnable |
prepareMergeRunnable()
When the two separate clusters merge (resolve a split-brain), this method is called to return
a
Runnable , that will merge the clusters. |
Operation |
prepareReplicationOperation(PartitionReplicationEvent event)
Returns an operation to replicate service data and/or state for a specific partition replica
on another cluster member.
|
Operation |
prepareReplicationOperation(PartitionReplicationEvent event,
Collection<ServiceNamespace> namespaces)
Returns an operation to replicate service data and/or state for a specific partition replica and namespaces
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()
Resets this service back to its 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 service.
|
public static final String SERVICE_NAME
public MultiMapService(NodeEngine nodeEngine)
public void init(NodeEngine nodeEngine, Properties properties)
ManagedService
init
in interface ManagedService
nodeEngine
- the NodeEngine that this service belongs toproperties
- the Properties (can be used to pass settings to the service)public void reset()
ManagedService
TODO: what is the purpose of reset
reset
in interface ManagedService
public void shutdown(boolean terminate)
ManagedService
TODO: what is the purpose of the terminate variable
shutdown
in interface ManagedService
terminate
- true
to shut down this servicepublic MultiMapContainer getOrCreateCollectionContainer(int partitionId, String name)
public MultiMapContainer getOrCreateCollectionContainerWithoutAccess(int partitionId, String name)
public MultiMapPartitionContainer getPartitionContainer(int partitionId)
public DistributedObject createDistributedObject(String name)
RemoteService
createDistributedObject
in interface RemoteService
name
- the name for the created distributed objectpublic void destroyDistributedObject(String name)
RemoteService
destroyDistributedObject
in interface RemoteService
name
- the name of the distributed object to destroypublic SerializationService getSerializationService()
public NodeEngine getNodeEngine()
public void publishMultiMapEvent(String mapName, EntryEventType eventType, int numberOfEntriesAffected)
public final void publishEntryEvent(String multiMapName, EntryEventType eventType, Data key, Object newValue, Object oldValue)
public String addListener(String name, EventListener listener, Data key, boolean includeValue, boolean local)
public Collection<ServiceNamespace> getAllServiceNamespaces(PartitionReplicationEvent event)
FragmentedMigrationAwareService
getAllServiceNamespaces
in interface FragmentedMigrationAwareService
event
- replication eventpublic boolean isKnownServiceNamespace(ServiceNamespace namespace)
FragmentedMigrationAwareService
isKnownServiceNamespace
in interface FragmentedMigrationAwareService
namespace
- namespacepublic void beforeMigration(PartitionMigrationEvent partitionMigrationEvent)
MigrationAwareService
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.
beforeMigration
in interface MigrationAwareService
partitionMigrationEvent
- migration eventpublic Operation prepareReplicationOperation(PartitionReplicationEvent event)
MigrationAwareService
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.
prepareReplicationOperation
in interface MigrationAwareService
event
- replicationpublic Operation prepareReplicationOperation(PartitionReplicationEvent event, Collection<ServiceNamespace> namespaces)
FragmentedMigrationAwareService
MigrationAwareService.prepareReplicationOperation(PartitionReplicationEvent)
,
instead of copying whole partition replica, allows copying only some portion of replica,
specified by given namespaces.
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.
prepareReplicationOperation
in interface FragmentedMigrationAwareService
event
- replication eventnamespaces
- replica fragment namespaces to replicateMigrationAwareService.prepareReplicationOperation(PartitionReplicationEvent)
public void insertMigratedData(int partitionId, Map<String,Map<Data,MultiMapValue>> map)
public void commitMigration(PartitionMigrationEvent event)
MigrationAwareService
Commit is not expected to fail at this point, all exceptions will be suppressed and logged. Implementations of this method must be thread safe as this method may be called concurrently for different migrations on different partitions.
commitMigration
in interface MigrationAwareService
event
- migration eventpublic void rollbackMigration(PartitionMigrationEvent event)
MigrationAwareService
Rollback is not expected to fail at this point, all exceptions will be suppressed and logged. Implementations of this method must be thread safe as this method may be called concurrently for different migrations on different partitions.
rollbackMigration
in interface MigrationAwareService
event
- migration eventpublic LocalMultiMapStats createStats(String name)
public LocalMultiMapStatsImpl getLocalMultiMapStatsImpl(String name)
public <T extends TransactionalObject> T createTransactionalObject(String name, Transaction transaction)
createTransactionalObject
in interface TransactionalService
public void rollbackTransaction(String transactionId)
rollbackTransaction
in interface TransactionalService
public void dispatchEvent(EventData event, EntryListener listener)
EventPublishingService
dispatchEvent
in interface EventPublishingService<EventData,EntryListener>
event
- the published eventlistener
- the listener registered for this eventpublic Map<String,LocalMultiMapStats> getStats()
StatisticsAwareService
getStats
in interface StatisticsAwareService<LocalMultiMapStats>
public String getQuorumName(String name)
QuorumAwareService
getQuorumName
in interface QuorumAwareService
name
- the operation name for which the quorum name is returedpublic void ensureQuorumPresent(String distributedObjectName, QuorumType requiredQuorumPermissionType)
public Runnable prepareMergeRunnable()
SplitBrainHandlerService
Runnable
, that will merge the clusters.prepareMergeRunnable
in interface SplitBrainHandlerService
Runnable
that will merge the clustersCopyright © 2018 Hazelcast, Inc.. All Rights Reserved.