All Downloads are FREE. Search and download functionalities are using the official Maven repository.

net.minidev.json.actions.navigate.NavigateAction Maven / Gradle / Ivy

Go to download

JSON (JavaScript Object Notation) is a lightweight data-interchange format. It is easy for humans to read and write. It is easy for machines to parse and generate. It is based on a subset of the JavaScript Programming Language, Standard ECMA-262 3rd Edition - December 1999. JSON is a text format that is completely language independent but uses conventions that are familiar to programmers of the C-family of languages, including C, C++, C#, Java, JavaScript, Perl, Python, and many others. These properties make JSON an ideal data-interchange language.

There is a newer version: 2.5.1
Show newest version
package net.minidev.json.actions.navigate;

import net.minidev.json.actions.path.TreePath;

import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * An interface for a processing action on the nodes of a {@link M} while navigating its branches.
 * 

 * See package-info for more details
 *
 * @author [email protected]
 * @since 15 June 2016
 */
public interface NavigateAction, L extends List> {
	/**
	 * called before navigation of a new path starts
	 * @param path TODO
	 * @return true if the specified path should be navigated
	 */
	boolean pathStart(String path);

	/**
	 * called before any navigation of the {@link M} starts
	 * 
	 * @param objectToNavigate TODO
	 * @param pathsToNavigate TODO
	 * 
	 * @return true if navigation should start at all
	 */
	boolean start(M objectToNavigate, Collection pathsToNavigate);

	/**
	 * reached end of branch in source before end of specified path -
	 * the specified path does not exist in the source
	 * 
	 * @param tp TODO
	 * @param source TODO
	 */
	void pathTailNotFound(TreePath tp, Object source);

	/**
	 * called after the navigation of a path ends
	 * 
	 * @param path TODO
	 */
	void pathEnd(String path);

	/**
	 * called if navigation of a path throws an exception
	 * 
	 * @param path TODO
	 * @param e TODO
	 * @return true if the failure on this path should not abort the rest of the navigation
	 */
	boolean failSilently(String path, Exception e);

	/**
	 * called if navigation of a path throws an exception
	 * 
	 * @param path TODO
	 * @param e TODO
	 * @return true if the failure on this path should abort the rest of the navigation
	 */
	boolean failFast(String path, Exception e);

	/**
	 * called when an object node is encountered on the path
	 * 
	 * @param tp TODO
	 * @param sourceNode TODO
	 * @return true if the navigator should navigate into the object
	 */
	boolean recurInto(TreePath tp, M sourceNode);

	/**
	 * called when an array node is encountered on the path
	 * 
	 * @param tp TODO
	 * @param sourceNode TODO
	 * @return true if the navigator should navigate into the array
	 */
	boolean recurInto(TreePath tp, L sourceNode);

	/**
	 * reached leaf node (not a container) in source but specified path expects children -
	 * the specified path does not exist in the source
	 * @param jp TODO
	 * @param obj TODO
	 */
	void foundLeafBeforePathEnd(TreePath jp, Object obj);

	/**
	 * called when a leaf node is reached in a M.
	 * a leaf in a M is a key-value pair where the value is not a container itself
	 * (it is not a M nor a L)
	 * @param tp - the JsonPath pointing to the leaf
	 * @param value TODO
	 */
	void handleLeaf(TreePath tp, Object value);

	/**
	 * called when a leaf in a L is reached.
	 * a leaf in a L is a non-container item
	 * (it is not a M nor a L)
	 * @param tp -
	 * @param arrIndex -
	 * @param arrItem - the item
	 */
	void handleLeaf(TreePath tp, int arrIndex, Object arrItem);

	/**
	 * called when navigation of an {@link M} type object ends
	 * @param tp the path pointing to the object
	 * @param m TODO
	 */
	void recurEnd(TreePath tp, M m);

	/**
	 * called when navigation of an {@link L} type object ends
	 * @param tp the path pointing to the object
	 * @param l TODO
	 */
	void recurEnd(TreePath tp, L l);

	/**
	 * called after all navigation ends, and just before the navigation method exits
	 */
	void end();

	/**
	 * holds the result of the navigation, as assigned by the action implementing this interface
	 * @return - result
	 */
	Object result();

}
    

    

    

            

    

            



    
    






    
© 2015 - 2024 Weber Informatics LLC | Privacy Policy