Package org.refcodes.net

Interface MediaTypeFactory

All Superinterfaces:

Marshalable<String>, MediaTypeAccessor, Unmarshalable<String>

All Known Implementing Classes:

ApplicationFormFactory, ApplicationJsonFactory, ApplicationXmlFactory, ApplicationYamlFactory, TextPlainFactory, TextXmlFactory

public interface MediaTypeFactory
extends Unmarshalable<String>, Marshalable<String>, MediaTypeAccessor

The MediaTypeFactory creates instances from an HTTP body and creates an HTTP body from given instances according to the MediaType (as of MediaTypeAccessor.getMediaType()) for which the MediaTypeFactory is responsible.

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.net.MediaTypeAccessor

MediaTypeAccessor.MediaTypeBuilder<B extends MediaTypeAccessor.MediaTypeBuilder<B>>, MediaTypeAccessor.MediaTypeMutator, MediaTypeAccessor.MediaTypeProperty

Method Summary

Modifier and Type	Method	Description
default Object	fromMarshaled(InputStream aContentInputStream, Class<?>... aTypes)	Same as Unmarshalable.toUnmarshaled(Object, Class...) passing an InputStream instead of a String.
default <T> T	fromMarshaled(InputStream aContentInputStream, Class<T> aType)	Same as Unmarshalable.toUnmarshaled(Object, Class) passing an InputStream instead of a String.
default <T> T	fromMarshaled(InputStream aContentInputStream, Class<T> aType, Map<String,String> aProperties)	Same as Unmarshalable.toUnmarshaled(Object, Class, Map) passing an InputStream instead of a String.
default Object	fromMarshaled(InputStream aContentInputStream, Map<String,String> aProperties, Class<?>... aTypes)	Same as Unmarshalable.toUnmarshaled(Object, Map, Class...) passing an InputStream instead of a String.
default <SRC> InputStream	fromUnmarshaled(SRC aContext)	Same as Marshalable.toMarshaled(Object) returning an InputStream instead of a String.
default <SRC> InputStream	fromUnmarshaled(SRC aContext, Map<String,String> aProperties)	Same as Marshalable.toMarshaled(Object, Map) returning an InputStream instead of a String.

Methods inherited from interface org.refcodes.net.Marshalable

toMarshaled, toMarshaled

Methods inherited from interface org.refcodes.net.MediaTypeAccessor

getMediaType

Methods inherited from interface org.refcodes.net.Unmarshalable

toUnmarshaled, toUnmarshaled, toUnmarshaled, toUnmarshaled

Method Detail

fromMarshaled

default <T> T fromMarshaled(InputStream aContentInputStream,
                            Class<T> aType)
                     throws org.refcodes.exception.UnmarshalException

Same as Unmarshalable.toUnmarshaled(Object, Class) passing an InputStream instead of a String.

Type Parameters:

T - the generic type

Parameters:

aContentInputStream - the content input stream

aType - The type identifying the instance to be created / retrieved.

Returns:

the t

Throws:

org.refcodes.exception.UnmarshalException - the unmarshal exception

fromMarshaled

default Object fromMarshaled(InputStream aContentInputStream,
                             Class<?>... aTypes)
                      throws org.refcodes.exception.UnmarshalException

Same as Unmarshalable.toUnmarshaled(Object, Class...) passing an InputStream instead of a String.

Parameters:

aContentInputStream - the content input stream

aTypes - The types identifying or included by the instance to be created / retrieved.

Returns:

the object

Throws:

org.refcodes.exception.UnmarshalException - the unmarshal exception

fromMarshaled

default Object fromMarshaled(InputStream aContentInputStream,
                             Map<String,String> aProperties,
                             Class<?>... aTypes)
                      throws org.refcodes.exception.UnmarshalException

Same as Unmarshalable.toUnmarshaled(Object, Map, Class...) passing an InputStream instead of a String.

Parameters:

aContentInputStream - the content input stream

aProperties - the properties

aTypes - The types identifying or included by the instance to be created / retrieved.

Returns:

the object

Throws:

org.refcodes.exception.UnmarshalException - the unmarshal exception

fromMarshaled

default <T> T fromMarshaled(InputStream aContentInputStream,
                            Class<T> aType,
                            Map<String,String> aProperties)
                     throws org.refcodes.exception.UnmarshalException

Same as Unmarshalable.toUnmarshaled(Object, Class, Map) passing an InputStream instead of a String.

Type Parameters:

T - the generic type

Parameters:

aContentInputStream - the content input stream

aType - The type identifying the instance to be created / retrieved.

aProperties - the properties

Returns:

the type from the marshaled data

Throws:

org.refcodes.exception.UnmarshalException - the unmarshal exception

fromUnmarshaled

default <SRC> InputStream fromUnmarshaled(SRC aContext)
                                   throws org.refcodes.exception.MarshalException

Same as Marshalable.toMarshaled(Object) returning an InputStream instead of a String.

Type Parameters:

SRC - the generic type

Parameters:

aContext - the context

Returns:

the input stream

Throws:

org.refcodes.exception.MarshalException - the marshal exception

fromUnmarshaled

default <SRC> InputStream fromUnmarshaled(SRC aContext,
                                          Map<String,String> aProperties)
                                   throws org.refcodes.exception.MarshalException

Same as Marshalable.toMarshaled(Object, Map) returning an InputStream instead of a String.

Type Parameters:

SRC - the generic type

Parameters:

aContext - the context

aProperties - the properties

Returns:

the input stream

Throws:

org.refcodes.exception.MarshalException - the marshal exception