Interface DocTreeVisitor<R,P>

Type Parameters:
R - the return type of this visitor's methods. Use Void for visitors that do not need to return results.
P - the type of the additional parameter to this visitor's methods. Use Void for visitors that do not need an additional parameter.
All Known Implementing Classes:
DocTreePathScanner, DocTreeScanner, SimpleDocTreeVisitor

public interface DocTreeVisitor<R,P>
A visitor of trees, in the style of the visitor design pattern. Classes implementing this interface are used to operate on a tree when the kind of tree is unknown at compile time. When a visitor is passed to a tree's accept method, the visitXyz method most applicable to that tree is invoked.

Classes implementing this interface may or may not throw a NullPointerException if the additional parameter p is null; see documentation of the implementing class for details.

WARNING: It is possible that methods will be added to this interface to accommodate new, currently unknown, doc comment structures added to future versions of the Java programming language. Therefore, visitor classes directly implementing this interface may be source incompatible with future versions of the platform.

Since:
1.8
  • Method Details Link icon

    • visitAttribute Link icon

      R visitAttribute(AttributeTree node, P p)
      Visits an AttributeTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitAuthor Link icon

      R visitAuthor(AuthorTree node, P p)
      Visits an AuthorTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitComment Link icon

      R visitComment(CommentTree node, P p)
      Visits a CommentTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitDeprecated Link icon

      R visitDeprecated(DeprecatedTree node, P p)
      Visits a DeprecatedTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitDocComment Link icon

      R visitDocComment(DocCommentTree node, P p)
      Visits a DocCommentTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitDocRoot Link icon

      R visitDocRoot(DocRootTree node, P p)
      Visits a DocRootTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitDocType Link icon

      default R visitDocType(DocTypeTree node, P p)
      Visits a DocTypeTree node.
      Implementation Requirements:
      Visits the provided DocTypeTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      10
    • visitEndElement Link icon

      R visitEndElement(EndElementTree node, P p)
      Visits an EndElementTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitEntity Link icon

      R visitEntity(EntityTree node, P p)
      Visits an EntityTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitErroneous Link icon

      R visitErroneous(ErroneousTree node, P p)
      Visits an ErroneousTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitEscape Link icon

      default R visitEscape(EscapeTree node, P p)
      Visits an EscapeTree node.
      Implementation Requirements:
      Visits the provided EscapeTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      21
    • visitHidden Link icon

      default R visitHidden(HiddenTree node, P p)
      Visits a HiddenTree node.
      Implementation Requirements:
      Visits the provided HiddenTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      9
    • visitIdentifier Link icon

      R visitIdentifier(IdentifierTree node, P p)
      Visits an IdentifierTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitIndex Link icon

      default R visitIndex(IndexTree node, P p)
      Visits an IndexTree node.
      Implementation Requirements:
      Visits the provided IndexTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      9
    • visitInheritDoc Link icon

      R visitInheritDoc(InheritDocTree node, P p)
      Visits an InheritDocTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitLink Link icon

      R visitLink(LinkTree node, P p)
      Visits a LinkTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitLiteral Link icon

      R visitLiteral(LiteralTree node, P p)
      Visits an LiteralTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitParam Link icon

      R visitParam(ParamTree node, P p)
      Visits a ParamTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitProvides Link icon

      default R visitProvides(ProvidesTree node, P p)
      Visits a ProvidesTree node.
      Implementation Requirements:
      Visits the provided ProvidesTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      9
    • visitRawText Link icon

      default R visitRawText(RawTextTree node, P p)
      Visits a RawTextTree node.
      Implementation Requirements:
      Visits the provided RawTextTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      23
    • visitReference Link icon

      R visitReference(ReferenceTree node, P p)
      Visits a ReferenceTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitReturn Link icon

      R visitReturn(ReturnTree node, P p)
      Visits a ReturnTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitSee Link icon

      R visitSee(SeeTree node, P p)
      Visits a SeeTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitSerial Link icon

      R visitSerial(SerialTree node, P p)
      Visits a SerialTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitSerialData Link icon

      R visitSerialData(SerialDataTree node, P p)
      Visits a SerialDataTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitSerialField Link icon

      R visitSerialField(SerialFieldTree node, P p)
      Visits a SerialFieldTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitSince Link icon

      R visitSince(SinceTree node, P p)
      Visits a SinceTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitSnippet Link icon

      default R visitSnippet(SnippetTree node, P p)
      Visits a SnippetTree node.
      Implementation Requirements:
      Visits the provided SnippetTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      18
    • visitSpec Link icon

      default R visitSpec(SpecTree node, P p)
      Visits a SpecTree node.
      Implementation Requirements:
      Visits the provided SpecTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      20
    • visitStartElement Link icon

      R visitStartElement(StartElementTree node, P p)
      Visits a StartElementTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitSummary Link icon

      default R visitSummary(SummaryTree node, P p)
      Visits a SummaryTree node.
      Implementation Requirements:
      Visits the provided SummaryTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      10
    • visitSystemProperty Link icon

      default R visitSystemProperty(SystemPropertyTree node, P p)
      Visits a SystemPropertyTree node.
      Implementation Requirements:
      Visits the provided SystemPropertyTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      12
    • visitText Link icon

      R visitText(TextTree node, P p)
      Visits a TextTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitThrows Link icon

      R visitThrows(ThrowsTree node, P p)
      Visits a ThrowsTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitUnknownBlockTag Link icon

      R visitUnknownBlockTag(UnknownBlockTagTree node, P p)
      Visits an UnknownBlockTagTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitUnknownInlineTag Link icon

      R visitUnknownInlineTag(UnknownInlineTagTree node, P p)
      Visits an UnknownInlineTagTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitUses Link icon

      default R visitUses(UsesTree node, P p)
      Visits a UsesTree node.
      Implementation Requirements:
      Visits a UsesTree node by calling visitOther(node, p).
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
      Since:
      9
    • visitValue Link icon

      R visitValue(ValueTree node, P p)
      Visits a ValueTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitVersion Link icon

      R visitVersion(VersionTree node, P p)
      Visits a VersionTree node.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value
    • visitOther Link icon

      R visitOther(DocTree node, P p)
      Visits an unknown type of DocTree node. This can occur if the set of tags evolves and new kinds of nodes are added to the DocTree hierarchy.
      Parameters:
      node - the node being visited
      p - a parameter value
      Returns:
      a result value