Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/*
* Copyright (c) 2008-2013, Hazelcast, Inc. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.hazelcast.core;
import com.hazelcast.monitor.LocalExecutorStats;
import java.util.Collection;
import java.util.Map;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Future;
/**
* Distributed implementation of {@link ExecutorService}.
* IExecutorService provides additional methods like executing tasks
* on a specific member, on a member who is owner of a specific key,
* executing a tasks on multiple members and listening execution result using a callback.
*
* @see ExecutorService
* @see ExecutionCallback
* @see MultiExecutionCallback
*/
public interface IExecutorService extends ExecutorService, DistributedObject {
/**
* Executes task on a randomly selected member
*
* @param command task
* @param memberSelector memberSelector
*/
void execute(Runnable command, MemberSelector memberSelector);
/**
* Executes task on owner of the specified key
*
* @param command task
* @param key key
*/
void executeOnKeyOwner(Runnable command, Object key);
/**
* Executes task on the specified member
*
* @param command task
* @param member member
*/
void executeOnMember(Runnable command, Member member);
/**
* Executes task on each of the specified members
*
* @param command task
* @param members members
*/
void executeOnMembers(Runnable command, Collection members);
/**
* Executes task on each of the selected members
*
* @param command task
* @param memberSelector memberSelector
*/
void executeOnMembers(Runnable command, MemberSelector memberSelector);
/**
* Executes task on all of known cluster members
*
* @param command task
*/
void executeOnAllMembers(Runnable command);
/**
* Submits task to a randomly selected member and returns a Future
* representing that task.
*
* @param task task
* @param memberSelector memberSelector
* @return a Future representing pending completion of the task
*/
Future submit(Callable task, MemberSelector memberSelector);
/**
* Submits task to owner of the specified key and returns a Future
* representing that task.
*
* @param task task
* @param key key
* @return a Future representing pending completion of the task
*/
Future submitToKeyOwner(Callable task, Object key);
/**
* Submits task to specified member and returns a Future
* representing that task.
*
* @param task task
* @param member member
* @return a Future representing pending completion of the task
*/
Future submitToMember(Callable task, Member member);
/**
* Submits task to given members and returns
* map of Member-Future pairs representing pending completion of the task on each member
*
* @param task task
* @param members members
* @return map of Member-Future pairs representing pending completion of the task on each member
*/
Map> submitToMembers(Callable task, Collection members);
/**
* Submits task to selected members and returns
* map of Member-Future pairs representing pending completion of the task on each member
*
* @param task task
* @param memberSelector memberSelector
* @return map of Member-Future pairs representing pending completion of the task on each member
*/
Map> submitToMembers(Callable task, MemberSelector memberSelector);
/**
* Submits task to all cluster members and returns
* map of Member-Future pairs representing pending completion of the task on each member
*
* @param task task
* @return map of Member-Future pairs representing pending completion of the task on each member
*/
Map> submitToAllMembers(Callable task);
/**
* Submits task to a random member. Caller will be notified for the result of the task by
* {@link ExecutionCallback#onResponse(Object)} or {@link ExecutionCallback#onFailure(Throwable)}.
*
* @param task task
* @param callback callback
*/
void submit(Runnable task, ExecutionCallback callback);
/**
* Submits task to a randomly selected members. Caller will be notified for the result of the task by
* {@link ExecutionCallback#onResponse(Object)} or {@link ExecutionCallback#onFailure(Throwable)}.
*
* @param task task
* @param memberSelector memberSelector
* @param callback callback
*/
void submit(Runnable task, MemberSelector memberSelector, ExecutionCallback callback);
/**
* Submits task to owner of the specified key. Caller will be notified for the result of the task by
* {@link ExecutionCallback#onResponse(Object)} or {@link ExecutionCallback#onFailure(Throwable)}.
*
* @param task task
* @param callback callback
*/
void submitToKeyOwner(Runnable task, Object key, ExecutionCallback callback);
/**
* Submits task to the specified member. Caller will be notified for the result of the task by
* {@link ExecutionCallback#onResponse(Object)} or {@link ExecutionCallback#onFailure(Throwable)}.
*
* @param task task
* @param callback callback
*/
void submitToMember(Runnable task, Member member, ExecutionCallback callback);
/**
* Submits task to the specified members. Caller will be notified for the result of the each task by
* {@link MultiExecutionCallback#onResponse(Member, Object)}, and when all tasks are completed,
* {@link MultiExecutionCallback#onComplete(java.util.Map)} will be called.
*
* @param task task
* @param members members
* @param callback callback
*/
void submitToMembers(Runnable task, Collection members, MultiExecutionCallback callback);
/**
* Submits task to the selected members. Caller will be notified for the result of the each task by
* {@link MultiExecutionCallback#onResponse(Member, Object)}, and when all tasks are completed,
* {@link MultiExecutionCallback#onComplete(java.util.Map)} will be called.
*
* @param task task
* @param memberSelector memberSelector
* @param callback callback
*/
void submitToMembers(Runnable task, MemberSelector memberSelector, MultiExecutionCallback callback);
/**
* Submits task to the all cluster members. Caller will be notified for the result of the each task by
* {@link MultiExecutionCallback#onResponse(Member, Object)}, and when all tasks are completed,
* {@link MultiExecutionCallback#onComplete(java.util.Map)} will be called.
*
* @param task task
* @param callback callback
*/
void submitToAllMembers(Runnable task, MultiExecutionCallback callback);
/**
* Submits task to a random member. Caller will be notified for the result of the task by
* {@link ExecutionCallback#onResponse(Object)} or {@link ExecutionCallback#onFailure(Throwable)}.
*
* @param task task
* @param callback callback
*/
void submit(Callable task, ExecutionCallback callback);
/**
* Submits task to a randomly selected member. Caller will be notified for the result of the task by
* {@link ExecutionCallback#onResponse(Object)} or {@link ExecutionCallback#onFailure(Throwable)}.
*
* @param task task
* @param memberSelector memberSelector
* @param callback callback
*/
void submit(Callable task, MemberSelector memberSelector, ExecutionCallback callback);
/**
* Submits task to owner of the specified key. Caller will be notified for the result of the task by
* {@link ExecutionCallback#onResponse(Object)} or {@link ExecutionCallback#onFailure(Throwable)}.
*
* @param task task
* @param callback callback
*/
void submitToKeyOwner(Callable task, Object key, ExecutionCallback callback);
/**
* Submits task to the specified member. Caller will be notified for the result of the task by
* {@link ExecutionCallback#onResponse(Object)} or {@link ExecutionCallback#onFailure(Throwable)}.
*
* @param task task
* @param callback callback
*/
void submitToMember(Callable task, Member member, ExecutionCallback callback);
/**
* Submits task to the specified members. Caller will be notified for the result of the each task by
* {@link MultiExecutionCallback#onResponse(Member, Object)}, and when all tasks are completed,
* {@link MultiExecutionCallback#onComplete(java.util.Map)} will be called.
*
* @param task task
* @param members members
* @param callback callback
*/
void submitToMembers(Callable task, Collection members, MultiExecutionCallback callback);
/**
* Submits task to the selected members. Caller will be notified for the result of the each task by
* {@link MultiExecutionCallback#onResponse(Member, Object)}, and when all tasks are completed,
* {@link MultiExecutionCallback#onComplete(java.util.Map)} will be called.
*
* @param task task
* @param memberSelector memberSelector
* @param callback callback
*/
void submitToMembers(Callable task, MemberSelector memberSelector, MultiExecutionCallback callback);
/**
* Submits task to the all cluster members. Caller will be notified for the result of the each task by
* {@link MultiExecutionCallback#onResponse(Member, Object)}, and when all tasks are completed,
* {@link MultiExecutionCallback#onComplete(java.util.Map)} will be called.
*
* @param task task
* @param callback callback
*/
void submitToAllMembers(Callable task, MultiExecutionCallback callback);
/**
* Returns local statistics related to this executor service.
*
* @return local statistics related to this executor service.
*/
LocalExecutorStats getLocalExecutorStats();
}
