-
Notifications
You must be signed in to change notification settings - Fork 32
Custom Handlers
While the main configuration mechanism are the [Standard Features](JSON Features)), there are certain things you can customize by providing custom handers.
All these features are registered by using fluent with(...) method of JSON: result is a new JSON instance, configured to use specified handler. Calls are often chained, and resulting JSON may be cached, reused; or just discarded, as instances are light-weight and there is no overhead being cost of the Object construction itself.
It is possible to configure a standard Jackson streaming PrettyPrinter to use, instead of the default one:
JSON j = JSON.std.with(new CustomPrettyPrinter());MapBuilder is a helper object used for construction java.util.Map instances when binding JSON as Maps. One reason would be to use a specialized map like TreeMap, instead of LinkedHashMap; or to provide a more efficient read-only variant for small instances.
JSON j = JSON.std.with(new CustomMapBuilder());Similar to MapBuilder, it is possible to change kind of java.util.Collection constructed:
JSON j = JSON.std.with(new CustomCollectionBuilder());It is possible to register TreeCodec, which would let a Tree Models (like Jackson JsonNode) be recognized and handled automatically by Jackson jr:
JSON j = JSON.std.with(myTreeCodec);To change the underlying Streaming API implementation -- for example, to support non-JSON output, like Smile, CBOR or YAML, you can register alternate factory for JSON:
JSON y = JSON.std.with(new YAMLFactory());While it is not possible to register custom deserializers, it is possible to wholesale replace the handler responsible for binding JSON as Objects: this is what JSONReader entity is for.
You can do this by changing default instance used; custom instance has to be a sub-class with suitable overrides:
JSON j = JSON.std.with(new MyJSONReader());While it is not possible to register custom serializers, it is possible to wholesale replace the handler responsible for writing Objects as JSON: this is what JSONWriter entity is for.
You can do this by changing default instance used; custom instance has to be a sub-class with suitable overrides:
JSON j = JSON.std.with(new MyJSONWriter());