com.zackehh.dotnotes

Class DotNotes

java.lang.Object

com.zackehh.dotnotes.DotNotes

public class DotNotes
extends Object

The public access for DotNotes. This class allows for manipulation of $JsonNodes being passed in, either flattening, inflating or processing recursively. Also provides access to several dot notation utility methods, such as key parsing.

Method Summary

Modifier and Type	Method and Description
static com.fasterxml.jackson.databind.JsonNode	create(String path, com.fasterxml.jackson.databind.JsonNode value) A wrapper to $create(String, JsonNode, JsonNode), simply passing through parameters and appending `null` to the argument set.
static com.fasterxml.jackson.databind.JsonNode	create(String path, com.fasterxml.jackson.databind.JsonNode value, com.fasterxml.jackson.databind.JsonNode target) Uses a dot-noted path in order to create a given value in the given leaf of a tree.
static com.fasterxml.jackson.databind.node.ObjectNode	flatten(com.fasterxml.jackson.databind.JsonNode node) Flattens a $JsonNode down to a single level, using the $DotCursor to iterate through the keys, setting the paths as keys in an $ObjectNode.
static com.fasterxml.jackson.databind.JsonNode	get(String path, com.fasterxml.jackson.databind.JsonNode node) Uses a String path to create a List of keys in order to move through a nested $JsonNode in order to find a specific value.
static com.fasterxml.jackson.databind.JsonNode	inflate(com.fasterxml.jackson.databind.node.ObjectNode node) A wrapper to $inflate(ObjectNode, ObjectNode), simply passing through parameters and appending `null` to the argument set.
static com.fasterxml.jackson.databind.JsonNode	inflate(com.fasterxml.jackson.databind.node.ObjectNode node, com.fasterxml.jackson.databind.node.ObjectNode target) Inflates an $ObjectNode which has been flattened previously, returning a $JsonNode.
static List<NotedKey>	keys(String s) Takes a dot-noted String and converts it to a List of keys.
static void	notedCursor(com.fasterxml.jackson.databind.JsonNode node, NotedHandler handler) Passes the $JsonNode parameter and $NotedHandler to the $DotCursor.recurse(JsonNode, NotedHandler, String) method to do the heavy lifting.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static com.fasterxml.jackson.databind.JsonNode create(String path,
                                                             com.fasterxml.jackson.databind.JsonNode value)
                                                      throws ParseException

A wrapper to $create(String, JsonNode, JsonNode), simply passing through parameters and appending `null` to the argument set. It's a shorthand for lazy programmers (myself included).

Parameters:

path - the path to create

value - the value to set the path to

Returns:

the $JsonNode after key creation

Throws:

ParseException - if any parsing issues occur

create

public static com.fasterxml.jackson.databind.JsonNode create(String path,
                                                             com.fasterxml.jackson.databind.JsonNode value,
                                                             com.fasterxml.jackson.databind.JsonNode target)
                                                      throws ParseException

Uses a dot-noted path in order to create a given value in the given leaf of a tree. This can either create a new $JsonNode from scratch, or be used to populate a pre-existing one.

Parameters:

path - the path to create

value - the value to set the path to

target - the target $JsonNode to create into

Returns:

the $JsonNode after key creation

Throws:

ParseException - if any parsing issues occur

flatten

public static com.fasterxml.jackson.databind.node.ObjectNode flatten(com.fasterxml.jackson.databind.JsonNode node)

Flattens a $JsonNode down to a single level, using the $DotCursor to iterate through the keys, setting the paths as keys in an $ObjectNode.

Parameters:

node - the $JsonNode to flatten

Returns:

a flattened $ObjectNode

get

public static com.fasterxml.jackson.databind.JsonNode get(String path,
                                                          com.fasterxml.jackson.databind.JsonNode node)
                                                   throws ParseException

Uses a String path to create a List of keys in order to move through a nested $JsonNode in order to find a specific value. If the value is found, it is returned. If it can not be found, a $MissingNode will be returned.

Parameters:

path - the path to find the value for

node - the node to use for the search

Returns:

a $JsonNode if found, a $MissingNode if not

Throws:

ParseException - if any parsing issues occur

inflate

public static com.fasterxml.jackson.databind.JsonNode inflate(com.fasterxml.jackson.databind.node.ObjectNode node)
                                                       throws ParseException

A wrapper to $inflate(ObjectNode, ObjectNode), simply passing through parameters and appending `null` to the argument set. It's a shorthand for lazy programmers (myself included).

Parameters:

node - the $JsonNode to inflate

Returns:

an inflated $JsonNode instance

Throws:

ParseException - if any parsing issues occur

inflate

public static com.fasterxml.jackson.databind.JsonNode inflate(com.fasterxml.jackson.databind.node.ObjectNode node,
                                                              com.fasterxml.jackson.databind.node.ObjectNode target)
                                                       throws ParseException

Inflates an $ObjectNode which has been flattened previously, returning a $JsonNode. Uses $create(String, JsonNode, JsonNode) in order to take advantage of methods already available to us.

Parameters:

node - the node being inflated

target - a potential target object to inflate into

Returns:

an inflated $JsonNode

Throws:

ParseException - if any parsing issues occur

keys

public static List<NotedKey> keys(String s)
                           throws ParseException

Takes a dot-noted String and converts it to a List of keys. This method is by no means perfect, however it's stable enough for most usage. A List of $NotedKeys will be returned.

Parameters:

s - the String to parse

Returns:

a List of $NotedKeys

Throws:

ParseException - if any parsing issues occur

notedCursor

public static void notedCursor(com.fasterxml.jackson.databind.JsonNode node,
                               NotedHandler handler)

Passes the $JsonNode parameter and $NotedHandler to the $DotCursor.recurse(JsonNode, NotedHandler, String) method to do the heavy lifting. This method simply surfaces it to the outside world.

Parameters:

node - the node to iterate through

handler - the handler to use for processing