public interface InvocationService extends Service
Note: Invocable objects that do not implement the PriorityTask
interface will execute without any timeout. Furthermore, the executing
service or worker thread will not be protected by the service guardian while
the invocation is in progress.
Note: The InvocationService is a feature of the Coherence Enterprise Edition or Grid Edition. This service cannot be used in a Coherence Standard Edition cluster.
Service.MemberJoinAction
Modifier and Type | Field and Description |
---|---|
static String |
TYPE_DEFAULT
Invocation service type constant.
|
static String |
TYPE_REMOTE
Remote invocation service type constant.
|
Modifier and Type | Method and Description |
---|---|
void |
execute(Invocable task,
Set setMembers,
InvocationObserver observer)
Asynchronously invoke the specified task on each of the specified
members.
|
Map |
query(Invocable task,
Set setMembers)
Synchronously invoke the specified task on each of the specified
members.
|
addMemberListener, getCluster, getDependencies, getInfo, getResourceRegistry, getSerializer, getUserContext, removeMemberListener, setDependencies, setUserContext
addServiceListener, removeServiceListener
configure, isRunning, shutdown, start, stop
getContextClassLoader, setContextClassLoader
static final String TYPE_DEFAULT
static final String TYPE_REMOTE
void execute(Invocable task, Set setMembers, InvocationObserver observer)
task
- the Invocable object to distribute to the specified
members in order to be invoked on those memberssetMembers
- (optional) a set of cluster members to which the
Invocable object will be distributed; if null, the
Invocable object will be distributed to all cluster
members that are running this serviceobserver
- (optional) the InvocationObserver object that will
receive notifications related to the Invocable objectMap query(Invocable task, Set setMembers)
Members that are specified but are not currently running the InvocationService will not invoke the specified Invocable object. Members that leave (gracefully or otherwise) before the invocation completes will not register a result, and the amount of processing that completed is indeterminate. Members that encounter an exception during invocation will not be retried and no result is returned. Specifically, the result for a given member will not be present under the following conditions:
task
- the Invocable object to distribute to the specified
members in order to be invoked on those memberssetMembers
- (optional) a set of cluster members to which the
Invocable object will be distributed; if null, the
Invocable object will be distributed to all cluster
members that are running this service