Class CompletionStages


  • public class CompletionStages
    extends java.lang.Object
    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static java.util.concurrent.CompletionStage<java.lang.Void> applyToAll​(java.util.function.Function<java.lang.Object,​java.util.concurrent.CompletionStage<?>> op, java.lang.Object[] entity)  
      static <T> java.util.concurrent.CompletionStage<T> completedFuture​(T value)  
      static <T> java.util.concurrent.CompletionStage<T> failedFuture​(java.lang.Throwable t)  
      static java.util.concurrent.CompletionStage<java.lang.Boolean> falseFuture()  
      static <R,​T extends java.lang.Throwable>
      CompletionStages.CompletionStageHandler<R,​T>
      handle​(R result, T throwable)  
      static <U> U ignoreErrors​(java.lang.Void unused, java.lang.Throwable throwable)
      For CompletionStage#handle when we don't care about errors
      static void logSqlException​(java.lang.Throwable t, java.util.function.Supplier<java.lang.String> message, java.lang.String sql)  
      static java.util.concurrent.CompletionStage<java.lang.Void> loop​(int start, int end, java.util.function.IntFunction<java.util.concurrent.CompletionStage<?>> consumer)
      Equivalent to:
      static java.util.concurrent.CompletionStage<java.lang.Void> loop​(int start, int end, java.util.function.IntPredicate filter, java.util.function.IntFunction<java.util.concurrent.CompletionStage<?>> consumer)
      Equivalent to:
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Collection<T> collection, java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
      Equivalent to:
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Collection<T> collection, java.util.function.Predicate<T> filter, java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
      Deprecated.
      always prefer the variants which use a List rather than a Collection
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Iterator<T> iterator, IntBiFunction<T,​java.util.concurrent.CompletionStage<?>> consumer)
      Equivalent to:
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Iterator<T> iterator, IntBiPredicate<T> filter, IntBiFunction<T,​java.util.concurrent.CompletionStage<?>> consumer)
      Equivalent to:
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.List<T> list, java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)  
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.List<T> list, java.util.function.Predicate<T> filter, java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)  
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Queue<T> queue, java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)  
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(T[] array, java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
      Equivalent to:
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(T[] array, java.util.function.IntPredicate filter, java.util.function.IntFunction<java.util.concurrent.CompletionStage<?>> consumer)
      Equivalent to:
      static <T> java.util.concurrent.CompletionStage<T> nullFuture()  
      static <U> U nullFuture​(java.lang.Void unused)  
      static <T extends java.lang.Throwable,​Ret>
      Ret
      rethrow​(java.lang.Throwable x)  
      static <T extends java.lang.Throwable,​Ret>
      Ret
      returnNullorRethrow​(java.lang.Throwable x)  
      static <T extends java.lang.Throwable,​Ret>
      Ret
      returnOrRethrow​(java.lang.Throwable x, Ret result)  
      static java.util.concurrent.CompletionStage<java.lang.Integer> total​(int start, int end, java.util.function.IntFunction<java.util.concurrent.CompletionStage<java.lang.Integer>> consumer)
      Equivalent to:
      static <T> java.util.concurrent.CompletionStage<java.lang.Integer> total​(java.util.Iterator<T> iterator, java.util.function.Function<T,​java.util.concurrent.CompletionStage<java.lang.Integer>> consumer)
      Equivalent to:
      static <T> java.util.concurrent.CompletionStage<java.lang.Integer> total​(T[] array, java.util.function.Function<T,​java.util.concurrent.CompletionStage<java.lang.Integer>> consumer)
      Equivalent to:
      static java.util.concurrent.CompletionStage<java.lang.Boolean> trueFuture()  
      static java.util.concurrent.CompletionStage<java.lang.Void> voidFuture()  
      static java.util.concurrent.CompletionStage<java.lang.Void> voidFuture​(java.lang.Object ignore)  
      static java.util.concurrent.CompletionStage<java.lang.Void> whileLoop​(int start, int end, java.util.function.IntPredicate filter, java.util.function.IntFunction<java.util.concurrent.CompletionStage<java.lang.Boolean>> consumer)  
      static java.util.concurrent.CompletionStage<java.lang.Void> whileLoop​(java.util.function.Supplier<java.lang.Boolean> whileCondition, java.util.function.Supplier<java.util.concurrent.CompletionStage<?>> loopSupplier)  
      static java.util.concurrent.CompletionStage<java.lang.Void> whileLoop​(java.util.function.Supplier<java.util.concurrent.CompletionStage<java.lang.Boolean>> loopSupplier)  
      static <T> java.util.concurrent.CompletionStage<java.lang.Void> whileLoop​(T[] array, java.util.function.Function<T,​java.util.concurrent.CompletionStage<java.lang.Boolean>> consumer)  
      static java.util.concurrent.CompletionStage<java.lang.Integer> zeroFuture()  
      static java.util.concurrent.CompletionStage<java.lang.Integer> zeroFuture​(java.lang.Object ignore)  
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • CompletionStages

        public CompletionStages()
    • Method Detail

      • voidFuture

        public static java.util.concurrent.CompletionStage<java.lang.Void> voidFuture​(java.lang.Object ignore)
      • voidFuture

        public static java.util.concurrent.CompletionStage<java.lang.Void> voidFuture()
      • zeroFuture

        public static java.util.concurrent.CompletionStage<java.lang.Integer> zeroFuture()
      • zeroFuture

        public static java.util.concurrent.CompletionStage<java.lang.Integer> zeroFuture​(java.lang.Object ignore)
      • trueFuture

        public static java.util.concurrent.CompletionStage<java.lang.Boolean> trueFuture()
      • falseFuture

        public static java.util.concurrent.CompletionStage<java.lang.Boolean> falseFuture()
      • nullFuture

        public static <T> java.util.concurrent.CompletionStage<T> nullFuture()
      • completedFuture

        public static <T> java.util.concurrent.CompletionStage<T> completedFuture​(T value)
      • failedFuture

        public static <T> java.util.concurrent.CompletionStage<T> failedFuture​(java.lang.Throwable t)
      • rethrow

        public static <T extends java.lang.Throwable,​Ret> Ret rethrow​(java.lang.Throwable x)
                                                                     throws T extends java.lang.Throwable
        Throws:
        T extends java.lang.Throwable
      • returnNullorRethrow

        public static <T extends java.lang.Throwable,​Ret> Ret returnNullorRethrow​(java.lang.Throwable x)
                                                                                 throws T extends java.lang.Throwable
        Throws:
        T extends java.lang.Throwable
      • returnOrRethrow

        public static <T extends java.lang.Throwable,​Ret> Ret returnOrRethrow​(java.lang.Throwable x,
                                                                                    Ret result)
                                                                             throws T extends java.lang.Throwable
        Throws:
        T extends java.lang.Throwable
      • ignoreErrors

        public static <U> U ignoreErrors​(java.lang.Void unused,
                                         java.lang.Throwable throwable)
        For CompletionStage#handle when we don't care about errors
      • logSqlException

        public static void logSqlException​(java.lang.Throwable t,
                                           java.util.function.Supplier<java.lang.String> message,
                                           java.lang.String sql)
      • total

        public static java.util.concurrent.CompletionStage<java.lang.Integer> total​(int start,
                                                                                    int end,
                                                                                    java.util.function.IntFunction<java.util.concurrent.CompletionStage<java.lang.Integer>> consumer)
        Equivalent to:
        
         int total = 0;
         for ( int i = start; i < end; i++ ) {
           total = total + consumer.apply( i );
         }
         
      • total

        public static <T> java.util.concurrent.CompletionStage<java.lang.Integer> total​(java.util.Iterator<T> iterator,
                                                                                        java.util.function.Function<T,​java.util.concurrent.CompletionStage<java.lang.Integer>> consumer)
        Equivalent to:
        
         int total = 0;
         while( iterator.hasNext() ) {
           total += consumer.apply( iterator.next() );
         }
         
      • total

        public static <T> java.util.concurrent.CompletionStage<java.lang.Integer> total​(T[] array,
                                                                                        java.util.function.Function<T,​java.util.concurrent.CompletionStage<java.lang.Integer>> consumer)
        Equivalent to:
        
         int total = 0;
         for ( int i = start; i < end; i++ ) {
           total = total + consumer.apply( array[i] );
         }
         
      • loop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(T[] array,
                                                                                    java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
        Equivalent to:
        
         for ( int i = start; i < end; i++ ) {
           consumer.apply( array[i] );
         }
         
      • loop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(T[] array,
                                                                                    java.util.function.IntPredicate filter,
                                                                                    java.util.function.IntFunction<java.util.concurrent.CompletionStage<?>> consumer)
        Equivalent to:
        
         for ( int i = start; i < end; i++ ) {
           if ( filter.test(i) )  {
           	consumer.apply( i );
           }
         }
         
      • loop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Iterator<T> iterator,
                                                                                    IntBiFunction<T,​java.util.concurrent.CompletionStage<?>> consumer)
        Equivalent to:
        
         int index = 0
         while( iterator.hasNext() ) {
           consumer.apply( iterator.next(), index++ );
         }
         
      • loop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Iterator<T> iterator,
                                                                                    IntBiPredicate<T> filter,
                                                                                    IntBiFunction<T,​java.util.concurrent.CompletionStage<?>> consumer)
        Equivalent to:
        
         int index = -1
         while( iterator.hasNext() ) {
           index++
           T next = iterator.next();
           if (filter.test( next, index ) {
             consumer.apply( next, index );
           }
         }
         
      • nullFuture

        public static <U> U nullFuture​(java.lang.Void unused)
      • loop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Collection<T> collection,
                                                                                    java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
        Equivalent to:
         for ( Object next : iterable ) {
           consumer.apply( next );
         }
         
      • loop

        @Deprecated
        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Collection<T> collection,
                                                                                    java.util.function.Predicate<T> filter,
                                                                                    java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
        Deprecated.
        always prefer the variants which use a List rather than a Collection
      • loop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.List<T> list,
                                                                                    java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
      • loop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.List<T> list,
                                                                                    java.util.function.Predicate<T> filter,
                                                                                    java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
      • loop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> loop​(java.util.Queue<T> queue,
                                                                                    java.util.function.Function<T,​java.util.concurrent.CompletionStage<?>> consumer)
      • loop

        public static java.util.concurrent.CompletionStage<java.lang.Void> loop​(int start,
                                                                                int end,
                                                                                java.util.function.IntFunction<java.util.concurrent.CompletionStage<?>> consumer)
        Equivalent to:
        
         for ( int i = start; i < end; i++ ) {
           consumer.apply( i );
         }
         
      • whileLoop

        public static <T> java.util.concurrent.CompletionStage<java.lang.Void> whileLoop​(T[] array,
                                                                                         java.util.function.Function<T,​java.util.concurrent.CompletionStage<java.lang.Boolean>> consumer)
      • whileLoop

        public static java.util.concurrent.CompletionStage<java.lang.Void> whileLoop​(int start,
                                                                                     int end,
                                                                                     java.util.function.IntPredicate filter,
                                                                                     java.util.function.IntFunction<java.util.concurrent.CompletionStage<java.lang.Boolean>> consumer)
      • loop

        public static java.util.concurrent.CompletionStage<java.lang.Void> loop​(int start,
                                                                                int end,
                                                                                java.util.function.IntPredicate filter,
                                                                                java.util.function.IntFunction<java.util.concurrent.CompletionStage<?>> consumer)
        Equivalent to:
        
         for ( int i = start; i < end; i++ ) {
           if ( filter.test(i) ) {
           	consumer.apply( i );
           }
         }
         
      • whileLoop

        public static java.util.concurrent.CompletionStage<java.lang.Void> whileLoop​(java.util.function.Supplier<java.util.concurrent.CompletionStage<java.lang.Boolean>> loopSupplier)
      • whileLoop

        public static java.util.concurrent.CompletionStage<java.lang.Void> whileLoop​(java.util.function.Supplier<java.lang.Boolean> whileCondition,
                                                                                     java.util.function.Supplier<java.util.concurrent.CompletionStage<?>> loopSupplier)
      • applyToAll

        public static java.util.concurrent.CompletionStage<java.lang.Void> applyToAll​(java.util.function.Function<java.lang.Object,​java.util.concurrent.CompletionStage<?>> op,
                                                                                      java.lang.Object[] entity)