Interface ExecutorService
Uma interface java.util.concurrent.ExecutorService é uma subinterface da interface do Executor e adiciona recursos para gerenciar o ciclo de vida, tanto das tarefas individuais quanto do próprio executor.
Métodos ExecutorService
Sr. Não. | Método e Descrição |
---|---|
1 | boolean awaitTermination(long timeout, TimeUnit unit) Bloqueia até que todas as tarefas tenham concluído a execução após uma solicitação de desligamento, ou o tempo limite ocorra ou o thread atual seja interrompido, o que ocorrer primeiro. |
2 | <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks) Executa as tarefas fornecidas, retornando uma lista de Futuros com seu status e resultados quando todos concluídos. |
3 | <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) Executa as tarefas fornecidas, retornando uma lista de Futuros com seus status e resultados quando todos forem concluídos ou o tempo limite expirar, o que ocorrer primeiro. |
4 | <T> T invokeAny(Collection<? extends Callable<T>> tasks) Executa as tarefas fornecidas, retornando o resultado de uma que foi concluída com êxito (ou seja, sem lançar uma exceção), se houver. |
5 | <T> T invokeAny(Collection<? extends Callable<T>> tasks, long timeout, TimeUnit unit) Executa as tarefas fornecidas, retornando o resultado de uma que foi concluída com êxito (ou seja, sem lançar uma exceção), se algum o fizer antes que o tempo limite determinado expire. |
6 | boolean isShutdown() Retorna verdadeiro se este executor foi desligado. |
7 | boolean isTerminated() Retorna verdadeiro se todas as tarefas foram concluídas após o desligamento. |
8 | void shutdown() Inicia um desligamento ordenado no qual as tarefas enviadas anteriormente são executadas, mas nenhuma tarefa nova será aceita. |
9 | List<Runnable> shutdownNow() Tenta interromper todas as tarefas em execução ativa, interrompe o processamento das tarefas em espera e retorna uma lista das tarefas que estavam aguardando execução. |
10 | <T> Future<T> submit(Callable<T> task) Envia uma tarefa de retorno de valor para execução e retorna um Future que representa os resultados pendentes da tarefa. |
11 | Future<?> submit(Runnable task) Envia uma tarefa Executável para execução e retorna um Future que representa essa tarefa. |
12 | <T> Future<T> submit(Runnable task, T result) Envia uma tarefa Executável para execução e retorna um Future que representa essa tarefa. |
Exemplo
O seguinte programa TestThread mostra o uso da interface ExecutorService em um ambiente baseado em thread.
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;
public class TestThread {
public static void main(final String[] arguments) throws InterruptedException {
ExecutorService executor = Executors.newSingleThreadExecutor();
try {
executor.submit(new Task());
System.out.println("Shutdown executor");
executor.shutdown();
executor.awaitTermination(5, TimeUnit.SECONDS);
} catch (InterruptedException e) {
System.err.println("tasks interrupted");
} finally {
if (!executor.isTerminated()) {
System.err.println("cancel non-finished tasks");
}
executor.shutdownNow();
System.out.println("shutdown finished");
}
}
static class Task implements Runnable {
public void run() {
try {
Long duration = (long) (Math.random() * 20);
System.out.println("Running Task!");
TimeUnit.SECONDS.sleep(duration);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}
}
Isso produzirá o seguinte resultado.
Resultado
Shutdown executor
Running Task!
shutdown finished
cancel non-finished tasks
java.lang.InterruptedException: sleep interrupted
at java.lang.Thread.sleep(Native Method)
at java.lang.Thread.sleep(Thread.java:302)
at java.util.concurrent.TimeUnit.sleep(TimeUnit.java:328)
at TestThread$Task.run(TestThread.java:39)
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:439)
at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:303)
at java.util.concurrent.FutureTask.run(FutureTask.java:138)
at java.util.concurrent.ThreadPoolExecutor$Worker.runTask(ThreadPoolExecutor.java:895)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:918)
at java.lang.Thread.run(Thread.java:662)