import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
/**
 * Called when a complete comment has been scanned. pos and endPos
 * will mark the comment boundary.
 */
protected Tokens.Comment processComment(int pos, int endPos, CommentStyle style) {
    if (scannerDebug)
        System.out.println("processComment(" + pos
                           + "," + endPos + "," + style + ")=|"
                           + new String(reader.getRawCharacters(pos, endPos))
                           + "|");
    char[] buf = reader.getRawCharacters(pos, endPos);
    return new BasicComment<UnicodeReader>(new UnicodeReader(fac, buf, buf.length), style);
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
@Override
public String getText() {
    if (!scanned && cs == CommentStyle.JAVADOC) {
        scanDocComment();
    }
    return docComment;
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
/**
 * Called when a complete comment has been scanned. pos and endPos
 * will mark the comment boundary.
 */
protected Tokens.Comment processComment(int pos, int endPos, CommentStyle style) {
    if (scannerDebug)
        System.out.println("processComment(" + pos
                           + "," + endPos + "," + style + ")=|"
                           + new String(reader.getRawCharacters(pos, endPos))
                           + "|");
    char[] buf = reader.getRawCharacters(pos, endPos);
    return new BasicComment<>(new UnicodeReader(fac, buf, buf.length), style);
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
@Override @DefinedBy(Api.COMPILER_TREE)
public DCDocComment newDocCommentTree(List<? extends DocTree> fullBody, List<? extends DocTree> tags) {
    ListBuffer<DCTree> lb = new ListBuffer<>();
    lb.addAll(cast(fullBody));
    List<DCTree> fBody = lb.toList();

    // A dummy comment to keep the diagnostics logic happy.
    Comment c = new Comment() {
        @Override
        public String getText() {
            return null;
        }

        @Override
        public int getSourcePos(int index) {
            return Position.NOPOS;
        }

        @Override
        public CommentStyle getStyle() {
            return CommentStyle.JAVADOC;
        }

        @Override
        public boolean isDeprecated() {
            return false;
        }
    };
    Pair<List<DCTree>, List<DCTree>> pair = splitBody(fullBody);
    DCDocComment tree = new DCDocComment(c, fBody, pair.fst, pair.snd, cast(tags));
    return tree;
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
private Comment comment(String docString) {
    StringBuilder docComment = new StringBuilder()
                               .append("/**")
                               .append(docString)
                               .append("*/");
    Scanner scanner = scanners.newScanner(docComment, true);
    scanner.nextToken();
    Token token = scanner.token();
    return token.comment(CommentStyle.JAVADOC);
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
@Override @DefinedBy(Api.COMPILER_TREE)
public DCDocComment newDocCommentTree(List<? extends DocTree> firstSentence, List<? extends DocTree> body, List<? extends DocTree> tags) {
    ListBuffer<DCTree> lb = new ListBuffer<>();
    lb.addAll(cast(firstSentence));
    lb.addAll(cast(body));
    List<DCTree> fullBody = lb.toList();

    // A dummy comment to keep the diagnostics logic happy.
    Comment c = new Comment() {
        @Override
        public String getText() {
            return null;
        }

        @Override
        public int getSourcePos(int index) {
            return Position.NOPOS;
        }

        @Override
        public CommentStyle getStyle() {
            return CommentStyle.JAVADOC;
        }

        @Override
        public boolean isDeprecated() {
            return false;
        }
    };

    DCDocComment tree = new DCDocComment(c, fullBody, cast(firstSentence), cast(body), cast(tags));
    return tree;
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
@Override
protected Comment processComment(int pos, int endPos, CommentStyle style) {
	int prevEndPos = Math.max(prevEndPosition, endComment);
	endComment = endPos;
	String content = new String(reader.getRawCharacters(pos, endPos));
	StartConnection start = determineStartConnection(prevEndPos, pos);
	EndConnection end = determineEndConnection(endPos); 

	CommentInfo comment = new CommentInfo(prevEndPos, pos, endPos, content, start, end);
	comments.append(comment);

	return super.processComment(pos, endPos, style);
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
public CommentWithTextAndPosition(
    int pos, int endPos, AccessibleReader reader, CommentStyle style) {
  this.pos = pos;
  this.endPos = endPos;
  this.reader = reader;
  this.style = style;
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
static MatchedComment notAnnotated() {
  return new AutoValue_NamedParameterComment_MatchedComment(
      new Comment() {
        @Override
        public String getText() {
          throw new IllegalArgumentException(
              "Attempt to call getText on comment when in NOT_ANNOTATED state");
        }

        @Override
        public int getSourcePos(int i) {
          throw new IllegalArgumentException(
              "Attempt to call getText on comment when in NOT_ANNOTATED state");
        }

        @Override
        public CommentStyle getStyle() {
          throw new IllegalArgumentException(
              "Attempt to call getText on comment when in NOT_ANNOTATED state");
        }

        @Override
        public boolean isDeprecated() {
          throw new IllegalArgumentException(
              "Attempt to call getText on comment when in NOT_ANNOTATED state");
        }
      },
      MatchType.NOT_ANNOTATED);
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
/**
 * Determine the kind of match we have between the comments on this argument and the formal
 * parameter name.
 */
static MatchedComment match(Commented<ExpressionTree> actual, String formal) {
  Optional<Comment> lastBlockComment =
      Streams.findLast(
          actual.beforeComments().stream().filter(c -> c.getStyle() == CommentStyle.BLOCK));

  if (lastBlockComment.isPresent()) {
    Matcher m =
        PARAMETER_COMMENT_PATTERN.matcher(Comments.getTextFromComment(lastBlockComment.get()));
    if (m.matches()) {
      return MatchedComment.create(
          lastBlockComment.get(),
          m.group(1).equals(formal) ? MatchType.EXACT_MATCH : MatchType.BAD_MATCH);
    }
  }

  Optional<Comment> approximateMatchComment =
      Stream.concat(actual.beforeComments().stream(), actual.afterComments().stream())
          .filter(comment -> isApproximateMatchingComment(comment, formal))
          .findFirst();

  if (approximateMatchComment.isPresent()) {
    // Report EXACT_MATCH for comments that don't use the recommended style (e.g. `/*foo*/`
    // instead of `/* foo= */`), but which match the formal parameter name exactly, since it's
    // a style nit rather than a possible correctness issue.
    // TODO(cushon): revisit this if we standardize on the recommended comment style.
    String text =
        CharMatcher.anyOf("=:")
            .trimTrailingFrom(Comments.getTextFromComment(approximateMatchComment.get()).trim());
    return MatchedComment.create(
        approximateMatchComment.get(),
        text.equals(formal) ? MatchType.EXACT_MATCH : MatchType.APPROXIMATE_MATCH);
  }

  return MatchedComment.notAnnotated();
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
/** CompilationUnit = [ { "@" Annotation } PACKAGE Qualident ";"] {ImportDeclaration} {TypeDeclaration}
 */
public JCTree.JCCompilationUnit parseCompilationUnit() {
    Token firstToken = token;
    JCExpression pid = null;
    JCModifiers mods = null;
    boolean consumedToplevelDoc = false;
    boolean seenImport = false;
    boolean seenPackage = false;
    List<JCAnnotation> packageAnnotations = List.nil();
    if (token.kind == MONKEYS_AT)
        mods = modifiersOpt();

    if (token.kind == PACKAGE) {
        seenPackage = true;
        if (mods != null) {
            checkNoMods(mods.flags);
            packageAnnotations = mods.annotations;
            mods = null;
        }
        nextToken();
        pid = qualident(false);
        accept(SEMI);
    }
    ListBuffer<JCTree> defs = new ListBuffer<JCTree>();
    boolean checkForImports = true;
    boolean firstTypeDecl = true;
    while (token.kind != EOF) {
        if (token.pos > 0 && token.pos <= endPosTable.errorEndPos) {
            // error recovery
            skip(checkForImports, false, false, false);
            if (token.kind == EOF)
                break;
        }
        if (checkForImports && mods == null && token.kind == IMPORT) {
            seenImport = true;
            defs.append(importDeclaration());
        } else {
            Comment docComment = token.comment(CommentStyle.JAVADOC);
            if (firstTypeDecl && !seenImport && !seenPackage) {
                docComment = firstToken.comment(CommentStyle.JAVADOC);
                consumedToplevelDoc = true;
            }
            JCTree def = typeDeclaration(mods, docComment);
            if (def instanceof JCExpressionStatement)
                def = ((JCExpressionStatement)def).expr;
            defs.append(def);
            if (def instanceof JCClassDecl)
                checkForImports = false;
            mods = null;
            firstTypeDecl = false;
        }
    }
    JCTree.JCCompilationUnit toplevel = F.at(firstToken.pos).TopLevel(packageAnnotations, pid, defs.toList());
    if (!consumedToplevelDoc)
        attach(toplevel, firstToken.comment(CommentStyle.JAVADOC));
    if (defs.isEmpty())
        storeEnd(toplevel, S.prevToken().endPos);
    if (keepDocComments)
        toplevel.docComments = docComments;
    if (keepLineMap)
        toplevel.lineMap = S.getLineMap();
    this.endPosTable.setParser(null); // remove reference to parser
    toplevel.endPositions = this.endPosTable;
    return toplevel;
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
protected BasicComment(U comment_reader, CommentStyle cs) {
    this.comment_reader = comment_reader;
    this.cs = cs;
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
public CommentStyle getStyle() {
    return cs;
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
public boolean isDeprecated() {
    if (!scanned && cs == CommentStyle.JAVADOC) {
        scanDocComment();
    }
    return deprecatedFlag;
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
@Override
protected Comment processComment(int pos, int endPos, CommentStyle style) {
    char[] buf = reader.getRawCharacters(pos, endPos);
    return new JavadocComment(new DocReader(fac, buf, buf.length, pos), style);
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
JavadocComment(DocReader reader, CommentStyle cs) {
    super(reader, cs);
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
@Override @DefinedBy(Api.COMPILER_TREE)
public DocCommentTree getDocCommentTree(FileObject fileObject) {
    JavaFileObject jfo = asJavaFileObject(fileObject);
    DiagnosticSource diagSource = new DiagnosticSource(jfo, log);

    final Comment comment = new Comment() {
        int offset = 0;
        @Override
        public String getText() {
            try {
                CharSequence rawDoc = fileObject.getCharContent(true);
                Pattern bodyPat =
                        Pattern.compile("(?is).*?<body\\b[^>]*>(.*)</body\\b.*");
                Matcher m = bodyPat.matcher(rawDoc);
                if (m.matches()) {
                    offset = m.end(1);
                    return m.group(1);
                } else {
                    // Assume doclint will do the right thing.
                    return "";
                }
            } catch (IOException ignore) {
                // do nothing
            }
            return "";
        }

        @Override
        public int getSourcePos(int index) {
            return offset + index;
        }

        @Override
        public CommentStyle getStyle() {
            throw new UnsupportedOperationException();
        }

        @Override
        public boolean isDeprecated() {
            throw new UnsupportedOperationException();
        }
    };

    return new DocCommentParser(parser, diagSource, comment).parse();
}
 

import com.sun.tools.javac.parser.Tokens.Comment.CommentStyle; //导入依赖的package包/类
/** CompilationUnit = [ { "@" Annotation } PACKAGE Qualident ";"] {ImportDeclaration} {TypeDeclaration}
 */
public JCTree.JCCompilationUnit parseCompilationUnit() {
    Token firstToken = token;
    JCModifiers mods = null;
    boolean consumedToplevelDoc = false;
    ListBuffer<JCTree> defs = new ListBuffer<>();

    if (token.kind == IDENTIFIER && token.name() == names.module) {
        defs.append(moduleDecl(token.comment(CommentStyle.JAVADOC)));
        consumedToplevelDoc = true;
    } else {
        boolean seenImport = false;
        boolean seenPackage = false;
        if (token.kind == MONKEYS_AT)
            mods = modifiersOpt();

        if (token.kind == PACKAGE) {
            int packagePos = token.pos;
            List<JCAnnotation> annotations = List.nil();
            seenPackage = true;
            if (mods != null) {
                checkNoMods(mods.flags);
                annotations = mods.annotations;
                mods = null;
            }
            nextToken();
            JCExpression pid = qualident(false);
            accept(SEMI);
            JCPackageDecl pd = F.at(packagePos).PackageDecl(annotations, pid);
            attach(pd, firstToken.comment(CommentStyle.JAVADOC));
            consumedToplevelDoc = true;
            storeEnd(pd, token.pos);
            defs.append(pd);
        }
        boolean checkForImports = true;
        boolean firstTypeDecl = true;
        while (token.kind != EOF) {
            if (token.pos <= endPosTable.errorEndPos) {
                // error recovery
                skip(checkForImports, false, false, false);
                if (token.kind == EOF)
                    break;
            }
            if (checkForImports && mods == null && token.kind == IMPORT) {
                seenImport = true;
                defs.append(importDeclaration());
            } else {
                Comment docComment = token.comment(CommentStyle.JAVADOC);
                if (firstTypeDecl && !seenImport && !seenPackage) {
                    docComment = firstToken.comment(CommentStyle.JAVADOC);
                    consumedToplevelDoc = true;
                }
                JCTree def = typeDeclaration(mods, docComment);
                if (def instanceof JCExpressionStatement)
                    def = ((JCExpressionStatement)def).expr;
                defs.append(def);
                if (def instanceof JCClassDecl)
                    checkForImports = false;
                mods = null;
                firstTypeDecl = false;
            }
        }
    }

    JCTree.JCCompilationUnit toplevel = F.at(firstToken.pos).TopLevel(defs.toList());
    if (!consumedToplevelDoc)
        attach(toplevel, firstToken.comment(CommentStyle.JAVADOC));
    if (defs.isEmpty())
        storeEnd(toplevel, S.prevToken().endPos);
    if (keepDocComments)
        toplevel.docComments = docComments;
    if (keepLineMap)
        toplevel.lineMap = S.getLineMap();
    this.endPosTable.setParser(null); // remove reference to parser
    toplevel.endPositions = this.endPosTable;
    return toplevel;
}