lowentry.ue4.libs.jackson.databind.package-info Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of lowentryue4 Show documentation
A Java library for the Low Entry UE4 plugins.
There is a newer version: 3.0.1
/**
Basic data binding (mapping) functionality that
allows for reading JSON content into Java Objects (POJOs)
and JSON Trees ({@link lowentry.ue4.libs.jackson.databind.JsonNode}), as well as
writing Java Objects and trees as JSON.
Reading and writing (as well as related additional functionality) is accessed through
{@link lowentry.ue4.libs.jackson.databind.ObjectMapper},
{@link lowentry.ue4.libs.jackson.databind.ObjectReader} and
{@link lowentry.ue4.libs.jackson.databind.ObjectWriter}
 classes.
 In addition to reading and writing JSON content, it is also possible to use the
 general databinding functionality for many other data formats, using
 Jackson extension modules that provide such support: if so, you typically
 simply construct an {@link lowentry.ue4.libs.jackson.databind.ObjectMapper} with
 different underlying streaming parser, generator implementation.

The main starting point for operations is {@link lowentry.ue4.libs.jackson.databind.ObjectMapper},
which can be used either directly (via multiple overloaded
readValue,
readTree,
writeValue and
writeTree methods, or it can be used as a configurable factory for constructing
fully immutable, thread-safe and reusable {@link lowentry.ue4.libs.jackson.databind.ObjectReader}
and {@link lowentry.ue4.libs.jackson.databind.ObjectWriter} objects.

In addition to simple reading and writing of JSON as POJOs or JSON trees (represented as
{@link lowentry.ue4.libs.jackson.databind.JsonNode}, and configurability needed to change aspects
of reading/writing, mapper contains additional functionality such as:

 Value conversions using {@link lowentry.ue4.libs.jackson.databind.ObjectMapper#convertValue(Object, Class)},
  {@link lowentry.ue4.libs.jackson.databind.ObjectMapper#valueToTree(Object)} and
  {@link lowentry.ue4.libs.jackson.databind.ObjectMapper#treeToValue(lowentry.ue4.libs.jackson.core.TreeNode, Class)} methods.
  
 Type introspection needed for things like generation of Schemas (like JSON Schema, Avro Schema, or protoc
   definitions), using {@link lowentry.ue4.libs.jackson.databind.ObjectMapper#acceptJsonFormatVisitor(Class, com.fasterxml.jackson.databind.jsonFormatVisitors.JsonFormatVisitorWrapper)}
   (note: actual handles are usually provided by various Jackson modules: mapper simply initiates calling of
   callbacks, based on serializers registered)
  


Simplest usage is of form:
  final ObjectMapper mapper = new ObjectMapper(); // can use static singleton, inject: just make sure to reuse!
  MyValue value = new MyValue();
  // ... and configure
  File newState = new File("my-stuff.json");
  mapper.writeValue(newState, value); // writes JSON serialization of MyValue instance
  // or, read
  MyValue older = mapper.readValue(new File("my-older-stuff.json"), MyValue.class);

  // Or if you prefer JSON Tree representation:
  JsonNode root = mapper.readTree(newState);
  // and find values by, for example, using a {@link lowentry.ue4.libs.jackson.core.JsonPointer} expression:
  int age = root.at("/personal/age").getValueAsInt(); 


For more usage, refer to
{@link lowentry.ue4.libs.jackson.databind.ObjectMapper},
{@link lowentry.ue4.libs.jackson.databind.ObjectReader} and
{@link lowentry.ue4.libs.jackson.databind.ObjectWriter}
Javadocs.
*/

package lowentry.ue4.libs.jackson.databind;