archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 23:04:50 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8296543: Update exception documentation for ExecutorService.invokeAll overriders as required

Browse source 
Reviewed-by: prappo, alanb
This commit is contained in:
Viktor Klang 2024-04-27 11:52:05 +00:00
parent aa2edd4913
commit e3eb652c25
1 changed files with 31 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

31
src/java.base/share/classes/java/util/concurrent/AbstractExecutorService.java
View file

@ -117,6 +117,7 @@ public abstract class AbstractExecutorService implements ExecutorService {
* @throws RejectedExecutionException {@inheritDoc} * @throws RejectedExecutionException {@inheritDoc}
* @throws NullPointerException {@inheritDoc} * @throws NullPointerException {@inheritDoc}
*/ */
@Override
public Future<?> submit(Runnable task) { public Future<?> submit(Runnable task) {
if (task == null) throw new NullPointerException(); if (task == null) throw new NullPointerException();
RunnableFuture<Void> ftask = newTaskFor(task, null); RunnableFuture<Void> ftask = newTaskFor(task, null);
@ -128,6 +129,7 @@ public abstract class AbstractExecutorService implements ExecutorService {
* @throws RejectedExecutionException {@inheritDoc} * @throws RejectedExecutionException {@inheritDoc}
* @throws NullPointerException {@inheritDoc} * @throws NullPointerException {@inheritDoc}
*/ */
@Override
public <T> Future<T> submit(Runnable task, T result) { public <T> Future<T> submit(Runnable task, T result) {
if (task == null) throw new NullPointerException(); if (task == null) throw new NullPointerException();
RunnableFuture<T> ftask = newTaskFor(task, result); RunnableFuture<T> ftask = newTaskFor(task, result);
@ -139,6 +141,7 @@ public abstract class AbstractExecutorService implements ExecutorService {
* @throws RejectedExecutionException {@inheritDoc} * @throws RejectedExecutionException {@inheritDoc}
* @throws NullPointerException {@inheritDoc} * @throws NullPointerException {@inheritDoc}
*/ */
@Override
public <T> Future<T> submit(Callable<T> task) { public <T> Future<T> submit(Callable<T> task) {
if (task == null) throw new NullPointerException(); if (task == null) throw new NullPointerException();
RunnableFuture<T> ftask = newTaskFor(task); RunnableFuture<T> ftask = newTaskFor(task);
@ -219,6 +222,14 @@ public abstract class AbstractExecutorService implements ExecutorService {
} }
} }
/**
* @throws InterruptedException {@inheritDoc}
* @throws NullPointerException {@inheritDoc}
* @throws IllegalArgumentException {@inheritDoc}
* @throws ExecutionException {@inheritDoc}
* @throws RejectedExecutionException {@inheritDoc}
*/
@Override
public <T> T invokeAny(Collection<? extends Callable<T>> tasks) public <T> T invokeAny(Collection<? extends Callable<T>> tasks)
throws InterruptedException, ExecutionException { throws InterruptedException, ExecutionException {
try { try {
@ -229,12 +240,26 @@ public abstract class AbstractExecutorService implements ExecutorService {
} }
} }
/**
* @throws InterruptedException {@inheritDoc}
* @throws NullPointerException {@inheritDoc}
* @throws TimeoutException {@inheritDoc}
* @throws ExecutionException {@inheritDoc}
* @throws RejectedExecutionException {@inheritDoc}
*/
@Override
public <T> T invokeAny(Collection<? extends Callable<T>> tasks, public <T> T invokeAny(Collection<? extends Callable<T>> tasks,
long timeout, TimeUnit unit) long timeout, TimeUnit unit)
throws InterruptedException, ExecutionException, TimeoutException { throws InterruptedException, ExecutionException, TimeoutException {
return doInvokeAny(tasks, true, unit.toNanos(timeout)); return doInvokeAny(tasks, true, unit.toNanos(timeout));
} }
/**
* @throws InterruptedException {@inheritDoc}
* @throws NullPointerException {@inheritDoc}
* @throws RejectedExecutionException {@inheritDoc}
*/
@Override
public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks) public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks)
throws InterruptedException { throws InterruptedException {
if (tasks == null) if (tasks == null)
@ -260,6 +285,12 @@ public abstract class AbstractExecutorService implements ExecutorService {
} }
} }
/**
* @throws InterruptedException {@inheritDoc}
* @throws NullPointerException {@inheritDoc}
* @throws RejectedExecutionException {@inheritDoc}
*/
@Override
public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks, public <T> List<Future<T>> invokeAll(Collection<? extends Callable<T>> tasks,
long timeout, TimeUnit unit) long timeout, TimeUnit unit)
throws InterruptedException { throws InterruptedException {