org.springframework.integration.json

Class JsonToObjectTransformer

java.lang.Object

org.springframework.integration.context.IntegrationObjectSupport

org.springframework.integration.transformer.AbstractTransformer

org.springframework.integration.json.JsonToObjectTransformer

All Implemented Interfaces:

Aware, BeanClassLoaderAware, BeanFactoryAware, BeanNameAware, InitializingBean, ApplicationContextAware, ExpressionCapable, NamedComponent, GenericTransformer<Message<?>,Message<?>>, Transformer

public class JsonToObjectTransformer
extends AbstractTransformer
implements BeanClassLoaderAware

Transformer implementation that converts a JSON string payload into an instance of the provided target Class. By default this transformer uses JsonObjectMapperProvider factory to get an instance of Jackson 1 or Jackson 2 JSON-processor JsonObjectMapper implementation depending on the jackson-databind or jackson-mapper-asl libs on the classpath. Any other JsonObjectMapper implementation can be provided.

Since version 3.0, you can omit the target class and the target type can be determined by the JsonHeaders type entries - including the contents of a one-level container or map type.

The type headers can be classes or fully-qualified class names.

Since:

2.0

Author:

Mark Fisher, Artem Bilan

See Also:

JsonObjectMapper, JsonObjectMapperProvider

Field Summary

Fields inherited from class org.springframework.integration.context.IntegrationObjectSupport

EXPRESSION_PARSER, logger

Constructor Summary

Constructors

Constructor and Description
JsonToObjectTransformer()
JsonToObjectTransformer(Class<?> targetClass)
JsonToObjectTransformer(Class<?> targetClass, JsonObjectMapper<?,?> jsonObjectMapper)
JsonToObjectTransformer(JsonObjectMapper<?,?> jsonObjectMapper)
JsonToObjectTransformer(ResolvableType targetType) Construct an instance based on the provided ResolvableType.
JsonToObjectTransformer(ResolvableType targetType, JsonObjectMapper<?,?> jsonObjectMapper) Construct an instance based on the provided ResolvableType and JsonObjectMapper.

Method Summary

Modifier and Type	Method and Description
protected Object	doTransform(Message<?> message) Subclasses must implement this method to provide the transformation logic.
String	getComponentType() Subclasses may implement this method to provide component type information.
void	setBeanClassLoader(ClassLoader classLoader)

Methods inherited from class org.springframework.integration.transformer.AbstractTransformer

transform

Methods inherited from class org.springframework.integration.context.IntegrationObjectSupport

afterPropertiesSet, extractTypeIfPossible, generateId, getApplicationContext, getApplicationContextId, getBeanDescription, getBeanFactory, getBeanName, getChannelResolver, getComponentName, getConversionService, getExpression, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, isInitialized, onInit, setApplicationContext, setBeanFactory, setBeanName, setChannelResolver, setComponentName, setConversionService, setMessageBuilderFactory, setPrimaryExpression, setTaskScheduler, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonToObjectTransformer

public JsonToObjectTransformer()

JsonToObjectTransformer

public JsonToObjectTransformer(@Nullable
                               Class<?> targetClass)

JsonToObjectTransformer

public JsonToObjectTransformer(ResolvableType targetType)

Construct an instance based on the provided ResolvableType.

Parameters:

targetType - the ResolvableType to use.

Since:

5.2

JsonToObjectTransformer

public JsonToObjectTransformer(@Nullable
                               JsonObjectMapper<?,?> jsonObjectMapper)

JsonToObjectTransformer

public JsonToObjectTransformer(@Nullable
                               Class<?> targetClass,
                               @Nullable
                               JsonObjectMapper<?,?> jsonObjectMapper)

JsonToObjectTransformer

public JsonToObjectTransformer(ResolvableType targetType,
                               @Nullable
                               JsonObjectMapper<?,?> jsonObjectMapper)

Construct an instance based on the provided ResolvableType and JsonObjectMapper.

Parameters:

targetType - the ResolvableType to use.

jsonObjectMapper - the JsonObjectMapper to use.

Since:

5.2

Method Detail

setBeanClassLoader

public void setBeanClassLoader(ClassLoader classLoader)

Specified by:

setBeanClassLoader in interface BeanClassLoaderAware

getComponentType

public String getComponentType()

Description copied from class: IntegrationObjectSupport

Subclasses may implement this method to provide component type information.

Specified by:

getComponentType in interface NamedComponent

Overrides:

getComponentType in class IntegrationObjectSupport

doTransform

protected Object doTransform(Message<?> message)

Description copied from class: AbstractTransformer

Subclasses must implement this method to provide the transformation logic. If the return value is itself a Message, it will be used as the result. Otherwise, any non-null return value will be used as the payload of the result Message.

Specified by:

doTransform in class AbstractTransformer

Parameters:

message - The message.

Returns:

The result of the transformation.