io.jooby

Interface Body

All Superinterfaces:

Iterable<ValueNode>, Value, ValueNode

All Known Implementing Classes:

ByteArrayBody, FileBody, InputStreamBody, WebSocketMessageImpl

public interface Body
extends ValueNode

HTTP body value. Allows to access HTTP body as string, byte[], stream, etc.. HTTP body can be read it only once per request. Attempt to read more than one resulted in unexpected behaviour.

Since:

2.0.0

Author:

edgar

Method Summary

Modifier and Type	Method and Description
byte[]	bytes() HTTP body as byte array.
ReadableByteChannel	channel() Body as readable channel.
static Body	empty(Context ctx) Empty body.
long	getSize() Size in bytes.
boolean	isInMemory() True if body is on memory.
static Body	of(Context ctx, byte[] bytes) Creates a HTTP body from byte array.
static Body	of(Context ctx, InputStream stream, long size) Creates a HTTP body from input stream.
static Body	of(Context ctx, Path file) Creates a HTTP body from file.
InputStream	stream() Body as input stream.
default <T> T	to(Class<T> type) Convert this value to the given type.
<T> T	to(Type type) Convert this body into the given type.
default List<String>	toList() Get list of values.
default <T> List<T>	toList(Class<T> type) Get list of the given type.
default Set<String>	toSet() Get set of values.
default String	value(Charset charset) HTTP body as string.

Methods inherited from interface io.jooby.ValueNode

get, get, iterator, resolve, resolve, resolve, resolve, size

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface io.jooby.Value

array, booleanValue, booleanValue, byteValue, byteValue, create, create, doubleValue, doubleValue, floatValue, floatValue, hash, headers, intValue, intValue, isArray, isMissing, isObject, isPresent, isSingle, longValue, longValue, missing, name, toEnum, toEnum, toMap, toMultimap, toOptional, toOptional, toSet, value, value, value, value, valueOrNull

Method Detail

value

@Nonnull
default String value(@Nonnull
                              Charset charset)

HTTP body as string.

Parameters:

charset - Charset.

Returns:

Body as string.

bytes

@Nonnull
byte[] bytes()

HTTP body as byte array.

Returns:

Body as byte array.

isInMemory

boolean isInMemory()

True if body is on memory. False, indicates body is on file system. Body larger than ServerOptions.getMaxRequestSize() will be dump to disk.

Returns:

True if body is on memory. False, indicates body is on file system.

getSize

long getSize()

Size in bytes. This is the same as Content-Length header.

Returns:

Size in bytes. This is the same as Content-Length header.

channel

@Nonnull
ReadableByteChannel channel()

Body as readable channel.

Returns:

Body as readable channel.

stream

@Nonnull
InputStream stream()

Body as input stream.

Returns:

Body as input stream.

toList

@Nonnull
default <T> List<T> toList(@Nonnull
                                    Class<T> type)

Description copied from interface: Value

Get list of the given type.

Specified by:

toList in interface Value

Type Parameters:

T - Item type.

Parameters:

type - Type to convert.

Returns:

List of items.

toList

@Nonnull
default List<String> toList()

Description copied from interface: Value

Get list of values.

Specified by:

toList in interface Value

Returns:

List of values.

toSet

@Nonnull
default Set<String> toSet()

Description copied from interface: Value

Get set of values.

Specified by:

toSet in interface Value

Returns:

set of values.

to

@Nonnull
default <T> T to(@Nonnull
                          Class<T> type)

Description copied from interface: Value

Convert this value to the given type. Support values are single-value, array-value and object-value. Object-value can be converted to a JavaBean type.

Specified by:

to in interface Value

Type Parameters:

T - Element type.

Parameters:

type - Type to convert.

Returns:

Instance of the type.

to

@Nonnull
<T> T to(@Nonnull
                  Type type)

Convert this body into the given type.

Type Parameters:

T - Generic type.

Parameters:

type - Type to use.

Returns:

Converted value.

empty

@Nonnull
static Body empty(@Nonnull
                           Context ctx)

Empty body.

Parameters:

ctx - Current context.

Returns:

Empty body.

of

@Nonnull
static Body of(@Nonnull
                        Context ctx,
                        @Nonnull
                        InputStream stream,
                        long size)

Creates a HTTP body from input stream.

Parameters:

ctx - Current context.

stream - Input stream.

size - Size in bytes or -1.

Returns:

A new body.

of

@Nonnull
static Body of(@Nonnull
                        Context ctx,
                        @Nonnull
                        byte[] bytes)

Creates a HTTP body from byte array.

Parameters:

ctx - Current context.

bytes - byte array.

Returns:

A new body.

of

@Nonnull
static Body of(@Nonnull
                        Context ctx,
                        @Nonnull
                        Path file)

Creates a HTTP body from file.

Parameters:

ctx - Current context.

file - File.

Returns:

A new body.