org.apache.ratis.util

接口 ConcurrentUtils

public interface ConcurrentUtils

Utilities related to concurrent programming.

方法概要

限定符和类型	方法和说明
static <E,THROWABLE extends Throwable> void	accept(CheckedConsumer<? super E,THROWABLE> action, E element, CompletableFuture<E> f)
static ExecutorService	newCachedThreadPool(int maximumPoolSize, ThreadFactory threadFactory) The same as Executors.newCachedThreadPool(ThreadFactory) except that this method takes a maximumPoolSize parameter.
static ExecutorService	newSingleThreadExecutor(String name) This method is similar to Executors.newSingleThreadExecutor(ThreadFactory) except that this method takes a specific thread name as there is only one thread.g
static ThreadFactory	newThreadFactory(String namePrefix) Creates a ThreadFactory so that the threads created by the factory are named with the given name prefix.
static ExecutorService	newThreadPoolWithMax(boolean cached, int maximumPoolSize, String namePrefix) Create a new ExecutorService with a maximum pool size.
static <E,THROWABLE extends Throwable> CompletableFuture<Void>	parallelForEachAsync(Collection<E> collection, CheckedConsumer<? super E,THROWABLE> action, Executor executor) The same as parallelForEachAsync(collection.stream(), collection.size(), action, executor).
static <THROWABLE extends Throwable> CompletableFuture<Void>	parallelForEachAsync(int size, CheckedConsumer<Integer,THROWABLE> action, Executor executor) The same as parallelForEachAsync(collection.stream(), collection.size(), action, executor).
static <E,THROWABLE extends Throwable> CompletableFuture<Void>	parallelForEachAsync(Stream<E> stream, int size, CheckedConsumer<? super E,THROWABLE> action, Executor executor) The same as Collection.parallelStream().forEach(action) except that (1) this method is asynchronous, (2) this method has an executor parameter, and (3) the action can throw a checked exception.
static void	shutdownAndWait(ExecutorService executor) Shutdown the given executor and wait for its termination.
static void	shutdownAndWait(TimeDuration waitTime, ExecutorService executor, Consumer<TimeDuration> timoutHandler)
static <E,THROWABLE extends Throwable> E	updateAndGet(AtomicReference<E> reference, CheckedFunction<E,E,THROWABLE> update) Similar to AtomicReference.updateAndGet(java.util.function.UnaryOperator) except that the update function is checked.

方法详细资料

updateAndGet

static <E,THROWABLE extends Throwable> E updateAndGet(AtomicReference<E> reference,
                                                      CheckedFunction<E,E,THROWABLE> update)
                                               throws THROWABLE extends Throwable

Similar to AtomicReference.updateAndGet(java.util.function.UnaryOperator) except that the update function is checked.

抛出:

THROWABLE extends Throwable

newThreadFactory

static ThreadFactory newThreadFactory(String namePrefix)

Creates a ThreadFactory so that the threads created by the factory are named with the given name prefix.

参数:

namePrefix - the prefix used in the name of the threads created.

返回:

a new ThreadFactory.

newSingleThreadExecutor

static ExecutorService newSingleThreadExecutor(String name)

This method is similar to Executors.newSingleThreadExecutor(ThreadFactory) except that this method takes a specific thread name as there is only one thread.g

参数:

name - the thread name for only one thread.

返回:

a new ExecutorService.

newCachedThreadPool

static ExecutorService newCachedThreadPool(int maximumPoolSize,
                                           ThreadFactory threadFactory)

The same as Executors.newCachedThreadPool(ThreadFactory) except that this method takes a maximumPoolSize parameter.

参数:

maximumPoolSize - the maximum number of threads to allow in the pool. When maximumPoolSize == 0, this method is the same as Executors.newCachedThreadPool(ThreadFactory).

返回:

a new ExecutorService.

newThreadPoolWithMax

static ExecutorService newThreadPoolWithMax(boolean cached,
                                            int maximumPoolSize,
                                            String namePrefix)

Create a new ExecutorService with a maximum pool size. If it is cached, this method is similar to newCachedThreadPool(int, ThreadFactory). Otherwise, this method is similar to Executors.newFixedThreadPool(int).

参数:

cached - Use cached thread pool? If not, use a fixed thread pool.

maximumPoolSize - the maximum number of threads to allow in the pool.

namePrefix - the prefix used in the name of the threads created.

返回:

a new ExecutorService.

shutdownAndWait

static void shutdownAndWait(ExecutorService executor)

Shutdown the given executor and wait for its termination.

参数:

executor - The executor to be shut down.

shutdownAndWait

static void shutdownAndWait(TimeDuration waitTime,
                            ExecutorService executor,
                            Consumer<TimeDuration> timoutHandler)

parallelForEachAsync

static <E,THROWABLE extends Throwable> CompletableFuture<Void> parallelForEachAsync(Stream<E> stream,
                                                                                    int size,
                                                                                    CheckedConsumer<? super E,THROWABLE> action,
                                                                                    Executor executor)

The same as Collection.parallelStream().forEach(action) except that (1) this method is asynchronous, (2) this method has an executor parameter, and (3) the action can throw a checked exception.

类型参数:

E - The element type.

THROWABLE - the exception type.

参数:

stream - The stream to be processed.

size - The estimated size of the stream.

action - To act on each element in the stream.

executor - To execute the action.

返回:

a CompletableFuture that is completed when the action is completed for each element in the collection. When the action throws an exception, the future will be completed exceptionally.

另请参阅:

Collection.parallelStream(), Stream.forEach(Consumer)

parallelForEachAsync

static <E,THROWABLE extends Throwable> CompletableFuture<Void> parallelForEachAsync(Collection<E> collection,
                                                                                    CheckedConsumer<? super E,THROWABLE> action,
                                                                                    Executor executor)

The same as parallelForEachAsync(collection.stream(), collection.size(), action, executor).

parallelForEachAsync

static <THROWABLE extends Throwable> CompletableFuture<Void> parallelForEachAsync(int size,
                                                                                  CheckedConsumer<Integer,THROWABLE> action,
                                                                                  Executor executor)

The same as parallelForEachAsync(collection.stream(), collection.size(), action, executor).

accept

static <E,THROWABLE extends Throwable> void accept(CheckedConsumer<? super E,THROWABLE> action,
                                                   E element,
                                                   CompletableFuture<E> f)