com.hazelcast.durableexecutor.impl

Class DistributedDurableExecutorService

java.lang.Object

com.hazelcast.durableexecutor.impl.DistributedDurableExecutorService

All Implemented Interfaces:

ManagedService, RemoteService, SplitBrainProtectionAwareService, MigrationAwareService

public class DistributedDurableExecutorService
extends Object
implements ManagedService, RemoteService, MigrationAwareService, SplitBrainProtectionAwareService

Field Summary

Fields

Modifier and Type	Field and Description
static String	SERVICE_NAME

Constructor Summary

Constructors

Constructor and Description
DistributedDurableExecutorService(NodeEngineImpl nodeEngine)

Method Summary

Modifier and Type	Method and Description
void	beforeMigration(PartitionMigrationEvent event) 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, boolean local) Creates a distributed object on the local member only (when local is true), else cluster-wide.
void	destroyDistributedObject(String name, boolean local) Destroys a distributed object.
NodeEngine	getNodeEngine()
DurableExecutorPartitionContainer	getPartitionContainer(int partitionId)
String	getSplitBrainProtectionName(String name) Gets the name of the split brain protection associated with specified operation name.
void	init(NodeEngine nodeEngine, Properties properties) Initializes this service.
boolean	isShutdown(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	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	shutdown(boolean terminate) Shuts down this service.
void	shutdownExecutor(String name)

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.hazelcast.internal.services.RemoteService

createDistributedObject, destroyDistributedObject

Field Detail

SERVICE_NAME

public static final String SERVICE_NAME

See Also:

Constant Field Values

Constructor Detail

DistributedDurableExecutorService

public DistributedDurableExecutorService(NodeEngineImpl nodeEngine)

Method Detail

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)

getPartitionContainer

public DurableExecutorPartitionContainer getPartitionContainer(int partitionId)

getNodeEngine

public NodeEngine getNodeEngine()

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

createDistributedObject

public DistributedObject createDistributedObject(String name,
                                                 boolean local)

Description copied from interface: RemoteService

Creates a distributed object on the local member only (when local is true), else cluster-wide.

Specified by:

createDistributedObject in interface RemoteService

Parameters:

name - the name for the created distributed object

local - when true then only perform required proxy creation actions on the local member, otherwise perform cluster-wide proxy creation.

Returns:

the created distributed object

destroyDistributedObject

public void destroyDistributedObject(String name,
                                     boolean local)

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

shutdownExecutor

public void shutdownExecutor(String name)

isShutdown

public boolean isShutdown(String name)

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

beforeMigration

public void beforeMigration(PartitionMigrationEvent event)

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:

event - migration event

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. Implementations of this method must be thread safe as this method may be called concurrently for different migrations on different partitions.

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. Implementations of this method must be thread safe as this method may be called concurrently for different migrations on different partitions.

Specified by:

rollbackMigration in interface MigrationAwareService

Parameters:

event - migration event

getSplitBrainProtectionName

public String getSplitBrainProtectionName(String name)

Description copied from interface: SplitBrainProtectionAwareService

Gets the name of the split brain protection associated with specified operation name.

Specified by:

getSplitBrainProtectionName in interface SplitBrainProtectionAwareService

Parameters:

name - the operation name for which the split brain protection name is returned

Returns:

name of the associated split brain protection, null if there is no associated split brain protection