Package io.servicetalk.http.api

Interface HttpSerializer<T>

Type Parameters:

T - The type of objects to serialize.

public interface HttpSerializer<T>

A factory to address serialization concerns for HTTP request/response payload bodies.

Method Summary

Modifier and Type	Method	Description
Publisher<Buffer>	serialize(HttpHeaders headers, Publisher<T> value, BufferAllocator allocator)	Serialize a Publisher of type HttpSerializer into a Publisher of type Buffer.
BlockingIterable<Buffer>	serialize(HttpHeaders headers, BlockingIterable<T> value, BufferAllocator allocator)	Serialize an BlockingIterable of type HttpSerializer into an BlockingIterable of type Buffer.
HttpPayloadWriter<T>	serialize(HttpHeaders headers, HttpPayloadWriter<Buffer> payloadWriter, BufferAllocator allocator)	Returns an HttpPayloadWriter of type HttpSerializer which serializes each written object into a Buffer.
Buffer	serialize(HttpHeaders headers, T value, BufferAllocator allocator)	Serialize an object of type HttpSerializer into a Buffer.

Method Detail

serialize

Buffer serialize(HttpHeaders headers,
                 T value,
                 BufferAllocator allocator)

Serialize an object of type HttpSerializer into a Buffer. If necessary the HttpHeaders should be updated to indicate the content-type.

Parameters:

headers - The HttpHeaders associated with the serialization operation.

value - The object to serialize.

allocator - The BufferAllocator used to create the returned Buffer.

Returns:

The result of the serialization operation.

serialize

BlockingIterable<Buffer> serialize(HttpHeaders headers,
                                   BlockingIterable<T> value,
                                   BufferAllocator allocator)

Serialize an BlockingIterable of type HttpSerializer into an BlockingIterable of type Buffer. If necessary the HttpHeaders should be updated to indicate the content-type.

Parameters:

headers - The HttpHeaders associated with the serialization operation.

value - The objects to serialize.

allocator - The BufferAllocator used to create the resulting Buffers.

Returns:

The result of the serialization operation.

serialize

Publisher<Buffer> serialize(HttpHeaders headers,
                            Publisher<T> value,
                            BufferAllocator allocator)

Serialize a Publisher of type HttpSerializer into a Publisher of type Buffer. If necessary the HttpHeaders should be updated to indicate the content-type.

Parameters:

headers - The HttpHeaders associated with the serialization operation.

value - The objects to serialize.

allocator - The BufferAllocator used to create the resulting Buffers.

Returns:

The result of the serialization operation.

serialize

HttpPayloadWriter<T> serialize(HttpHeaders headers,
                               HttpPayloadWriter<Buffer> payloadWriter,
                               BufferAllocator allocator)

Returns an HttpPayloadWriter of type HttpSerializer which serializes each written object into a Buffer. If necessary the HttpHeaders should be updated to indicate the content-type.

Parameters:

headers - The HttpHeaders associated with the serialization operation.

payloadWriter - The HttpPayloadWriter which writes serialized Buffers.

allocator - The BufferAllocator used to create the resulting Buffers.

Returns:

The HttpPayloadWriter of type HttpSerializer with embedded serialization into a Buffer.