Package org.openrewrite

Class TreeVisitor<T extends Tree,P>

java.lang.Object
org.openrewrite.TreeVisitor<T,P>
Type Parameters:
T - The type of tree.
P - An input object that is passed to every visit method.
Direct Known Subclasses:
BinaryVisitor, FindRecipeRunException, HasSourcePath, PlainTextVisitor, QuarkVisitor, RemoteVisitor
public abstract class TreeVisitor<T extends Tree,P> extends Object
Abstract TreeVisitor for processing elements

Always returns input type T provides Parameterizable P input which is mutable allowing context to be shared

postProcessing via afterVisit for conditionally chaining other operations with the expectation is that after TreeVisitors are invoked immediately after visiting SourceFile

  • Constructor Details

    • TreeVisitor

      public TreeVisitor()

  • Method Details

    • noop

      public static <T extends Tree, P> TreeVisitor<T,P> noop()

    • isAcceptable

      public boolean isAcceptable(SourceFile sourceFile, P p)

    • setCursor

      public void setCursor(@Nullable @Nullable Cursor cursor)

    • getLanguage

      @Nullable public @Nullable String getLanguage()
      Returns:
      Describes the language type that this visitor applies to, e.g. java, xml, properties.

    • doAfterVisit

      protected void doAfterVisit(TreeVisitor<T,P> visitor)
      Execute the visitor once after the whole source file has been visited. The visitor is executed against the whole source file. This operation only happens once immediately after the containing visitor visits the whole source file. A subsequent Recipe cycle will not run it.

      This method is ideal for one-off operations like auto-formatting, adding/removing imports, etc.

      Parameters:
      visitor - The visitor to run.

    • doAfterVisit

      protected void doAfterVisit(Recipe recipe)
      Execute the recipe's main visitor once after the whole source file has been visited. The visitor is executed against the whole source file. This operation only happens once immediately after the containing visitor visits the whole source file. A subsequent Recipe cycle will not run it.

      This method is ideal for one-off operations like auto-formatting, adding/removing imports, etc.

      Parameters:
      recipe - The recipe whose visitor to run.

    • getAfterVisit

      protected List<TreeVisitor<T,P>> getAfterVisit()

    • getCursor

      public final Cursor getCursor()

    • preVisit

      @Nullable public T preVisit(T tree, P p)

    • postVisit

      @Nullable public T postVisit(T tree, P p)

    • visit

      @Nullable public T visit(@Nullable @Nullable Tree tree, P p, Cursor parent)

    • visitSourceFile

      @Nullable public T visitSourceFile(SourceFile sourceFile, P p)

    • visitNonNull

      public T visitNonNull(Tree tree, P p)
      By calling this method, you are asserting that you know that the outcome will be non-null when the compiler couldn't otherwise prove this to be the case. This method is a shortcut for having to assert the non-nullability of the returned tree.
      Parameters:
      tree - A non-null tree.
      p - A state object that passes through the visitor.
      Returns:
      A non-null tree.

    • visitNonNull

      public T visitNonNull(Tree tree, P p, Cursor parent)

    • collect

      @Incubating(since="7.31.0") public static <R extends Tree, C extends Collection<R>> C collect(TreeVisitor<?,ExecutionContext> visitor, Tree tree, C initial)

    • collect

      @Incubating(since="7.31.0") public static <U extends Tree, R, C extends Collection<R>> C collect(TreeVisitor<?,ExecutionContext> visitor, Tree tree, C initial, Class<U> matchOn, Function<U,R> map)

    • reduce

      @Incubating(since="7.31.0") public P reduce(Iterable<? extends Tree> trees, P p)

    • reduce

      @Incubating(since="7.31.0") public P reduce(Tree tree, P p)

    • reduce

      @Incubating(since="7.31.0") public P reduce(Tree tree, P p, Cursor parent)

    • visit

      @Nullable public T visit(@Nullable @Nullable Tree tree, P p)

    • visit

      public void visit(@Nullable @Nullable List<? extends T> nodes, P p)

    • defaultValue

      @Nullable public T defaultValue(@Nullable @Nullable Tree tree, P p)

    • visitAndCast

      @Incubating(since="7.0.0") protected final <T2 extends Tree> T2 visitAndCast(T2 t, P p, BiFunction<T2,P,Tree> callSuper)

    • visitAndCast

      @Incubating(since="7.0.0") @Nullable protected final <T2 extends T> T2 visitAndCast(@Nullable @Nullable Tree tree, P p)

    • visitMarkers

      public Markers visitMarkers(Markers markers, P p)

    • visitMarker

      @Incubating(since="7.2.0") public <M extends Marker> M visitMarker(Marker marker, P p)

    • isAdaptableTo

      public boolean isAdaptableTo(Class<? extends TreeVisitor> adaptTo)

    • adapt

      public <R extends Tree, V extends TreeVisitor<R, P>> V adapt(Class<? extends V> adaptTo)

    • describeLocation

      @Nullable protected @Nullable String describeLocation(Cursor cursor)