Package org.springframework.messaging.converter

Class MappingJackson2MessageConverter

java.lang.Object
org.springframework.messaging.converter.AbstractMessageConverter
org.springframework.messaging.converter.MappingJackson2MessageConverter
All Implemented Interfaces:
MessageConverter, SmartMessageConverter
public class MappingJackson2MessageConverter extends AbstractMessageConverter
A Jackson 2 based MessageConverter implementation.

It customizes Jackson's default properties with the following ones:

Since:
4.0
Author:
Rossen Stoyanchev, Juergen Hoeller, Sebastien Deleuze

  • Constructor Details

    • MappingJackson2MessageConverter

      public MappingJackson2MessageConverter()
      Construct a MappingJackson2MessageConverter with a default ObjectMapper, supporting the application/json MIME type with UTF-8 character set.

    • MappingJackson2MessageConverter

      public MappingJackson2MessageConverter(MimeType... supportedMimeTypes)
      Construct a MappingJackson2MessageConverter with a default ObjectMapper, supporting one or more custom MIME types.
      Parameters:
      supportedMimeTypes - the supported MIME types
      Since:
      4.1.5

    • MappingJackson2MessageConverter

      public MappingJackson2MessageConverter(ObjectMapper objectMapper)
      Construct a MappingJackson2MessageConverter with a custom ObjectMapper, supporting the application/json MIME type with UTF-8 character set.
      Parameters:
      objectMapper - the ObjectMapper to use
      Since:
      6.1

    • MappingJackson2MessageConverter

      public MappingJackson2MessageConverter(ObjectMapper objectMapper, MimeType... supportedMimeTypes)
      Construct a MappingJackson2MessageConverter with a custom ObjectMapper, supporting one or more custom MIME types.
      Parameters:
      objectMapper - the ObjectMapper to use
      supportedMimeTypes - the supported MIME types
      Since:
      6.1

  • Method Details

    • setObjectMapper

      public void setObjectMapper(ObjectMapper objectMapper)
      Set the ObjectMapper for this converter.

      If not set, a default ObjectMapper is used.

      Setting a custom-configured ObjectMapper is one way to take further control of the JSON serialization process. For example, an extended SerializerFactory can be configured that provides custom serializers for specific types. The other option for refining the serialization process is to use Jackson's provided annotations on the types to be serialized, in which case a custom-configured ObjectMapper is unnecessary.

    • getObjectMapper

      public ObjectMapper getObjectMapper()
      Return the underlying ObjectMapper for this converter.

    • setPrettyPrint

      public void setPrettyPrint(boolean prettyPrint)
      Whether to use the DefaultPrettyPrinter when writing JSON.

      This is a shortcut for setting up an ObjectMapper as follows: 

       ObjectMapper mapper = new ObjectMapper();
 mapper.configure(SerializationFeature.INDENT_OUTPUT, true);
 converter.setObjectMapper(mapper);

    • canConvertFrom

      protected boolean canConvertFrom(Message<?> message, @Nullable Class<?> targetClass)
      Overrides:
      canConvertFrom in class AbstractMessageConverter

    • canConvertTo

      protected boolean canConvertTo(Object payload, @Nullable MessageHeaders headers)
      Overrides:
      canConvertTo in class AbstractMessageConverter

    • logWarningIfNecessary

      protected void logWarningIfNecessary(Type type, @Nullable Throwable cause)
      Determine whether to log the given exception coming from a ObjectMapper.canDeserialize(com.fasterxml.jackson.databind.JavaType) / ObjectMapper.canSerialize(java.lang.Class<?>) check.
      Parameters:
      type - the class that Jackson tested for (de-)serializability
      cause - the Jackson-thrown exception to evaluate (typically a JsonMappingException)
      Since:
      4.3

    • supports

      protected boolean supports(Class<?> clazz)
      Description copied from class: AbstractMessageConverter
      Whether the given class is supported by this converter.
      Specified by:
      supports in class AbstractMessageConverter
      Parameters:
      clazz - the class to test for support
      Returns:
      true if supported; false otherwise

    • convertFromInternal

      @Nullable protected Object convertFromInternal(Message<?> message, Class<?> targetClass, @Nullable Object conversionHint)
      Description copied from class: AbstractMessageConverter
      Convert the message payload from serialized form to an Object.
      Overrides:
      convertFromInternal in class AbstractMessageConverter
      Parameters:
      message - the input message
      targetClass - the target class for the conversion
      conversionHint - an extra object passed to the MessageConverter, for example, the associated MethodParameter (may be null)
      Returns:
      the result of the conversion, or null if the converter cannot perform the conversion

    • convertToInternal

      @Nullable protected Object convertToInternal(Object payload, @Nullable MessageHeaders headers, @Nullable Object conversionHint)
      Description copied from class: AbstractMessageConverter
      Convert the payload object to serialized form.
      Overrides:
      convertToInternal in class AbstractMessageConverter
      Parameters:
      payload - the Object to convert
      headers - optional headers for the message (may be null)
      conversionHint - an extra object passed to the MessageConverter, for example, the associated MethodParameter (may be null)
      Returns:
      the resulting payload for the message, or null if the converter cannot perform the conversion

    • getSerializationView

      @Nullable protected Class<?> getSerializationView(@Nullable Object conversionHint)
      Determine a Jackson serialization view based on the given conversion hint.
      Parameters:
      conversionHint - the conversion hint Object as passed into the converter for the current conversion attempt
      Returns:
      the serialization view class, or null if none
      Since:
      4.2

    • getJsonEncoding

      protected JsonEncoding getJsonEncoding(@Nullable MimeType contentType)
      Determine the JSON encoding to use for the given content type.
      Parameters:
      contentType - the MIME type from the MessageHeaders, if any
      Returns:
      the JSON encoding to use (never null)