net.minidev.json.actions.traverse

Class RemoveElementsJsonAction

java.lang.Object

net.minidev.json.actions.traverse.RemoveElementsJsonAction

All Implemented Interfaces:

JSONTraverseAction, TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

public class RemoveElementsJsonAction
extends Object
implements JSONTraverseAction

Removes key:value elements from a JSONObject.

An element is not removed from the user-specified list once its processing is over, because it may appear in more than one node.

See package-info for more details

See unit tests for examples

Author:

adoneitan@gmail.com

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	allowDotChar
protected Map<String,Object>	elementsToRemove
protected net.minidev.json.JSONObject	result

Constructor Summary

Constructors

Constructor and Description
RemoveElementsJsonAction(Map<String,Object> elementsToRemove)
RemoveElementsJsonAction(Map<String,Object> elementsToRemove, boolean allowDotChar)

Method Summary

Modifier and Type	Method and Description
void	end() called after the traversal ends, and just before the #start(M) method exits
void	handleLeaf(String fullPathToContainingList, int listIndex, Object listItem) called for each leaf of an L list is encountered
void	handleLeaf(String pathToEntry, Map.Entry<String,Object> entry) called for each leaf of an M map is encountered
boolean	recurInto(String pathToEntry, net.minidev.json.JSONArray entryValue) called when a non-leaf item is encountered inside an object
boolean	recurInto(String pathToEntry, net.minidev.json.JSONObject entryValue) called when a non-leaf entry is encountered inside an object
boolean	removeEntry(String fullPathToEntry, Map.Entry<String,Object> entry) the last callback for each entry in an M map.
Object	result() holds the result of the traversal, as assigned by the action implementing this interface
boolean	start(net.minidev.json.JSONObject object) called before any traversal of the M tree starts
boolean	traverseEntry(String fullPathToEntry, Map.Entry<String,Object> entry) called when a new entry is encountered and before any processing is performed on it

Methods inherited from class java.lang.Object

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

Field Detail

result

protected net.minidev.json.JSONObject result

elementsToRemove

protected final Map<String,Object> elementsToRemove

allowDotChar

protected final boolean allowDotChar

Constructor Detail

RemoveElementsJsonAction

public RemoveElementsJsonAction(Map<String,Object> elementsToRemove,
                                boolean allowDotChar)

RemoveElementsJsonAction

public RemoveElementsJsonAction(Map<String,Object> elementsToRemove)

Method Detail

start

public boolean start(net.minidev.json.JSONObject object)

Description copied from interface: TreeTraverseAction

called before any traversal of the M tree starts

Specified by:

start in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

Returns:

true if traversal should start at all

removeEntry

public boolean removeEntry(String fullPathToEntry,
                           Map.Entry<String,Object> entry)

Description copied from interface: TreeTraverseAction

the last callback for each entry in an M map. if this method returns true the TreeTraverser removes the entry from the map. there is no further handling of the entry.

Specified by:

removeEntry in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

Returns:

true if the entry and its subtree should be removed from the M tree

traverseEntry

public boolean traverseEntry(String fullPathToEntry,
                             Map.Entry<String,Object> entry)

Description copied from interface: TreeTraverseAction

called when a new entry is encountered and before any processing is performed on it

Specified by:

traverseEntry in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

Returns:

true if the entry should be processed

recurInto

public boolean recurInto(String pathToEntry,
                         net.minidev.json.JSONObject entryValue)

Description copied from interface: TreeTraverseAction

called when a non-leaf entry is encountered inside an object

Specified by:

recurInto in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

Returns:

true if the non-leaf entry should be recursively traversed

recurInto

public boolean recurInto(String pathToEntry,
                         net.minidev.json.JSONArray entryValue)

Description copied from interface: TreeTraverseAction

called when a non-leaf item is encountered inside an object

Specified by:

recurInto in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

Returns:

true if the non-leaf item should be recursively traversed

handleLeaf

public void handleLeaf(String pathToEntry,
                       Map.Entry<String,Object> entry)

Description copied from interface: TreeTraverseAction

called for each leaf of an M map is encountered

Specified by:

handleLeaf in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

handleLeaf

public void handleLeaf(String fullPathToContainingList,
                       int listIndex,
                       Object listItem)

Description copied from interface: TreeTraverseAction

called for each leaf of an L list is encountered

Specified by:

handleLeaf in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

listIndex - - the ordered location of the item in the list

listItem - - the item

end

public void end()

Description copied from interface: TreeTraverseAction

called after the traversal ends, and just before the #start(M) method exits

Specified by:

end in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>

result

public Object result()

Description copied from interface: TreeTraverseAction

holds the result of the traversal, as assigned by the action implementing this interface

Specified by:

result in interface TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>