Module methanol

Package com.github.mizosoft.methanol

Class AdapterCodec

java.lang.Object

com.github.mizosoft.methanol.AdapterCodec

public final class AdapterCodec
extends Object

A group of adapters, typically targeting different mapping formats, that facilitates creating HttpRequest.BodyPublisher, HttpResponse.BodyHandler and HttpResponse.BodySubscriber implementations based on these adapters. The correct adapter is selected based on the object type and a MediaType specifying the desired format.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	AdapterCodec.Builder	A builder of AdapterCodec.

Method Summary

Modifier and Type	Method	Description
List<BodyAdapter.Decoder>	decoders()	Returns the list of decoders in this codec.
<T> HttpResponse.BodyHandler<Supplier<T>>	deferredHandlerOf(TypeRef<T> objectType)	Returns a BodyHandler that lazily decodes the response body into an object of the given type.
<T> HttpResponse.BodySubscriber<Supplier<T>>	deferredSubscriberOf(TypeRef<T> objectType, MediaType mediaType)	Returns a BodySubscriber that lazily decodes the response body into an object of the given type.
List<BodyAdapter.Encoder>	encoders()	Returns the list of encoders in this codec.
<T> HttpResponse.BodyHandler<T>	handlerOf(TypeRef<T> objectType)	Returns a BodyHandler that decodes the response body into an object of the given type.
static AdapterCodec	installed()
static AdapterCodec.Builder	newBuilder()	Returns a new AdapterCodec.Builder.
HttpRequest.BodyPublisher	publisherOf(Object object, MediaType mediaType)	Returns a BodyPublisher that encodes the given object into a request body.
<T> HttpResponse.BodySubscriber<T>	subscriberOf(TypeRef<T> objectType, MediaType mediaType)	Returns a BodySubscriber that decodes the response body into an object of the given type.

Methods inherited from class java.lang.Object

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

Method Details

encoders

public List<BodyAdapter.Encoder> encoders()

Returns the list of encoders in this codec.

decoders

public List<BodyAdapter.Decoder> decoders()

Returns the list of decoders in this codec.

publisherOf

public HttpRequest.BodyPublisher publisherOf(Object object,
 MediaType mediaType)

Returns a BodyPublisher that encodes the given object into a request body.

Throws:

UnsupportedOperationException - if no encoder supporting the given object's runtime type or the given media type is found

subscriberOf

public <T> HttpResponse.BodySubscriber<T> subscriberOf(TypeRef<T> objectType,
 MediaType mediaType)

Returns a BodySubscriber that decodes the response body into an object of the given type.

Throws:

UnsupportedOperationException - if no decoder supporting the given object type or media type is found

deferredSubscriberOf

public <T> HttpResponse.BodySubscriber<Supplier<T>> deferredSubscriberOf(TypeRef<T> objectType,
 MediaType mediaType)

Returns a BodySubscriber that lazily decodes the response body into an object of the given type.

Throws:

UnsupportedOperationException - if no decoder supporting the given object type or media type is found

handlerOf

public <T> HttpResponse.BodyHandler<T> handlerOf(TypeRef<T> objectType)

Returns a BodyHandler that decodes the response body into an object of the given type.

Throws:

UnsupportedOperationException - if no decoder supporting the given object type is found

deferredHandlerOf

public <T> HttpResponse.BodyHandler<Supplier<T>> deferredHandlerOf(TypeRef<T> objectType)

Returns a BodyHandler that lazily decodes the response body into an object of the given type.

Throws:

UnsupportedOperationException - if no decoder supporting the given object type is found

installed

public static AdapterCodec installed()

newBuilder

public static AdapterCodec.Builder newBuilder()

Returns a new AdapterCodec.Builder.