ExecutorService shutdown

Question

Sono confuso circa il javadoc del metodo ExecutorService#shutdown. Non sono queste dichiarazioni contraddittorie?

Avvia un arresto regolare in cui sono stati eseguiti i compiti precedentemente inviati , ma non verranno accettate nuove attività. Questo metodo non attende per le attività inviate in precedenza per completare l'esecuzione. Utilizzare Attendere il limite per farlo.

Se è possibile chiudere in modo ordinato le attività inviate in precedenza, come può non attendere il completamento dell'esecuzione?

Answer 1

Significa che il metodo restituisce immediatamente nel thread in cui viene chiamato, ma le attività che non sono state ancora eseguite potrebbero essere ancora in esecuzione, in altri thread.

Se si desidera che il programma attenda fino a quando non sono state completate le attività inviate in precedenza, è necessario chiamare awaitTermination dopo aver chiamato shutdown.

Answer 2

Significa che le attività verranno eseguite fino al completamento, ma questo metodo verrà restituito immediatamente, senza attendere che ciò accada.

Così, a modo pulito arresto il vostro esecutore senza uccidere qualsiasi attività, si farebbe:

executor.shutdown(); 
executor.awaitTermination(long timeout, TimeUnit unit); 

In alternativa, se si desidera solo per fermare il vostro esecutore il più rapidamente possibile, utilizzare shutdownNow().