public class MappingJackson2JsonView extends AbstractJackson2View
View
that renders JSON content by serializing the model for the current request
using Jackson 2's ObjectMapper
.
By default, the entire contents of the model map (with the exception of framework-specific classes)
will be encoded as JSON. If the model contains only one key, you can have it extracted encoded as JSON
alone via setExtractValueFromSingleKeyModel(boolean)
.
The default constructor uses the default configuration provided by Jackson2ObjectMapperBuilder
.
Compatible with Jackson 2.6 and higher, as of Spring 4.3.
Modifier and Type | Field and Description |
---|---|
static String |
DEFAULT_CONTENT_TYPE
Default content type: "application/json".
|
static String |
DEFAULT_JSONP_CONTENT_TYPE
Deprecated.
Will be removed as of Spring Framework 5.1, use
CORS instead.
|
updateContentLength
logger
PATH_VARIABLES, RESPONSE_STATUS_ATTRIBUTE, SELECTED_CONTENT_TYPE
Constructor and Description |
---|
MappingJackson2JsonView()
Construct a new
MappingJackson2JsonView using default configuration
provided by Jackson2ObjectMapperBuilder and setting the content type
to application/json . |
MappingJackson2JsonView(ObjectMapper objectMapper)
Construct a new
MappingJackson2JsonView using the provided
ObjectMapper and setting the content type to application/json . |
Modifier and Type | Method and Description |
---|---|
protected Object |
filterAndWrapModel(Map<String,Object> model,
HttpServletRequest request)
Filter and optionally wrap the model in
MappingJacksonValue container. |
protected Object |
filterModel(Map<String,Object> model)
Filter out undesired attributes from the given model.
|
Set<String> |
getModelKeys()
Return the attributes in the model that should be rendered by this view.
|
protected boolean |
isValidJsonpQueryParam(String value)
Deprecated.
Will be removed as of Spring Framework 5.1, use
CORS instead.
|
void |
setExtractValueFromSingleKeyModel(boolean extractValueFromSingleKeyModel)
Set whether to serialize models containing a single attribute as a map or
whether to extract the single value from the model and serialize it directly.
|
void |
setJsonpParameterNames(Set<String> jsonpParameterNames)
Deprecated.
Will be removed as of Spring Framework 5.1, use
CORS instead.
|
void |
setJsonPrefix(String jsonPrefix)
Specify a custom prefix to use for this view's JSON output.
|
void |
setModelKey(String modelKey)
Set the attribute in the model that should be rendered by this view.
|
void |
setModelKeys(Set<String> modelKeys)
Set the attributes in the model that should be rendered by this view.
|
void |
setPrefixJson(boolean prefixJson)
Indicates whether the JSON output by this view should be prefixed with ")]}', ".
|
protected void |
setResponseContentType(HttpServletRequest request,
HttpServletResponse response)
Set the content type of the response to the configured
content type unless the
View.SELECTED_CONTENT_TYPE request attribute is present and set
to a concrete media type. |
protected void |
writePrefix(JsonGenerator generator,
Object object)
Write a prefix before the main content.
|
protected void |
writeSuffix(JsonGenerator generator,
Object object)
Write a suffix after the main content.
|
getEncoding, getObjectMapper, prepareResponse, renderMergedOutputModel, setDisableCaching, setEncoding, setObjectMapper, setPrettyPrint, setUpdateContentLength, writeContent
addStaticAttribute, createMergedOutputModel, createRequestContext, createTemporaryOutputStream, exposeModelAsRequestAttributes, generatesDownloadContent, getAttributesMap, getBeanName, getContentType, getRequestContextAttribute, getRequestToExpose, getStaticAttributes, isExposePathVariables, render, setAttributes, setAttributesCSV, setAttributesMap, setBeanName, setContentType, setExposeContextBeansAsAttributes, setExposedContextBeanNames, setExposePathVariables, setRequestContextAttribute, toString, writeToResponse
getServletContext, getTempDir, getWebApplicationContext, initApplicationContext, initServletContext, isContextRequired, setServletContext
getApplicationContext, getMessageSourceAccessor, initApplicationContext, requiredContextClass, setApplicationContext
public static final String DEFAULT_CONTENT_TYPE
AbstractView.setContentType(java.lang.String)
.@Deprecated public static final String DEFAULT_JSONP_CONTENT_TYPE
public MappingJackson2JsonView()
MappingJackson2JsonView
using default configuration
provided by Jackson2ObjectMapperBuilder
and setting the content type
to application/json
.public MappingJackson2JsonView(ObjectMapper objectMapper)
MappingJackson2JsonView
using the provided
ObjectMapper
and setting the content type to application/json
.public void setJsonPrefix(String jsonPrefix)
setPrefixJson(boolean)
public void setPrefixJson(boolean prefixJson)
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.
setJsonPrefix(java.lang.String)
public void setModelKey(String modelKey)
setModelKey
in class AbstractJackson2View
public void setModelKeys(Set<String> modelKeys)
public final Set<String> getModelKeys()
public void setExtractValueFromSingleKeyModel(boolean extractValueFromSingleKeyModel)
The effect of setting this flag is similar to using
MappingJackson2HttpMessageConverter
with an @ResponseBody
request-handling method.
Default is false
.
@Deprecated public void setJsonpParameterNames(Set<String> jsonpParameterNames)
The parameter names configured by default are "jsonp" and "callback".
@Deprecated protected boolean isValidJsonpQueryParam(String value)
value
- the query param value, never null
protected Object filterModel(Map<String,Object> model)
Map
or a single value object.
The default implementation removes BindingResult
instances and entries
not included in the modelKeys
property.
filterModel
in class AbstractJackson2View
model
- the model, as passed on to AbstractJackson2View.renderMergedOutputModel(java.util.Map<java.lang.String, java.lang.Object>, javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)
protected Object filterAndWrapModel(Map<String,Object> model, HttpServletRequest request)
AbstractJackson2View
MappingJacksonValue
container.filterAndWrapModel
in class AbstractJackson2View
model
- the model, as passed on to AbstractJackson2View.renderMergedOutputModel(java.util.Map<java.lang.String, java.lang.Object>, javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)
request
- current HTTP requestprotected void writePrefix(JsonGenerator generator, Object object) throws IOException
AbstractJackson2View
writePrefix
in class AbstractJackson2View
generator
- the generator to use for writing content.object
- the object to write to the output message.IOException
protected void writeSuffix(JsonGenerator generator, Object object) throws IOException
AbstractJackson2View
writeSuffix
in class AbstractJackson2View
generator
- the generator to use for writing content.object
- the object to write to the output message.IOException
protected void setResponseContentType(HttpServletRequest request, HttpServletResponse response)
AbstractView
content type
unless the
View.SELECTED_CONTENT_TYPE
request attribute is present and set
to a concrete media type.setResponseContentType
in class AbstractView