org.springframework.http.codec.json

Class AbstractJackson2Encoder

java.lang.Object

org.springframework.http.codec.json.Jackson2CodecSupport

org.springframework.http.codec.json.AbstractJackson2Encoder

All Implemented Interfaces:

org.springframework.core.codec.Encoder<Object>, HttpMessageEncoder<Object>

Direct Known Subclasses:

Jackson2JsonEncoder, Jackson2SmileEncoder

public abstract class AbstractJackson2Encoder
extends Jackson2CodecSupport
implements HttpMessageEncoder<Object>

Base class providing support methods for Jackson 2.9 encoding. For non-streaming use cases, Flux elements are collected into a List before serialization for performance reason.

Since:

5.0

Author:

Sebastien Deleuze, Arjen Poutsma

Field Summary

Fields inherited from class org.springframework.http.codec.json.Jackson2CodecSupport

JSON_VIEW_HINT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractJackson2Encoder(ObjectMapper mapper, org.springframework.util.MimeType... mimeTypes) Constructor with a Jackson ObjectMapper to use.

Method Summary

Modifier and Type	Method and Description
boolean	canEncode(org.springframework.core.ResolvableType elementType, org.springframework.util.MimeType mimeType)
protected ObjectWriter	customizeWriter(ObjectWriter writer, org.springframework.util.MimeType mimeType, org.springframework.core.ResolvableType elementType, Map<String,Object> hints)
reactor.core.publisher.Flux<org.springframework.core.io.buffer.DataBuffer>	encode(org.reactivestreams.Publisher<?> inputStream, org.springframework.core.io.buffer.DataBufferFactory bufferFactory, org.springframework.core.ResolvableType elementType, org.springframework.util.MimeType mimeType, Map<String,Object> hints)
protected <A extends Annotation> A	getAnnotation(org.springframework.core.MethodParameter parameter, Class<A> annotType)
List<org.springframework.util.MimeType>	getEncodableMimeTypes()
Map<String,Object>	getEncodeHints(org.springframework.core.ResolvableType actualType, org.springframework.core.ResolvableType elementType, MediaType mediaType, ServerHttpRequest request, ServerHttpResponse response) Get decoding hints based on the server request or annotations on the target controller method parameter.
protected JsonEncoding	getJsonEncoding(org.springframework.util.MimeType mimeType) Determine the JSON encoding to use for the given mime type.
List<MediaType>	getStreamingMediaTypes() Return "streaming" media types for which flushing should be performed automatically vs at the end of the input stream.
void	setStreamingMediaTypes(List<MediaType> mediaTypes) Configure "streaming" media types for which flushing should be performed automatically vs at the end of the stream.

Methods inherited from class org.springframework.http.codec.json.Jackson2CodecSupport

getHints, getJavaType, getMimeTypes, getObjectMapper, getParameter, supportsMimeType

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.core.codec.Encoder

getContentLength

Constructor Detail

AbstractJackson2Encoder

protected AbstractJackson2Encoder(ObjectMapper mapper,
                                  org.springframework.util.MimeType... mimeTypes)

Constructor with a Jackson ObjectMapper to use.

Method Detail

setStreamingMediaTypes

public void setStreamingMediaTypes(List<MediaType> mediaTypes)

Configure "streaming" media types for which flushing should be performed automatically vs at the end of the stream.

By default this is set to MediaType.APPLICATION_STREAM_JSON.

Parameters:

mediaTypes - one or more media types to add to the list

See Also:

HttpMessageEncoder.getStreamingMediaTypes()

canEncode

public boolean canEncode(org.springframework.core.ResolvableType elementType,
                         @Nullable
                         org.springframework.util.MimeType mimeType)

Specified by:

canEncode in interface org.springframework.core.codec.Encoder<Object>

encode

public reactor.core.publisher.Flux<org.springframework.core.io.buffer.DataBuffer> encode(org.reactivestreams.Publisher<?> inputStream,
                                                                                         org.springframework.core.io.buffer.DataBufferFactory bufferFactory,
                                                                                         org.springframework.core.ResolvableType elementType,
                                                                                         @Nullable
                                                                                         org.springframework.util.MimeType mimeType,
                                                                                         @Nullable
                                                                                         Map<String,Object> hints)

Specified by:

encode in interface org.springframework.core.codec.Encoder<Object>

customizeWriter

protected ObjectWriter customizeWriter(ObjectWriter writer,
                                       @Nullable
                                       org.springframework.util.MimeType mimeType,
                                       org.springframework.core.ResolvableType elementType,
                                       @Nullable
                                       Map<String,Object> hints)

getJsonEncoding

protected JsonEncoding getJsonEncoding(@Nullable
                                       org.springframework.util.MimeType mimeType)

Determine the JSON encoding to use for the given mime type.

Parameters:

mimeType - the mime type as requested by the caller

Returns:

the JSON encoding to use (never null)

Since:

5.0.5

getEncodableMimeTypes

public List<org.springframework.util.MimeType> getEncodableMimeTypes()

Specified by:

getEncodableMimeTypes in interface org.springframework.core.codec.Encoder<Object>

getStreamingMediaTypes

public List<MediaType> getStreamingMediaTypes()

Description copied from interface: HttpMessageEncoder

Return "streaming" media types for which flushing should be performed automatically vs at the end of the input stream.

Specified by:

getStreamingMediaTypes in interface HttpMessageEncoder<Object>

getEncodeHints

public Map<String,Object> getEncodeHints(@Nullable
                                         org.springframework.core.ResolvableType actualType,
                                         org.springframework.core.ResolvableType elementType,
                                         @Nullable
                                         MediaType mediaType,
                                         ServerHttpRequest request,
                                         ServerHttpResponse response)

Description copied from interface: HttpMessageEncoder

Get decoding hints based on the server request or annotations on the target controller method parameter.

Specified by:

getEncodeHints in interface HttpMessageEncoder<Object>

Parameters:

actualType - the actual source type to encode, possibly a reactive wrapper and sourced from MethodParameter, i.e. providing access to method annotations.

elementType - the element type within Flux/Mono that we're trying to encode.

request - the current request

response - the current response

Returns:

a Map with hints, possibly empty

getAnnotation

protected <A extends Annotation> A getAnnotation(org.springframework.core.MethodParameter parameter,
                                                 Class<A> annotType)

Specified by:

getAnnotation in class Jackson2CodecSupport