[concurrency-interest] javadoc upgrade for threadpoolexecutor.shutdown/shutdownnow
joe.bowbeer at gmail.com
Wed Jul 19 16:05:29 EDT 2006
On 7/19/06, Peter Veentjer <alarmnummer at gmail.com> wrote:
> I had a nice discussion with a colleague of mine about the
> ThreadPoolExecutor and the shutdown/shutdownNow methods.
> It wasn't clear that the shutdown method doesn't block but only
> signals that the ThreadPoolExecutor is going to shut down.
> The shutdownNow method does block (untill all running tasks have
> processed) and this wasn't very intuitive also.
> So can the documentation be upgrades so they explain the blocking
> behaviour of both methods?
shutdownNow doesn't block either (and doesn't throw InterruptedException).
awaitTermination blocks (and throws InterruptedException).
We've just updated javadoc in ExecutorService, explaining what
shutdownNow does and adding a shutdownAndAwaitTermination example.
Is this sufficient, or should we add a link back to this in ThreadPoolExecutor?
More information about the Concurrency-interest