io.micronaut.jackson.databind

Class JacksonDatabindMapper

java.lang.Object

io.micronaut.jackson.databind.JacksonDatabindMapper

All Implemented Interfaces:

JsonMapper

@Internal
 @Singleton
public final class JacksonDatabindMapper
extends java.lang.Object
implements JsonMapper

jackson-databind implementation of JsonMapper.

Since:

3.1

Author:

Jonas Konrad

Constructor Summary

Constructors

Constructor and Description
JacksonDatabindMapper()
JacksonDatabindMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Method Summary

Modifier and Type	Method and Description
JsonMapper	cloneWithFeatures(JsonFeatures features) Create a copy of this mapper with the given json features as returned by JsonMapper.detectFeatures(io.micronaut.core.annotation.AnnotationMetadata).
JsonMapper	cloneWithViewClass(java.lang.Class<?> viewClass) Create a copy of this mapper with the given view class.
org.reactivestreams.Processor<byte[],JsonNode>	createReactiveParser(java.util.function.Consumer<org.reactivestreams.Processor<byte[],JsonNode>> onSubscribe, boolean streamArray) Create a reactive Processor that accepts json bytes and parses them as JsonNodes.
java.util.Optional<JsonFeatures>	detectFeatures(AnnotationMetadata annotations) Detect JsonFeatures from the given annotation data.
com.fasterxml.jackson.databind.ObjectMapper	getObjectMapper()
JsonStreamConfig	getStreamConfig()
<T> T	readValue(byte[] byteArray, Argument<T> type) Parse and map json from the given byte array.
<T> T	readValue(java.io.InputStream inputStream, Argument<T> type) Parse and map json from the given stream.
<T> T	readValueFromTree(JsonNode tree, Argument<T> type) Transform a JsonNode to a value of the given type.
void	updateValueFromTree(java.lang.Object value, JsonNode tree) Update an object from json data.
void	writeValue(java.io.OutputStream outputStream, java.lang.Object object) Write an object as json.
byte[]	writeValueAsBytes(java.lang.Object object) Write an object as json.
JsonNode	writeValueToTree(java.lang.Object value) Transform an object value to a json tree.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.micronaut.json.JsonMapper

readValue, readValueFromTree

Constructor Detail

JacksonDatabindMapper

@Inject
 @Internal
public JacksonDatabindMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)

JacksonDatabindMapper

@Internal
public JacksonDatabindMapper()

Method Detail

getObjectMapper

@Internal
public com.fasterxml.jackson.databind.ObjectMapper getObjectMapper()

readValueFromTree

public <T> T readValueFromTree(@NonNull
                               JsonNode tree,
                               @NonNull
                               Argument<T> type)
                        throws java.io.IOException

Description copied from interface: JsonMapper

Transform a JsonNode to a value of the given type.

Specified by:

readValueFromTree in interface JsonMapper

Type Parameters:

T - Type variable of the return type.

Parameters:

tree - The input json data.

type - The type to deserialize.

Returns:

The deserialized value.

Throws:

java.io.IOException

writeValueToTree

@NonNull
public JsonNode writeValueToTree(@Nullable
                                          java.lang.Object value)
                                   throws java.io.IOException

Description copied from interface: JsonMapper

Transform an object value to a json tree.

Specified by:

writeValueToTree in interface JsonMapper

Parameters:

value - The object value to transform.

Returns:

The json representation.

Throws:

java.io.IOException - If there are any mapping exceptions (e.g. illegal values).

readValue

public <T> T readValue(@NonNull
                       java.io.InputStream inputStream,
                       @NonNull
                       Argument<T> type)
                throws java.io.IOException

Description copied from interface: JsonMapper

Parse and map json from the given stream.

Specified by:

readValue in interface JsonMapper

Type Parameters:

T - Type variable of the return type.

Parameters:

inputStream - The input data.

type - The type to deserialize to.

Returns:

The deserialized object.

Throws:

java.io.IOException

readValue

public <T> T readValue(@NonNull
                       byte[] byteArray,
                       @NonNull
                       Argument<T> type)
                throws java.io.IOException

Description copied from interface: JsonMapper

Parse and map json from the given byte array.

Specified by:

readValue in interface JsonMapper

Type Parameters:

T - Type variable of the return type.

Parameters:

byteArray - The input data.

type - The type to deserialize to.

Returns:

The deserialized object.

Throws:

java.io.IOException

writeValue

public void writeValue(@NonNull
                       java.io.OutputStream outputStream,
                       @Nullable
                       java.lang.Object object)
                throws java.io.IOException

Description copied from interface: JsonMapper

Write an object as json.

Specified by:

writeValue in interface JsonMapper

Parameters:

outputStream - The stream to write to.

object - The object to serialize.

Throws:

java.io.IOException

writeValueAsBytes

public byte[] writeValueAsBytes(@Nullable
                                java.lang.Object object)
                         throws java.io.IOException

Description copied from interface: JsonMapper

Write an object as json.

Specified by:

writeValueAsBytes in interface JsonMapper

Parameters:

object - The object to serialize.

Returns:

The serialized encoded json.

Throws:

java.io.IOException

updateValueFromTree

public void updateValueFromTree(java.lang.Object value,
                                @NonNull
                                JsonNode tree)
                         throws java.io.IOException

Description copied from interface: JsonMapper

Update an object from json data.

Specified by:

updateValueFromTree in interface JsonMapper

Parameters:

value - The object to update.

tree - The json data to update from.

Throws:

java.io.IOException - If there are any mapping exceptions (e.g. illegal values).

cloneWithFeatures

@NonNull
public JsonMapper cloneWithFeatures(@NonNull
                                             JsonFeatures features)

Description copied from interface: JsonMapper

Create a copy of this mapper with the given json features as returned by JsonMapper.detectFeatures(io.micronaut.core.annotation.AnnotationMetadata).

Specified by:

cloneWithFeatures in interface JsonMapper

Parameters:

features - The json features to configure.

Returns:

A new mapper.

cloneWithViewClass

@NonNull
public JsonMapper cloneWithViewClass(@NonNull
                                              java.lang.Class<?> viewClass)

Description copied from interface: JsonMapper

Create a copy of this mapper with the given view class.

Specified by:

cloneWithViewClass in interface JsonMapper

Parameters:

viewClass - The view class to use for serialization and deserialization.

Returns:

A new mapper.

getStreamConfig

@NonNull
public JsonStreamConfig getStreamConfig()

Specified by:

getStreamConfig in interface JsonMapper

Returns:

The configured stream config.

createReactiveParser

@NonNull
public org.reactivestreams.Processor<byte[],JsonNode> createReactiveParser(java.util.function.Consumer<org.reactivestreams.Processor<byte[],JsonNode>> onSubscribe,
                                                                                    boolean streamArray)

Description copied from interface: JsonMapper

Create a reactive Processor that accepts json bytes and parses them as JsonNodes.

Specified by:

createReactiveParser in interface JsonMapper

Parameters:

onSubscribe - An additional function to invoke with this processor when the returned processor is subscribed to.

streamArray - Whether to return a top-level json array as a stream of elements rather than a single array.

Returns:

The reactive processor.

detectFeatures

@NonNull
public java.util.Optional<JsonFeatures> detectFeatures(@NonNull
                                                                AnnotationMetadata annotations)

Description copied from interface: JsonMapper

Detect JsonFeatures from the given annotation data.

Specified by:

detectFeatures in interface JsonMapper

Parameters:

annotations - The annotations to scan.

Returns:

The json features for use in JsonMapper.cloneWithFeatures(io.micronaut.json.JsonFeatures), or an empty optional if there were no feature annotations detected (or feature annotations are not supported).