Class JacksonJsonHttpMessageConverter

java.lang.Object

org.springframework.http.converter.AbstractHttpMessageConverter<Object>

org.springframework.http.converter.AbstractSmartHttpMessageConverter<Object>

org.springframework.http.converter.AbstractJacksonHttpMessageConverter<tools.jackson.databind.json.JsonMapper>

org.springframework.http.converter.json.JacksonJsonHttpMessageConverter

All Implemented Interfaces:

HttpMessageConverter<Object>, SmartHttpMessageConverter<Object>

public class JacksonJsonHttpMessageConverter
extends AbstractJacksonHttpMessageConverter<tools.jackson.databind.json.JsonMapper>

Implementation of HttpMessageConverter that can read and write JSON using Jackson 3.x's JsonMapper.

This converter can be used to bind to typed beans, or untyped HashMap instances.

By default, this converter supports application/json and application/*+json with UTF-8 character set. This can be overridden by setting the supportedMediaTypes property.

The default constructor loads JacksonModules found by MapperBuilder.findModules(ClassLoader).

The following hints entries are supported:

• A JSON view with a com.fasterxml.jackson.annotation.JsonView key and the class name of the JSON view as value.
• A filter provider with a tools.jackson.databind.ser.FilterProvider key and the filter provider class name as value.

Since:

7.0

Author:

Sebastien Deleuze

Field Summary

Fields inherited from class AbstractJacksonHttpMessageConverter

defaultMapper

Fields inherited from class AbstractHttpMessageConverter

logger

Constructor Summary

Constructors

Constructor	Description
JacksonJsonHttpMessageConverter()	Construct a new instance with a JsonMapper customized with the JacksonModules found by MapperBuilder.findModules(ClassLoader) and ProblemDetailJacksonMixin.
JacksonJsonHttpMessageConverter(tools.jackson.databind.json.JsonMapper objectMapper)	Construct a new instance with the provided JsonMapper.

Method Summary

Modifier and Type	Method	Description
protected List<MediaType>	getMediaTypesForProblemDetail()	Return the supported media type(s) for ProblemDetail.
void	setJsonPrefix(String jsonPrefix)	Specify a custom prefix to use for this view's JSON output.
void	setPrefixJson(boolean prefixJson)	Indicate whether the JSON output by this view should be prefixed with ")]}', ".
protected void	writePrefix(tools.jackson.core.JsonGenerator generator, Object object)	Write a prefix before the main content.

Methods inherited from class AbstractJacksonHttpMessageConverter

canRead, canWrite, customizeReader, customizeWriter, getCharset, getJavaType, getJsonEncoding, getMapper, getMappersForType, getSupportedMediaTypes, read, readInternal, registerMappersForType, setSupportedMediaTypes, supportsRepeatableWrites, writeInternal, writeSuffix

Methods inherited from class AbstractSmartHttpMessageConverter

canWrite, supports, write, writeInternal

Methods inherited from class AbstractHttpMessageConverter

addDefaultHeaders, canRead, canRead, canWrite, getContentLength, getDefaultCharset, getDefaultContentType, getSupportedMediaTypes, read, setDefaultCharset, write

Methods inherited from class Object

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

Methods inherited from interface HttpMessageConverter

getSupportedMediaTypes

Methods inherited from interface SmartHttpMessageConverter

canRead, read, write

Constructor Details

JacksonJsonHttpMessageConverter

public JacksonJsonHttpMessageConverter()

Construct a new instance with a JsonMapper customized with the JacksonModules found by MapperBuilder.findModules(ClassLoader) and ProblemDetailJacksonMixin.

JacksonJsonHttpMessageConverter

public JacksonJsonHttpMessageConverter(tools.jackson.databind.json.JsonMapper objectMapper)

Construct a new instance with the provided JsonMapper.

See Also:

• JsonMapper.builder()
• MapperBuilder.findModules(ClassLoader)

Method Details

setJsonPrefix

public void setJsonPrefix(String jsonPrefix)

Specify a custom prefix to use for this view's JSON output. Default is none.

See Also:

• setPrefixJson(boolean)

setPrefixJson

public void setPrefixJson(boolean prefixJson)

Indicate whether the JSON output by this view should be prefixed with ")]}', ". Default is false.

Prefixing the JSON string in this manner is used to help prevent JSON Hijacking. The prefix renders the string syntactically invalid as a script so that it cannot be hijacked. This prefix should be stripped before parsing the string as JSON.

See Also:

• setJsonPrefix(String)

getMediaTypesForProblemDetail

protected List<MediaType> getMediaTypesForProblemDetail()

Description copied from class: AbstractJacksonHttpMessageConverter

Return the supported media type(s) for ProblemDetail. By default, an empty list, unless overridden in subclasses.

Overrides:

getMediaTypesForProblemDetail in class AbstractJacksonHttpMessageConverter<tools.jackson.databind.json.JsonMapper>

writePrefix

protected void writePrefix(tools.jackson.core.JsonGenerator generator,
 Object object)

Description copied from class: AbstractJacksonHttpMessageConverter

Write a prefix before the main content.

Overrides:

writePrefix in class AbstractJacksonHttpMessageConverter<tools.jackson.databind.json.JsonMapper>

Parameters:

generator - the generator to use for writing content.

object - the object to write to the output message