Package org.apache.commons.lang3
Class Streams
java.lang.Object
org.apache.commons.lang3.Streams
Deprecated.
Provides utility functions, and classes for working with the
 
java.util.stream package, or more generally, with Java 8 lambdas. More
 specifically, it attempts to address the fact that lambdas are supposed
 not to throw Exceptions, at least not checked Exceptions, AKA instances
 of Exception. This enforces the use of constructs like
 
     Consumer<java.lang.reflect.Method> consumer = m -> {
         try {
             m.invoke(o, args);
         } catch (Throwable t) {
             throw Functions.rethrow(t);
         }
    };
    stream.forEach(consumer);
 Streams.FailableStream, this can be rewritten as follows:
 
     Streams.failable(stream).forEach(m -> m.invoke(o, args));
 - 
Nested Class SummaryNested ClassesModifier and TypeClassDescriptionstatic classDeprecated.static classDeprecated.
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionstatic <O> Streams.FailableStream<O>stream(Collection<O> stream) Deprecated.Converts the givenCollectioninto aStreams.FailableStream.static <O> Streams.FailableStream<O>Deprecated.Converts the givenstreaminto aStreams.FailableStream.static <O> Collector<O,?, O[]> Deprecated.Returns aCollectorthat accumulates the input elements into a new array.
- 
Constructor Details- 
Streamspublic Streams()Deprecated.Constructs a new instance.
 
- 
- 
Method Details- 
streamDeprecated.Converts the givenCollectioninto aStreams.FailableStream. This is basically a simplified, reduced version of theStreamclass, with the same underlying element stream, except that failable objects, likeFunctions.FailablePredicate,Functions.FailableFunction, orFunctions.FailableConsumermay be applied, instead ofPredicate,Function, orConsumer. The idea is to rewrite a code snippet like this:
 as follows:final List<O> list; final Method m; final Function<O,String> mapper = (o) -> { try { return (String) m.invoke(o); } catch (Throwable t) { throw Functions.rethrow(t); } }; final List<String> strList = list.stream() .map(mapper).collect(Collectors.toList());
 While the second version may not be quite as efficient (because it depends on the creation of additional, intermediate objects, of type FailableStream), it is much more concise, and readable, and meets the spirit of Lambdas better than the first version.final List<O> list; final Method m; final List<String> strList = Functions.stream(list.stream()) .map((o) -> (String) m.invoke(o)).collect(Collectors.toList());- Type Parameters:
- O- The streams element type.
- Parameters:
- stream- The stream, which is being converted.
- Returns:
- The Streams.FailableStream, which has been created by converting the stream.
 
- 
streamDeprecated.Converts the givenstreaminto aStreams.FailableStream. This is basically a simplified, reduced version of theStreamclass, with the same underlying element stream, except that failable objects, likeFunctions.FailablePredicate,Functions.FailableFunction, orFunctions.FailableConsumermay be applied, instead ofPredicate,Function, orConsumer. The idea is to rewrite a code snippet like this:
 as follows:final List<O> list; final Method m; final Function<O,String> mapper = (o) -> { try { return (String) m.invoke(o); } catch (Throwable t) { throw Functions.rethrow(t); } }; final List<String> strList = list.stream() .map(mapper).collect(Collectors.toList());
 While the second version may not be quite as efficient (because it depends on the creation of additional, intermediate objects, of type FailableStream), it is much more concise, and readable, and meets the spirit of Lambdas better than the first version.final List<O> list; final Method m; final List<String> strList = Functions.stream(list.stream()) .map((o) -> (String) m.invoke(o)).collect(Collectors.toList());- Type Parameters:
- O- The streams element type.
- Parameters:
- stream- The stream, which is being converted.
- Returns:
- The Streams.FailableStream, which has been created by converting the stream.
 
- 
toArrayDeprecated.Returns aCollectorthat accumulates the input elements into a new array.- Type Parameters:
- O- the type of the input elements
- Parameters:
- pElementType- Type of an element in the array.
- Returns:
- a Collectorwhich collects all the input elements into an array, in encounter order
 
 
- 
Streams.