ProducerUtil (de-unkrig-commons 1.1.4)

java.lang.Object
- de.unkrig.commons.lang.protocol.ProducerUtil

public final class ProducerUtil
extends java.lang.Object

Various Producer-related utility methods.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static <T> Producer<T>`	`alternate(T first, T second)`
`static <T> Producer<T>`	`asProducer(ProducerWhichThrows<? extends T,? extends java.lang.RuntimeException> source)` Converts the `source` into a `Producer<T>`.
`static <T,EX extends java.lang.Throwable> ProducerWhichThrows<T,EX>`	`asProducerWhichThrows(Producer<? extends T> source)` Converts the `source` into a `ProducerWhichThrows<T, EX>`.
`static <T> Producer<T>`	`compress(Producer<? extends T> delegate, Predicate<? super T> compressable, T compressed)` Discards the elements that the `delegate` produces while they are `compressable`.
`static <T> Producer<T>`	`concat(Producer<? extends T> delegate1, Producer<? extends T> delegate2)`
`static <T> Producer<T>`	`constantProducer(T constant)`
`static Producer<java.lang.Boolean>`	`every(long interval)` Returns a `Producer<Boolean>` who's first evaluation result is `true`, and each following result is `true` iff the last `true` result was returned at least the given `interval` milliseconds ago.
`static <T> Producer<T>`	`fromArray(T[] delegate)` Produces the elements of the `delegate` array, in ascending index order, and after that an infinite sequence of `null`s.
`static <T> Producer<T>`	`fromArray(T[] delegate, int from, int to)` Produces the elements `from` ...
`static <T> Producer<T>`	`fromCollection(java.util.Collection<T> delegate)` Produces the elements of the `delegate` collection, in its iteration order, or `null` iff the collection is empty.
`static <T> Producer<T>`	`fromElements(T... elements)`
`static <T> Producer<T>`	`fromIndexTransformer(Transformer<? super java.lang.Integer,T> indexTransformer)` Produces objects based on the number of preceding invocations, i.e. the `indexTransformer` is invoked with subjects '0', '1', '2', ...
`static <T,EX extends java.lang.Exception> ProducerWhichThrows<T,EX>`	`fromIndexTransformer(TransformerWhichThrows<? super java.lang.Integer,T,EX> indexTransformer)` Produces objects based on the number of preceding invocations, i.e. the `indexTransformer` is invoked with subjects '0', '1', '2', ...
`static <T> Producer<T>`	`fromIterator(java.util.Iterator<T> iterator)` Produces the products of the `iterator`, or `null` iff the `iterator` has no more elements.
`static Producer<java.lang.Integer>`	`increasing()`
`static Producer<java.lang.Byte>`	`randomByteProducer(long seed)`
`static <T,ST> Producer<T>`	`sparingProducer(Producer<? extends T> delegate, Predicate<? super ST> condition, ST subject)` The returned `Producer` calls the `delegate` iff the `condition` returns `true`, otherwise it returns the previous product of the `delegate`, or `null` iff the delegate has not yet been called.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - sparingProducer
```
public static <T,ST> Producer<T> sparingProducer(Producer<? extends T> delegate,
                                                 Predicate<? super ST> condition,
                                                 ST subject)
```
    The returned Producer calls the delegate iff the condition returns true, otherwise it returns the previous product of the delegate, or null iff the delegate has not yet been called.
    
    Parameters:
    
    subject - The subject argument for the condition
  - every
```
public static Producer<java.lang.Boolean> every(long interval)
```
    Returns a Producer<Boolean> who's first evaluation result is true, and each following result is true iff the last true result was returned at least the given interval milliseconds ago. In other words, the interval between two returned true values is never shorter than interval milliseconds.
  - asProducerWhichThrows
```
public static <T,EX extends java.lang.Throwable> ProducerWhichThrows<T,EX> asProducerWhichThrows(Producer<? extends T> source)
```
    Converts the source into a ProducerWhichThrows<T, EX>.
    This is always possible, because the source is only allowed to throw RuntimeExceptions.
    
    Notice Producer<T> extends ProducerWhichThrows<T, RuntimeException>, thus you don't need this method to convert to ProducerWhichThrows<T, RuntimeException>.
    
    Type Parameters:
    
    T - The product type
    
    EX - The target producer's exception
  - asProducer
```
public static <T> Producer<T> asProducer(ProducerWhichThrows<? extends T,? extends java.lang.RuntimeException> source)
```
    Converts the source into a Producer<T>.
    This is always possible, because both are only allowed to throw RuntimeExceptions.
    
    Type Parameters:
    
    T - The product type
  - fromElements
```
public static <T> Producer<T> fromElements(T... elements)
```
    Returns:
    
    A Producer that produced the given elements
  - fromCollection
```
public static <T> Producer<T> fromCollection(java.util.Collection<T> delegate)
```
    Produces the elements of the delegate collection, in its iteration order, or null iff the collection is empty. The elements are removed from the collection as they are produced.
  - fromArray
```
public static <T> Producer<T> fromArray(T[] delegate)
```
    Produces the elements of the delegate array, in ascending index order, and after that an infinite sequence of nulls.
  - fromArray
```
public static <T> Producer<T> fromArray(T[] delegate,
                                        int from,
                                        int to)
```
    Produces the elements from ... to-1 of the delegate array, and after that an infinite sequence of nulls.
    
    Throws:
    
    java.lang.IllegalArgumentException - from is less than 0
    
    java.lang.IllegalArgumentException - to is less than from
    
    java.lang.IllegalArgumentException - to is greater than delegate.length
  - fromIterator
```
public static <T> Producer<T> fromIterator(java.util.Iterator<T> iterator)
```
    Produces the products of the iterator, or null iff the iterator has no more elements.
  - fromIndexTransformer
```
public static <T> Producer<T> fromIndexTransformer(Transformer<? super java.lang.Integer,T> indexTransformer)
```
    Produces objects based on the number of preceding invocations, i.e. the indexTransformer is invoked with subjects '0', '1', '2', ...
  - fromIndexTransformer
```
public static <T,EX extends java.lang.Exception> ProducerWhichThrows<T,EX> fromIndexTransformer(TransformerWhichThrows<? super java.lang.Integer,T,EX> indexTransformer)
```
    Produces objects based on the number of preceding invocations, i.e. the indexTransformer is invoked with subjects '0', '1', '2', ...
  - randomByteProducer
```
public static Producer<java.lang.Byte> randomByteProducer(long seed)
```
    Returns:
    
    A producer which produces bytes through new java.util.Random(seed).nextInt(0x100)
  - constantProducer
```
public static <T> Producer<T> constantProducer(T constant)
```
    Returns:
    
    A producer which always produces the constant
  - compress
```
public static <T> Producer<T> compress(Producer<? extends T> delegate,
                                       Predicate<? super T> compressable,
                                       T compressed)
```
    Discards the elements that the delegate produces while they are compressable. After that, it produces the elements that the delegate produces and are not compressable, and reduces sequences of one or more compressable elements to compressed. line "".
  - alternate
```
public static <T> Producer<T> alternate(T first,
                                        T second)
```
    Returns:
    
    A Producer that produces first, second, first, second, ...
  - increasing
```
public static Producer<java.lang.Integer> increasing()
```
    Returns:
    
    A Producer that produces 0, 1, 2, 3, ...
  - concat
```
public static <T> Producer<T> concat(Producer<? extends T> delegate1,
                                     Producer<? extends T> delegate2)
```
    Returns:
    
    A producer that produces the products of delegate1, and, when that produces null, the products of delegate2.

Class ProducerUtil

Method Summary

Methods inherited from class java.lang.Object

Method Detail

sparingProducer

every

asProducerWhichThrows

asProducer

fromElements

fromCollection

fromArray

fromArray

fromIterator

fromIndexTransformer

fromIndexTransformer

randomByteProducer

constantProducer

compress

alternate

increasing

concat