io.reactivex.netty.util

Class CollectBytes

java.lang.Object

io.reactivex.netty.util.CollectBytes

All Implemented Interfaces:

rx.functions.Func1<rx.Observable<io.netty.buffer.ByteBuf>,rx.Observable<io.netty.buffer.ByteBuf>>, rx.functions.Function, rx.Observable.Transformer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>

public class CollectBytes
extends java.lang.Object
implements rx.Observable.Transformer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>

An Observable.Transformer to collect a stream of ByteBufs into a single ByteBuf. On success the receiver must release the returned ByteBuf. On failure this will release all received ByteBufs.

This Transformer should not be used with ContentSource.autoRelease() as this will release the underlying collected ByteBufs before the collection is complete.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CollectBytes.TooMuchDataException

Method Summary

Modifier and Type	Method and Description
static CollectBytes	all() Collect all emitted ByteBufs into a single ByteBuf.
rx.Observable<io.netty.buffer.ByteBuf>	call(rx.Observable<io.netty.buffer.ByteBuf> upstream)
static CollectBytes	upTo(int maxBytes) Collect all emitted ByteBufs into a single ByteBuf until maxBytes have been collected.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

all

public static CollectBytes all()

Collect all emitted ByteBufs into a single ByteBuf. This will return at most Integer.MAX_VALUE bytes. This is the upper limit of ByteBuf.readableBytes(). If more than Integer#MAX_VALUE bytes are received a CollectBytes.TooMuchDataException will be emitted. Throwable.getCause() will contain an OnErrorThrowable.OnNextValue with the bytes accumulated before the exception was thrown.

upTo

public static CollectBytes upTo(int maxBytes)

Collect all emitted ByteBufs into a single ByteBuf until maxBytes have been collected. If more than maxBytes are received this will unsubscribe from the upstream Observable and will emit a CollectBytes.TooMuchDataException. Throwable.getCause() will contain an OnErrorThrowable.OnNextValue with the bytes accumulated before the exception was thrown.

Parameters:

maxBytes - the maximum number of bytes to read

Throws:

java.lang.IllegalArgumentException - when maxBytes is negative

call

public rx.Observable<io.netty.buffer.ByteBuf> call(rx.Observable<io.netty.buffer.ByteBuf> upstream)

Specified by:

call in interface rx.functions.Func1<rx.Observable<io.netty.buffer.ByteBuf>,rx.Observable<io.netty.buffer.ByteBuf>>