Package com.linecorp.armeria.common

Interface HttpMessage

All Superinterfaces:

org.reactivestreams.Publisher<HttpObject>, StreamMessage<HttpObject>

All Known Subinterfaces:

HttpRequest, HttpRequestWriter, HttpResponse, HttpResponseWriter

All Known Implementing Classes:

FilteredHttpRequest, FilteredHttpResponse

public interface HttpMessage
extends StreamMessage<HttpObject>

A streamed HTTP/2 message.

Method Summary

Modifier and Type	Method	Description
default <T> StreamMessage<T>	decode(HttpDecoder<T> decoder)	Creates a decoded StreamMessage which is decoded from a stream of HttpObjects using the specified HttpDecoder.
default <T> StreamMessage<T>	decode(HttpDecoder<T> decoder, ByteBufAllocator alloc)	Creates a decoded StreamMessage which is decoded from a stream of HttpObjects using the specified HttpDecoder and ByteBufAllocator.
<T> StreamMessage<T>	decode(HttpDecoder<T> decoder, ByteBufAllocator alloc, Function<? super HttpData,? extends ByteBuf> byteBufConverter)	Creates a decoded StreamMessage which is decoded from a stream of HttpObjects using the specified HttpDecoder and ByteBufAllocator and byteBufConverter.
StreamMessageDuplicator<HttpObject>	toDuplicator(long maxContentLength)	Returns a new StreamMessageDuplicator that duplicates this HttpMessage into one or more HttpMessages, which publish the same elements.
StreamMessageDuplicator<HttpObject>	toDuplicator(EventExecutor executor, long maxContentLength)	Returns a new StreamMessageDuplicator that duplicates this HttpMessage into one or more HttpMessages, which publish the same elements.

Methods inherited from interface com.linecorp.armeria.common.stream.StreamMessage

abort, abort, collect, collect, collect, defaultSubscriberExecutor, demand, filter, isComplete, isEmpty, isOpen, map, subscribe, subscribe, subscribe, subscribe, toDuplicator, toDuplicator, whenComplete

Method Details

toDuplicator

StreamMessageDuplicator<HttpObject> toDuplicator(long maxContentLength)

Returns a new StreamMessageDuplicator that duplicates this HttpMessage into one or more HttpMessages, which publish the same elements. Note that you cannot subscribe to this HttpMessage anymore after you call this method. To subscribe, call StreamMessageDuplicator.duplicate() from the returned StreamMessageDuplicator.

Parameters:

maxContentLength - the maximum content length that the duplicator can hold in its buffer. ContentTooLargeException is raised if the length of the buffered HttpData is greater than this value.

toDuplicator

StreamMessageDuplicator<HttpObject> toDuplicator(EventExecutor executor,
long maxContentLength)

Returns a new StreamMessageDuplicator that duplicates this HttpMessage into one or more HttpMessages, which publish the same elements. Note that you cannot subscribe to this HttpMessage anymore after you call this method. To subscribe, call StreamMessageDuplicator.duplicate() from the returned StreamMessageDuplicator.

Parameters:

executor - the executor to duplicate

maxContentLength - the maximum content length that the duplicator can hold in its buffer. ContentTooLargeException is raised if the length of the buffered HttpData is greater than this value.

decode

default <T> StreamMessage<T> decode(HttpDecoder<T> decoder)

Creates a decoded StreamMessage which is decoded from a stream of HttpObjects using the specified HttpDecoder.

decode

default <T> StreamMessage<T> decode(HttpDecoder<T> decoder,
ByteBufAllocator alloc)

Creates a decoded StreamMessage which is decoded from a stream of HttpObjects using the specified HttpDecoder and ByteBufAllocator.

decode

<T> StreamMessage<T> decode(HttpDecoder<T> decoder,
ByteBufAllocator alloc,
Function<? super HttpData,? extends ByteBuf> byteBufConverter)

Creates a decoded StreamMessage which is decoded from a stream of HttpObjects using the specified HttpDecoder and ByteBufAllocator and byteBufConverter.