Class LocatePathsJsonAction
java.lang.Object
net.minidev.json.actions.traverse.LocatePathsJsonAction
- All Implemented Interfaces:
JSONTraverseAction,TreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>
Searches for paths in a
JSONObject and returns those found
A path is not removed from the user-specified list once its processing is over, because identical objects in the same array are supported by this action.
See package-info for more details
See unit tests for examples
- Author:
- adoneitan@gmail.com
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidend()called after the traversal ends, and just before theTreeTraverseAction.start(M)method exitsvoidhandleLeaf(String fullPathToContainingList, int listIndex, Object listItem) called for each leaf of an L list is encounteredvoidhandleLeaf(String pathToEntry, Map.Entry<String, Object> entry) called for each leaf of an M map is encounteredbooleancalled when a non-leaf item is encountered inside an L objectbooleancalled when a non-leaf entry is encountered inside an M objectbooleanremoveEntry(String fullPathToEntry, Map.Entry<String, Object> entry) the last callback for each entry in anTreeTraverseActionmap. if this method returns true theTreeTraverserremoves the entry from the map. there is no further handling of the entry.result()holds the result of the traversal, as assigned by the action implementing this interfacebooleanstart(net.minidev.json.JSONObject object) called before any traversal of theTreeTraverseActiontree startsbooleantraverseEntry(String fullPathToEntry, Map.Entry<String, Object> entry) called when a new entry is encountered and before any processing is performed on it
-
Field Details
-
pathsFound
-
pathsToFind
-
delim
-
-
Constructor Details
-
LocatePathsJsonAction
- Parameters:
pathsToFind- A path to a field in theJSONObjectshould be specified in n-gram format where keys are chained: k0[[[.k1].k2]...]delim- -
-
-
Method Details
-
start
public boolean start(net.minidev.json.JSONObject object) Description copied from interface:TreeTraverseActioncalled before any traversal of theTreeTraverseActiontree starts- Specified by:
startin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray> - Parameters:
object- TODO- Returns:
- true if traversal should start at all
-
traverseEntry
Description copied from interface:TreeTraverseActioncalled when a new entry is encountered and before any processing is performed on it- Specified by:
traverseEntryin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray> - Parameters:
fullPathToEntry- TODOentry- TODO- Returns:
- true if the entry should be processed
-
recurInto
Description copied from interface:TreeTraverseActioncalled when a non-leaf entry is encountered inside an M object- Specified by:
recurIntoin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray> - Parameters:
pathToEntry- TODOentryValue- TODO- Returns:
- true if the non-leaf entry should be recursively traversed
-
recurInto
Description copied from interface:TreeTraverseActioncalled when a non-leaf item is encountered inside an L object- Specified by:
recurIntoin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray> - Parameters:
pathToEntry- TODOentryValue- TODO- Returns:
- true if the non-leaf item should be recursively traversed
-
handleLeaf
Description copied from interface:TreeTraverseActioncalled for each leaf of an M map is encountered- Specified by:
handleLeafin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray> - Parameters:
pathToEntry- TODOentry- TODO
-
handleLeaf
Description copied from interface:TreeTraverseActioncalled for each leaf of an L list is encountered- Specified by:
handleLeafin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray> - Parameters:
fullPathToContainingList- - the itemlistIndex- - the ordered location of the item in the listlistItem- -
-
removeEntry
Description copied from interface:TreeTraverseActionthe last callback for each entry in anTreeTraverseActionmap. if this method returns true theTreeTraverserremoves the entry from the map. there is no further handling of the entry.- Specified by:
removeEntryin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray> - Parameters:
fullPathToEntry- TODOentry- TODO- Returns:
- true if the entry and its subtree should be removed from the M tree
-
end
public void end()Description copied from interface:TreeTraverseActioncalled after the traversal ends, and just before theTreeTraverseAction.start(M)method exits- Specified by:
endin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray>
-
result
Description copied from interface:TreeTraverseActionholds the result of the traversal, as assigned by the action implementing this interface- Specified by:
resultin interfaceTreeTraverseAction<net.minidev.json.JSONObject,net.minidev.json.JSONArray> - Returns:
- result
-