Module parallel.collectors
Package com.pivovarit.collectors

Class ParallelCollectors.Batching

java.lang.Object
com.pivovarit.collectors.ParallelCollectors.Batching
Enclosing class:
ParallelCollectors
public static final class ParallelCollectors.Batching extends Object
A subset of collectors which perform operations in batches and not separately (one object in a thread pool's worker queue represents a batch of operations to be performed by a single thread)

  • Method Details

    • parallel

      public static <T, R, RR> Collector<T,?,CompletableFuture<RR>> parallel(Function<T,R> mapper, Collector<R,?,RR> collector, Executor executor, int parallelism)
      A convenience Collector used for executing parallel computations on a custom Executor and returning them as a CompletableFuture containing a result of the application of the user-provided Collector.
      Example: 
      
 CompletableFuture<List<String>> result = Stream.of(1, 2, 3)
   .collect(parallel(i -> foo(i), toList(), executor, 2));
      Type Parameters:
      T - the type of the collected elements
      R - the result returned by mapper
      RR - the reduction result collector
      Parameters:
      mapper - a transformation to be performed in parallel
      collector - the Collector describing the reduction
      executor - the Executor to use for asynchronous execution
      parallelism - the max parallelism level
      Returns:
      a Collector which collects all processed elements into a user-provided mutable Collection in parallel
      Since:
      2.1.0

    • parallel

      public static <T, R> Collector<T,?,CompletableFuture<Stream<R>>> parallel(Function<T,R> mapper, Executor executor, int parallelism)
      A convenience Collector used for executing parallel computations on a custom Executor and returning them as CompletableFuture containing a Stream of these elements.

      The collector maintains the order of processed Stream. Instances should not be reused.
      Example: 
      
 CompletableFuture<Stream<String>> result = Stream.of(1, 2, 3)
   .collect(parallel(i -> foo(), executor, 2));
      Type Parameters:
      T - the type of the collected elements
      R - the result returned by mapper
      Parameters:
      mapper - a transformation to be performed in parallel
      executor - the Executor to use for asynchronous execution
      parallelism - the max parallelism level
      Returns:
      a Collector which collects all processed elements into a Stream in parallel
      Since:
      2.1.0

    • parallelToStream

      public static <T, R> Collector<T,?,Stream<R>> parallelToStream(Function<T,R> mapper, Executor executor, int parallelism)
      A convenience Collector used for executing parallel computations on a custom Executor and returning a Stream instance returning results as they arrive.

      For the parallelism of 1, the stream is executed by the calling thread.
      Example: 

      
 Stream.of(1, 2, 3)
   .collect(parallelToStream(i -> foo(), executor, 2))
   .forEach(System.out::println);
      Type Parameters:
      T - the type of the collected elements
      R - the result returned by mapper
      Parameters:
      mapper - a transformation to be performed in parallel
      executor - the Executor to use for asynchronous execution
      parallelism - the max parallelism level
      Returns:
      a Collector which collects all processed elements into a Stream in parallel
      Since:
      2.1.0

    • parallelToOrderedStream

      public static <T, R> Collector<T,?,Stream<R>> parallelToOrderedStream(Function<T,R> mapper, Executor executor, int parallelism)
      A convenience Collector used for executing parallel computations on a custom Executor and returning a Stream instance returning results as they arrive while maintaining the initial order.

      For the parallelism of 1, the stream is executed by the calling thread.
      Example: 

      
 Stream.of(1, 2, 3)
   .collect(parallelToOrderedStream(i -> foo(), executor, 2))
   .forEach(System.out::println);
      Type Parameters:
      T - the type of the collected elements
      R - the result returned by mapper
      Parameters:
      mapper - a transformation to be performed in parallel
      executor - the Executor to use for asynchronous execution
      parallelism - the max parallelism level
      Returns:
      a Collector which collects all processed elements into a Stream in parallel
      Since:
      2.1.0