Class TraversalHelper


  • public final class TraversalHelper
    extends Object
    Author:
    Marko A. Rodriguez (http://markorodriguez.com), Stephen Mallette (http://stephen.genoprime.com)
    • Method Detail

      • isLocalProperties

        public static boolean isLocalProperties​(Traversal.Admin<?,​?> traversal)
      • isLocalStarGraph

        public static boolean isLocalStarGraph​(Traversal.Admin<?,​?> traversal)
      • insertBeforeStep

        public static <S,​E> void insertBeforeStep​(Step<S,​E> insertStep,
                                                        Step<E,​?> afterStep,
                                                        Traversal.Admin<?,​?> traversal)
        Insert a step before a specified step instance.
        Parameters:
        insertStep - the step to insert
        afterStep - the step to insert the new step before
        traversal - the traversal on which the action should occur
      • insertAfterStep

        public static <S,​E> void insertAfterStep​(Step<S,​E> insertStep,
                                                       Step<?,​S> beforeStep,
                                                       Traversal.Admin<?,​?> traversal)
        Insert a step after a specified step instance.
        Parameters:
        insertStep - the step to insert
        beforeStep - the step to insert the new step after
        traversal - the traversal on which the action should occur
      • replaceStep

        public static <S,​E> void replaceStep​(Step<S,​E> removeStep,
                                                   Step<S,​E> insertStep,
                                                   Traversal.Admin<?,​?> traversal)
        Replace a step with a new step.
        Parameters:
        removeStep - the step to remove
        insertStep - the step to insert
        traversal - the traversal on which the action will occur
      • insertTraversal

        public static <S,​E> Step<?,​E> insertTraversal​(int insertIndex,
                                                                  Traversal.Admin<S,​E> insertTraversal,
                                                                  Traversal.Admin<?,​?> traversal)
      • removeToTraversal

        public static <S,​E> void removeToTraversal​(Step<S,​?> startStep,
                                                         Step<?,​E> endStep,
                                                         Traversal.Admin<S,​E> newTraversal)
      • stepIndex

        public static <S,​E> int stepIndex​(Step<S,​E> step,
                                                Traversal.Admin<?,​?> traversal)
        Gets the index of a particular step in the Traversal.
        Parameters:
        step - the step to retrieve the index for
        traversal - the traversal to perform the action on
        Returns:
        the index of the step or -1 if the step is not present
      • getStepsOfClass

        public static <S> List<S> getStepsOfClass​(Class<S> stepClass,
                                                  Traversal.Admin<?,​?> traversal)
      • getStepsOfAssignableClass

        public static <S> List<S> getStepsOfAssignableClass​(Class<S> stepClass,
                                                            Traversal.Admin<?,​?> traversal)
      • getLastStepOfAssignableClass

        public static <S> Optional<S> getLastStepOfAssignableClass​(Class<S> stepClass,
                                                                   Traversal.Admin<?,​?> traversal)
      • getFirstStepOfAssignableClass

        public static <S> Optional<S> getFirstStepOfAssignableClass​(Class<S> stepClass,
                                                                    Traversal.Admin<?,​?> traversal)
      • getStepsOfAssignableClassRecursively

        public static <S> List<S> getStepsOfAssignableClassRecursively​(Class<S> stepClass,
                                                                       Traversal.Admin<?,​?> traversal)
      • getStepsOfAssignableClassRecursively

        public static <S> List<S> getStepsOfAssignableClassRecursively​(Scope scope,
                                                                       Class<S> stepClass,
                                                                       Traversal.Admin<?,​?> traversal)
      • getStepsOfAssignableClassRecursively

        public static List<Step<?,​?>> getStepsOfAssignableClassRecursively​(Traversal.Admin<?,​?> traversal,
                                                                                 Class<?>... stepClasses)
        Get steps of the specified classes throughout the traversal.
      • isGlobalChild

        public static boolean isGlobalChild​(Traversal.Admin<?,​?> traversal)
      • hasStepOfClass

        public static boolean hasStepOfClass​(Class stepClass,
                                             Traversal.Admin<?,​?> traversal)
        Determine if the traversal has a step of a particular class.
        Parameters:
        stepClass - the step class to look for
        traversal - the traversal to perform the action on
        Returns:
        true if the class is found and false otherwise
      • hasStepOfAssignableClass

        public static boolean hasStepOfAssignableClass​(Class superClass,
                                                       Traversal.Admin<?,​?> traversal)
        Determine if the traversal has a step of an assignable class.
        Parameters:
        superClass - the step super class to look for
        traversal - the traversal to perform the action on
        Returns:
        true if the class is found and false otherwise
      • hasStepOfAssignableClassRecursively

        public static boolean hasStepOfAssignableClassRecursively​(Class stepClass,
                                                                  Traversal.Admin<?,​?> traversal)
        Determine if the traversal has a step of an assignable class in the current Traversal and its local and global child traversals.
        Parameters:
        stepClass - the step class to look for
        traversal - the traversal in which to look for the given step class
        Returns:
        true if any step in the given traversal (and its child traversals) is an instance of the given stepClass, otherwise false.
      • hasStepOfAssignableClassRecursively

        public static boolean hasStepOfAssignableClassRecursively​(Scope scope,
                                                                  Class stepClass,
                                                                  Traversal.Admin<?,​?> traversal)
        Determine if the traversal has a step of an assignable class in the current Traversal and its Scope child traversals.
        Parameters:
        scope - the child traversal scope to check
        stepClass - the step class to look for
        traversal - the traversal in which to look for the given step class
        Returns:
        true if any step in the given traversal (and its child traversals) is an instance of the given stepClass, otherwise false.
      • hasStepOfAssignableClassRecursively

        public static boolean hasStepOfAssignableClassRecursively​(Collection<Class> stepClasses,
                                                                  Traversal.Admin<?,​?> traversal)
        Determine if the traversal has any of the supplied steps of an assignable class in the current Traversal and its global or local child traversals.
        Parameters:
        stepClasses - the step classes to look for
        traversal - the traversal in which to look for the given step classes
        Returns:
        true if any step in the given traversal (and its child traversals) is an instance of a class provided in stepClasses, otherwise false.
      • hasStepOfAssignableClassRecursively

        public static boolean hasStepOfAssignableClassRecursively​(Scope scope,
                                                                  Collection<Class> stepClasses,
                                                                  Traversal.Admin<?,​?> traversal)
        Determine if the traversal has any of the supplied steps of an assignable class in the current Traversal and its Scope child traversals.
        Parameters:
        scope - whether to check global or local children (null for both).
        stepClasses - the step classes to look for
        traversal - the traversal in which to look for the given step classes
        Returns:
        true if any step in the given traversal (and its child traversals) is an instance of a class provided in stepClasses, otherwise false.
      • anyStepRecursively

        public static boolean anyStepRecursively​(Predicate<Step> predicate,
                                                 Traversal.Admin<?,​?> traversal)
        Determine if any step in Traversal or its children match the step given the provided Predicate.
        Parameters:
        predicate - the match function
        traversal - the traversal to perform the action on
        Returns:
        true if there is a match and false otherwise
      • anyStepRecursively

        public static boolean anyStepRecursively​(Predicate<Step> predicate,
                                                 TraversalParent step)
        Determine if any child step of a TraversalParent match the step given the provided Predicate.
        Parameters:
        predicate - the match function
        step - the step to perform the action on
        Returns:
        true if there is a match and false otherwise
      • applyTraversalRecursively

        public static void applyTraversalRecursively​(Consumer<Traversal.Admin<?,​?>> consumer,
                                                     Traversal.Admin<?,​?> traversal)
        Apply the provider Consumer function to the provided Traversal and all of its children.
        Parameters:
        consumer - the function to apply to the each traversal in the tree
        traversal - the root traversal to start application
      • applyTraversalRecursively

        public static void applyTraversalRecursively​(Consumer<Traversal.Admin<?,​?>> consumer,
                                                     Traversal.Admin<?,​?> traversal,
                                                     boolean applyToChildrenOnly)
        Apply the provider Consumer function to the provided Traversal and all of its children.
        Parameters:
        consumer - the function to apply to the each traversal in the tree
        traversal - the root traversal to start application
      • addToCollection

        public static <S> void addToCollection​(Collection<S> collection,
                                               S s,
                                               long bulk)
      • getShortName

        public static String getShortName​(Step step,
                                          int maxLength)
        Returns the name of step truncated to maxLength. An ellipses is appended when the name exceeds maxLength.
        Parameters:
        step -
        maxLength - Includes the 3 "..." characters that will be appended when the length of the name exceeds maxLength.
        Returns:
        short step name.
      • hasLabels

        public static boolean hasLabels​(Traversal.Admin<?,​?> traversal)
      • onGraphComputer

        public static boolean onGraphComputer​(Traversal.Admin<?,​?> traversal)
      • removeAllSteps

        public static void removeAllSteps​(Traversal.Admin<?,​?> traversal)
      • copyLabels

        public static void copyLabels​(Step<?,​?> fromStep,
                                      Step<?,​?> toStep,
                                      boolean moveLabels)
      • hasAllStepsOfClass

        public static boolean hasAllStepsOfClass​(Traversal.Admin<?,​?> traversal,
                                                 Class<?>... classesToCheck)
      • hasStepOfClass

        public static boolean hasStepOfClass​(Traversal.Admin<?,​?> traversal,
                                             Class<?>... classesToCheck)
      • applySingleLevelStrategies

        @Deprecated
        public static void applySingleLevelStrategies​(Traversal.Admin<?,​?> parentTraversal,
                                                      Traversal.Admin<?,​?> childTraversal,
                                                      Class<? extends TraversalStrategy> stopAfterStrategy)
        Deprecated.
        As of release 3.5.2, not replaced as strategies are not applied in this fashion after 3.5.0
      • addHasContainer

        public static <T extends Traversal.Admin<?,​?>> T addHasContainer​(T traversal,
                                                                               HasContainer hasContainer)
        Used to left-fold a HasContainer to a HasContainerHolder if it exists. Else, append a HasStep.
        Type Parameters:
        T - the traversal type
        Parameters:
        traversal - the traversal to fold or append.
        hasContainer - the container to add left or append.
        Returns:
        the has container folded or appended traversal