Package org.refcodes.net

Class ApplicationJsonFactory

java.lang.Object

org.refcodes.net.ApplicationJsonFactory

All Implemented Interfaces:

Marshalable<String>, MediaTypeAccessor, MediaTypeFactory, Unmarshalable<String>

Direct Known Subclasses:

ApplicationXmlFactory

public class ApplicationJsonFactory
extends Object
implements MediaTypeFactory

Implements the MediaTypeFactory for Media-Type "application/json" ( MediaType.APPLICATION_JSON). CAUTION: This implementation uses field resolution instead of getter/setter property resolution as of the used marshaling API.

Nested Class Summary

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

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

Constructor Summary

Constructors

Constructor	Description
ApplicationJsonFactory()	Instantiates a new application JSON factory.

Method Summary

Modifier and Type	Method	Description
MediaType	getMediaType()	Retrieves the Media-Type from the Media-Type property.
protected String	toElementName(Class<?> aClass)	Creates an element name for the class.
String	toMarshaled(Object aObject)	This method creates / retrieves an instance of the given type with the given identifier (name) constructed as defined in one to many configuration files.
protected String	toPlainJson(String aJson)	Removes any prefixed variable declaration.
protected String	toUnboxed(String aJson)	Unboxes any enveloped JSON.
<T> T	toUnmarshaled(String aHttpBody, Class<T> aType)	This method creates / retrieves an instance of the given type from the provided instance.
protected String	toVariableDeclaration(Class<?> aClass)	Returns the JSON specific assignment declaration for the given class.

Methods inherited from interface org.refcodes.net.Marshalable

toMarshaled

Methods inherited from interface org.refcodes.net.MediaTypeFactory

fromMarshaled, fromMarshaled, fromMarshaled, fromMarshaled, fromUnmarshaled, fromUnmarshaled

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.net.Unmarshalable

toUnmarshaled, toUnmarshaled, toUnmarshaled

Constructor Detail

ApplicationJsonFactory

public ApplicationJsonFactory()

Instantiates a new application JSON factory.

Method Detail

getMediaType

public MediaType getMediaType()

Retrieves the Media-Type from the Media-Type property.

Specified by:

getMediaType in interface MediaTypeAccessor

Returns:

The Media-Type stored by the Media-Type property.

toMarshaled

public String toMarshaled(Object aObject)
                   throws org.refcodes.exception.MarshalException

This method creates / retrieves an instance of the given type with the given identifier (name) constructed as defined in one to many configuration files. How the instance is configured, created or retrieved is up to the nature (implementation) of the according factory.

Specified by:

toMarshaled in interface Marshalable<String>

Parameters:

aObject - The context which may influence the object being created by this factory.

Returns:

The instance being fabricated by this factory.

Throws:

org.refcodes.exception.MarshalException - Thrown when marshaling / serializing an object fails.

toUnmarshaled

public <T> T toUnmarshaled(String aHttpBody,
                           Class<T> aType)
                    throws org.refcodes.exception.UnmarshalException

This method creates / retrieves an instance of the given type from the provided instance.

Specified by:

toUnmarshaled in interface Unmarshalable<String>

Type Parameters:

T - The type which is to be fabricated by the factory method.

Parameters:

aHttpBody - The context which may influence the object being created by this factory.

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

Returns:

An instance of the required type for the given type and context.

Throws:

org.refcodes.exception.UnmarshalException - Thrown when unmarshaling / deserializing an object fails.

toPlainJson

protected String toPlainJson(String aJson)

Removes any prefixed variable declaration.

Parameters:

aJson - The JSON from which to remove any prefixed variable declaration.

Returns:

The JSON without any prefixed variable declaration.

toUnboxed

protected String toUnboxed(String aJson)

Unboxes any enveloped JSON.

Parameters:

aJson - The JSON to be unboxed.

Returns:

The unboxed JSON.

toElementName

protected String toElementName(Class<?> aClass)

Creates an element name for the class.

Parameters:

aClass - The class from which to retrieve the element name.

Returns:

The element name for the class.

toVariableDeclaration

protected String toVariableDeclaration(Class<?> aClass)

Returns the JSON specific assignment declaration for the given class.

Parameters:

aClass - The class for which to construct the assignment declaration.

Returns:

The according assignment declaration.