Transformable (cyclops-react 2.0.0-MI1 API)

Type Parameters:

T - Data type of element(s) stored in this Transformable

All Known Subinterfaces:

AnyM<W,T>, AnyMSeq<W,T>, AnyMValue<W,T>, CollectionX<T>, DequeX<T>, Either<ST,PT>, Either3<LT1,LT2,RT>, Either4<LT1,LT2,LT3,RT>, Either5<LT1,LT2,LT3,LT4,RT>, Eval<T>, ExtendedTraversable<T>, FilterableTransformable<T>, FluentCollectionX<T>, FluentSequenceX<T>, FoldableTransformerSeq<W,T>, FoldableTraversable<T>, FutureStream<U>, Ior<ST,PT>, LazyFluentCollectionX<T>, ListX<T>, MapX<K,V>, Maybe<T>, MonadicValue<T>, MutableCollectionX<T>, MutableSequenceX<T>, PBagX<T>, PersistentCollectionX<T>, PMapX<K,V>, POrderedSetX<T>, PQueueX<T>, PSetX<T>, PStackX<T>, PVectorX<T>, QueueX<T>, ReactiveSeq<T>, Reader<T,R>, SetX<T>, SortedSetX<T>, Streamable<T>, TransformerSeq<W,T>, Traversable<T>, Try<T,X>, Xor<ST,PT>, Zippable<T>

All Known Implementing Classes:

AbstractLazyMutableCollection, AbstractLazyPersistentCollection, CollectionXImpl, Either.Lazy, Either.Left, Either.Right, Either3.Lazy, Either3.Left1, Either3.Left2, Either3.Right, Either4.Lazy, Either4.Left1, Either4.Left2, Either4.Left3, Either4.Right, Either5.Lazy, Either5.Left1, Either5.Left2, Either5.Left3, Either5.Left4, Either5.Right, Eval.Module.Always, Eval.Module.Later, FluentFunctions.FluentFunction, Future, FutureT, Ior.Both, Ior.Primary, Ior.Secondary, LazyDequeX, LazyImmutable, LazyListX, LazyPBagX, LazyPOrderedSetX, LazyPQueueX, LazyPSetX, LazyPStackX, LazyPVectorX, LazyQueueX, LazySetX, LazySortedSetX, ListT, MapXImpl, Maybe.Just, Maybe.Lazy, Maybe.Nothing, PMapXImpl, Try.Failure, Try.Success, ValueTransformer, Xor.Primary, Xor.Secondary

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
```
@FunctionalInterface
public interface Transformable<T>
```
An interface that represents a type that can transform a value from one type to another

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default <U> Transformable<U>`	`cast(java.lang.Class<? extends U> type)` Cast all elements in a stream to a given type, possibly throwing a `ClassCastException`.
`<R> Transformable<R>`	`map(java.util.function.Function<? super T,? extends R> fn)` Transform this functor using the supplied transformation function
`default Transformable<T>`	`peek(java.util.function.Consumer<? super T> c)` Peek at the current value of this Transformable, without transforming it
`default <R> Transformable<R>`	`retry(java.util.function.Function<? super T,? extends R> fn)` Retry a transformation if it fails.
`default <R> Transformable<R>`	`retry(java.util.function.Function<? super T,? extends R> fn, int retries, long delay, java.util.concurrent.TimeUnit timeUnit)` Retry a transformation if it fails.
`default <R> Transformable<R>`	`trampoline(java.util.function.Function<? super T,? extends Trampoline<? extends R>> mapper)` Performs a map operation that can call a recursive method without running out of stack space

Method Detail

cast
```
default <U> Transformable<U> cast(java.lang.Class<? extends U> type)
```
Cast all elements in a stream to a given type, possibly throwing a ClassCastException. // ClassCastException ReactiveSeq.of(1, "a", 2, "b", 3).cast(Integer.class)

map

<R> Transformable<R> map(java.util.function.Function<? super T,? extends R> fn)

Transform this functor using the supplied transformation function

  
  
  
    of(1,2,3).map(i->i*2)
    
    //[2,4,6]

Parameters:: fn - Transformation function
Returns:: Transformed Transformable

peek
```
default Transformable<T> peek(java.util.function.Consumer<? super T> c)
```
Peek at the current value of this Transformable, without transforming it
```
  
  
  
    of(1,2,3).map(System.out::println)
    
    1
    2
    3
  
 
 
```
Parameters:

c - Consumer that recieves each element from this Transformable

Returns:

Transformable that will peek at each value

trampoline

default <R> Transformable<R> trampoline(java.util.function.Function<? super T,? extends Trampoline<? extends R>> mapper)

Performs a map operation that can call a recursive method without running out of stack space

 
 ReactiveSeq.of(10,20,30,40)
    			 .trampoline(i-> fibonacci(i))
    			 .forEach(System.out::println); 
    			 
    	Trampoline<Long> fibonacci(int i){
    		return fibonacci(i,1,0);
    	}
    	Trampoline<Long> fibonacci(int n, long a, long b) {
        	return n == 0 ? Trampoline.done(b) : Trampoline.more( ()->fibonacci(n-1, a+b, a));
    	}		 
    			 
 55
    	6765
    	832040
    	102334155
 
 
 ReactiveSeq.of(10_000,200_000,3_000_000,40_000_000)
    			 .trampoline(i-> fibonacci(i))
    			 .forEach(System.out::println);
    			 
    			 
 completes successfully

Parameters:: mapper - TCO Transformation function
Returns:: Transformable transformed by the supplied transformation function

retry

default <R> Transformable<R> retry(java.util.function.Function<? super T,? extends R> fn)

Retry a transformation if it fails. Default settings are to retry up to 7 times, with an doubling backoff period starting @ 2 seconds delay before retry.

 
 given(serviceMock.apply(anyInt())).willThrow(
 				new RuntimeException(new SocketException("First")),
 				new RuntimeException(new IOException("Second"))).willReturn(
 				"42");


 		String result = ReactiveSeq.of( 1,  2, 3)
 				.retry(serviceMock)
 				.firstValue();

 		//result = 42

Parameters:: fn - Function to retry if fails

retry

default <R> Transformable<R> retry(java.util.function.Function<? super T,? extends R> fn,
                                   int retries,
                                   long delay,
                                   java.util.concurrent.TimeUnit timeUnit)

Retry a transformation if it fails. Retries up to retries times, with an doubling backoff period starting @ delay TimeUnits delay before retry.

 
 given(serviceMock.apply(anyInt())).willThrow(
 				new RuntimeException(new SocketException("First")),
 				new RuntimeException(new IOException("Second"))).willReturn(
 				"42");


 		String result = ReactiveSeq.of( 1,  2, 3)
 				.retry(serviceMock, 7, 2, TimeUnit.SECONDS)
 				.firstValue();

 		//result = 42

Parameters:: fn - Function to retry if fails; retries - Number of retries; delay - Delay in TimeUnits; timeUnit - TimeUnit to use for delay

Interface Transformable<T>

Method Summary

Method Detail

cast

map

peek

trampoline

retry

retry