|
Spring for Android | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.springframework.http.converter.AbstractHttpMessageConverter<java.lang.Object>
org.springframework.http.converter.json.MappingJackson2HttpMessageConverter
public class MappingJackson2HttpMessageConverter
Implementation of HttpMessageConverter
that can read and write JSON using Jackson 2's ObjectMapper
.
This converter can be used to bind to typed beans, or untyped HashMap
instances.
By default, this converter supports application/json
. This can be overridden by setting the
supportedMediaTypes
property.
Field Summary | |
---|---|
static java.nio.charset.Charset |
DEFAULT_CHARSET
|
Constructor Summary | |
---|---|
MappingJackson2HttpMessageConverter()
Construct a new BindingJacksonHttpMessageConverter . |
Method Summary | |
---|---|
boolean |
canRead(java.lang.Class<?> clazz,
MediaType mediaType)
This implementation checks if the given class is supported, and if the supported media types include the given media type. |
boolean |
canWrite(java.lang.Class<?> clazz,
MediaType mediaType)
This implementation checks if the given class is supported, and if the supported media types include the given media type. |
protected com.fasterxml.jackson.databind.JavaType |
getJavaType(java.lang.Class<?> clazz)
Return the Jackson JavaType for the specified class. |
protected com.fasterxml.jackson.core.JsonEncoding |
getJsonEncoding(MediaType contentType)
Determine the JSON encoding to use for the given content type. |
com.fasterxml.jackson.databind.ObjectMapper |
getObjectMapper()
Return the underlying ObjectMapper for this view. |
protected java.lang.Object |
readInternal(java.lang.Class<?> clazz,
HttpInputMessage inputMessage)
Abstract template method that reads the actualy object. |
void |
setObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)
Set the ObjectMapper for this view. |
void |
setPrefixJson(boolean prefixJson)
Indicate whether the JSON output by this view should be prefixed with "{} &&". |
protected boolean |
supports(java.lang.Class<?> clazz)
Indicates whether the given class is supported by this converter. |
protected void |
writeInternal(java.lang.Object object,
HttpOutputMessage outputMessage)
Abstract template method that writes the actual body. |
Methods inherited from class org.springframework.http.converter.AbstractHttpMessageConverter |
---|
canRead, canWrite, getContentLength, getDefaultContentType, getSupportedMediaTypes, read, setSupportedMediaTypes, write |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.nio.charset.Charset DEFAULT_CHARSET
Constructor Detail |
---|
public MappingJackson2HttpMessageConverter()
BindingJacksonHttpMessageConverter
.
Method Detail |
---|
public void setObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)
ObjectMapper
for this view. 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.
public com.fasterxml.jackson.databind.ObjectMapper getObjectMapper()
ObjectMapper
for this view.
public void setPrefixJson(boolean prefixJson)
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 does not affect the evaluation of JSON, but if JSON validation is performed on the string, the prefix would need to be ignored.
public boolean canRead(java.lang.Class<?> clazz, MediaType mediaType)
AbstractHttpMessageConverter
canRead
in interface HttpMessageConverter<java.lang.Object>
canRead
in class AbstractHttpMessageConverter<java.lang.Object>
clazz
- the class to test for readabilitymediaType
- the media type to read, can be null
if not specified.
Typically the value of a Content-Type
header.
true
if readable; false
otherwisepublic boolean canWrite(java.lang.Class<?> clazz, MediaType mediaType)
AbstractHttpMessageConverter
canWrite
in interface HttpMessageConverter<java.lang.Object>
canWrite
in class AbstractHttpMessageConverter<java.lang.Object>
clazz
- the class to test for writabilitymediaType
- the media type to write, can be null
if not specified.
Typically the value of an Accept
header.
true
if writable; false
otherwiseprotected boolean supports(java.lang.Class<?> clazz)
AbstractHttpMessageConverter
supports
in class AbstractHttpMessageConverter<java.lang.Object>
clazz
- the class to test for support
true
if supported; false
otherwiseprotected java.lang.Object readInternal(java.lang.Class<?> clazz, HttpInputMessage inputMessage) throws java.io.IOException, HttpMessageNotReadableException
AbstractHttpMessageConverter
AbstractHttpMessageConverter.read(java.lang.Class extends T>, org.springframework.http.HttpInputMessage)
.
readInternal
in class AbstractHttpMessageConverter<java.lang.Object>
clazz
- the type of object to returninputMessage
- the HTTP input message to read from
java.io.IOException
- in case of I/O errors
HttpMessageNotReadableException
- in case of conversion errorsprotected void writeInternal(java.lang.Object object, HttpOutputMessage outputMessage) throws java.io.IOException, HttpMessageNotWritableException
AbstractHttpMessageConverter
AbstractHttpMessageConverter.write(T, org.springframework.http.MediaType, org.springframework.http.HttpOutputMessage)
.
writeInternal
in class AbstractHttpMessageConverter<java.lang.Object>
object
- the object to write to the output messageoutputMessage
- the message to write to
java.io.IOException
- in case of I/O errors
HttpMessageNotWritableException
- in case of conversion errorsprotected com.fasterxml.jackson.databind.JavaType getJavaType(java.lang.Class<?> clazz)
JavaType
for the specified class.
The default implementation returns ObjectMapper.constructType(java.lang.reflect.Type)
,
but this can be overridden in subclasses, to allow for custom generic collection handling.
For instance:
protected JavaType getJavaType(Class<?> clazz) { if (List.class.isAssignableFrom(clazz)) { return objectMapper.getTypeFactory().constructCollectionType(ArrayList.class, MyBean.class); } else { return super.getJavaType(clazz); } }
clazz
- the class to return the java type for
protected com.fasterxml.jackson.core.JsonEncoding getJsonEncoding(MediaType contentType)
contentType
- the media type as requested by the caller
null
)
|
Spring for Android | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |