Module io.inverno.mod.http.server

Package io.inverno.mod.http.server

Interface RequestBody

All Known Subinterfaces:

WebRequestBody

public interface RequestBody

Represents the payload body of a client request in a server exchange.

The request body basically provides multiple ways to consume the request payload depending on the request content type.

Since:

1.0

Author:

Jeremy Kuhn

See Also:

• Request

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	RequestBody.Multipart<A extends Part>	A multipart/form-data consumer as defined by RFC 7578.
static interface	RequestBody.UrlEncoded	An application/x-www-form-urlencoded data consumer as defined by application/x-www-form-urlencoded.

Method Summary

Modifier and Type	Method	Description
RequestBody.Multipart<? extends Part>	multipart()	Returns a multipart/form-data payload consumer.
InboundData<ByteBuf>	raw()	Returns a raw payload consumer.
InboundData<CharSequence>	string()	Returns a string payload consumer.
RequestBody	transform(Function<Publisher<ByteBuf>,Publisher<ByteBuf>> transformer)	Transforms the payload publisher.
RequestBody.UrlEncoded	urlEncoded()	Returns an application/x-www-form-urlencoded payload consumer.

Method Details

transform

RequestBody transform(Function<Publisher<ByteBuf>,Publisher<ByteBuf>> transformer)
               throws IllegalStateException

Transforms the payload publisher.

This can be used in an exchange interceptor in order to decorate the request data publisher.

Parameters:

transformer - a request payload publisher transformer

Returns:

the request body

Throws:

IllegalStateException - if the request body data publisher has been subscribed

raw

InboundData<ByteBuf> raw()
                  throws IllegalStateException

Returns a raw payload consumer.

Returns:

the raw data

Throws:

IllegalStateException - if the payload has already been consumed using another decoder

string

InboundData<CharSequence> string()
                          throws IllegalStateException

Returns a string payload consumer.

Returns:

the string data

Throws:

IllegalStateException - if the payload has already been consumed using another decoder

multipart

RequestBody.Multipart<? extends Part> multipart()
                                         throws IllegalStateException

Returns a multipart/form-data payload consumer.

Returns:

body a multipart/form-data payload consumer

Throws:

IllegalStateException - if the payload has already been consumed using another decoder

urlEncoded

RequestBody.UrlEncoded urlEncoded()
                           throws IllegalStateException

Returns an application/x-www-form-urlencoded payload consumer.

Returns:

body an application/x-www-form-urlencoded payload consumer

Throws:

IllegalStateException - if the payload has already been consumed using another decoder