graphql.util.TraverserContext Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of graphql-java Show documentation

GraphqL Java

There is a newer version: 230521-nf-execution

package graphql.util;

import graphql.PublicApi;

import java.util.Set;

/**
 * Traversal context
 *
 * @param  type of tree node
 */
@PublicApi
public interface TraverserContext {
    /**
     * Returns current node being visited
     *
     * @return current node traverser is visiting
     */
    T thisNode();

    /**
     * Returns parent context.
     * Effectively organizes Context objects in a linked list so
     * by following {@link #getParentContext() } links one could obtain
     * the current path as well as the variables {@link #getVar(java.lang.Class) }
     * stored in every parent context.
     *
     * @return context associated with the node parent
     */
    TraverserContext getParentContext();

    /**
     * The result of the {@link #getParentContext()}.
     *
     * @return the parent result
     */
    Object getParentResult();

    /**
     * Informs that the current node has been already "visited"
     *
     * @return {@code true} if a node had been already visited
     */
    boolean isVisited();

    /**
     * Obtains all visited nodes and values received by the {@link TraverserVisitor#enter(graphql.util.TraverserContext) }
     * method
     *
     * @return a map containg all nodes visited and values passed when visiting nodes for the first time
     */
    Set visitedNodes();

    /**
     * Obtains a context local variable
     *
     * @param  type of the variable
     * @param key key to lookup the variable value
     *
     * @return a variable value of {@code null}
     */
     S getVar(Class key);

    /**
     * Stores a variable in the context
     *
     * @param    type of a varable
     * @param key   key to create bindings for the variable
     * @param value value of variable
     *
     * @return this context to allow operations chaining
     */
     TraverserContext setVar(Class key, S value);


    /**
     * Set the result for this TraverserContext.
     *
     * @param result to set
     */
    void setResult(Object result);

    /**
     * The result of this TraverserContext..
     *
     * @return the result
     */
    Object getResult();

    /**
     * Used to share something across all TraverserContext.
     *
     * @return the initial data
     */
    Object getInitialData();

}