jdk8-mips64-public/langtools: comparison test/tools/javac/doctree/ReferenceTest.java

--1:000000000000
+:959103a6100f
+/*
+* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
+* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+*
+* This code is free software; you can redistribute it and/or modify it
+* under the terms of the GNU General Public License version 2 only, as
+* published by the Free Software Foundation.
+*
+* This code is distributed in the hope that it will be useful, but WITHOUT
+* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+* FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+* version 2 for more details (a copy is included in the LICENSE file that
+* accompanied this code).
+*
+* You should have received a copy of the GNU General Public License version
+* 2 along with this work; if not, write to the Free Software Foundation,
+* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+*
+* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+* or visit www.oracle.com if you need additional information or have any
+* questions.
+*/
+/*
+* @test
+* @bug 7021614
+* @summary extend com.sun.source API to support parsing javadoc comments
+* @summary check references in at-see and {at-link} tags
+* @build ReferenceTest
+* @compile -processor ReferenceTest -proc:only ReferenceTest.java
+*/
+import com.sun.source.doctree.DocCommentTree;
+import com.sun.source.doctree.DocTree;
+import com.sun.source.doctree.LinkTree;
+import com.sun.source.doctree.ReferenceTree;
+import com.sun.source.doctree.SeeTree;
+import com.sun.source.doctree.TextTree;
+import com.sun.source.util.DocTreePath;
+import com.sun.source.util.DocTreePathScanner;
+import com.sun.source.util.DocTreeScanner;
+import com.sun.source.util.DocTrees;
+import com.sun.source.util.TreePath;
+import java.util.List;
+import java.util.Set;
+import javax.annotation.processing.AbstractProcessor;
+import javax.annotation.processing.ProcessingEnvironment;
+import javax.annotation.processing.RoundEnvironment;
+import javax.annotation.processing.SupportedAnnotationTypes;
+import javax.lang.model.SourceVersion;
+import javax.lang.model.element.Element;
+import javax.lang.model.element.TypeElement;
+import javax.tools.Diagnostic.Kind;
+/**
+* {@link java.lang        Package}
+* {@link java.lang.ERROR  Bad}
+*
+* {@link java.lang.String Class}
+* {@link           String Class}
+* {@link java.lang.String#CASE_INSENSITIVE_ORDER Field}
+* {@link java.lang.String#String Constructor}
+* {@link java.lang.String#String(byte[]) Constructor}
+* {@link java.lang.String#String(byte[] bytes) Constructor}
+* {@link java.lang.String#String(byte[], String) Constructor}
+* {@link java.lang.String#String(byte[] bytes, String charSetName) Constructor}
+* {@link java.lang.String#isEmpty Method}
+* {@link java.lang.String#isEmpty() Method}
+* {@link java.lang.String#ERROR Bad}
+* {@link java.lang.String#equals(Object) Method}
+*
+* {@link AbstractProcessor Class}
+*
+* {@link List#add(Object) Method}
+*
+* {@link #trees Field}
+* {@link #getSupportedSourceVersion Method}
+* {@link #init(ProcessingEnvironment Method}
+*
+* @see java.lang        Package
+* @see java.lang.ERROR  Bad
+*
+* @see java.lang.String Class
+* @see           String Class
+* @see java.lang.String#CASE_INSENSITIVE_ORDER Field
+* @see java.lang.String#String Constructor
+* @see java.lang.String#String(byte[]) Constructor
+* @see java.lang.String#String(byte[] bytes) Constructor
+* @see java.lang.String#String(byte[],String) Constructor
+* @see java.lang.String#String(byte[] bytes, String charsetName) Constructor
+* @see java.lang.String#isEmpty Method
+* @see java.lang.String#isEmpty() Method
+* @see java.lang.String#ERROR Bad
+* @see java.lang.String#equals(Object) Method
+*
+* @see AbstractProcessor Class
+*
+* @see List#add(Object) Method
+*
+* @see #trees Field
+* @see #getSupportedSourceVersion Method
+* @see #init(ProcessingEnvironment) Method
+*
+* @see java.io.BufferedInputStream#BufferedInputStream(InputStream) Constructor
+*/
+@SupportedAnnotationTypes("*")
+public class ReferenceTest extends AbstractProcessor {
+DocTrees trees;
+@Override
+public SourceVersion getSupportedSourceVersion() {
+return SourceVersion.latest();
+}
+@Override
+public void init(ProcessingEnvironment pEnv) {
+super.init(pEnv);
+trees = DocTrees.instance(pEnv);
+}
+@Override
+public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
+for (Element e: roundEnv.getRootElements()) {
+new DocCommentScanner(trees.getPath(e)).scan();
+}
+return true;
+}
+class DocCommentScanner extends DocTreePathScanner<Void, Void> {
+TreePath path;
+DocCommentTree dc;
+DocCommentScanner(TreePath path) {
+this.path = path;
+}
+void scan() {
+dc = trees.getDocCommentTree(path);
+scan(new DocTreePath(path, dc), null);
+}
+@Override
+public Void visitLink(LinkTree tree, Void ignore) {
+checkReference(tree.getReference(), tree.getLabel());
+return null;
+}
+@Override
+public Void visitSee(SeeTree tree, Void ignore) {
+List<? extends DocTree> refLabel = tree.getReference();
+if (refLabel.size() > 1 && (refLabel.get(0) instanceof ReferenceTree)) {
+ReferenceTree ref = (ReferenceTree) refLabel.get(0);
+List<? extends DocTree> label = refLabel.subList(1, refLabel.size());
+checkReference(ref, label);
+}
+return null;
+}
+void checkReference(ReferenceTree tree, List<? extends DocTree> label) {
+String sig = tree.getSignature();
+Element found = trees.getElement(new DocTreePath(getCurrentPath(), tree));
+if (found == null) {
+System.err.println(sig + " NOT FOUND");
+} else {
+System.err.println(sig + " found " + found.getKind() + " " + found);
+}
+String expect = "UNKNOWN";
+if (label.size() > 0 && label.get(0) instanceof TextTree)
+expect = ((TextTree) label.get(0)).getBody();
+if (!expect.equalsIgnoreCase(found == null ? "bad" : found.getKind().name())) {
+error(tree, "Unexpected value found: " + found +", expected: " + expect);
+}
+}
+void error(DocTree tree, String msg) {
+trees.printMessage(Kind.ERROR, msg, tree, dc, path.getCompilationUnit());
+}
+}
+}
+/**
+* @see ReferenceTestExtras    Class
+* @see #ReferenceTestExtras   Field
+* @see #ReferenceTestExtras() Constructor
+*
+* @see #X    Field
+* @see #X()  Method
+*
+* @see #m    Method
+*
+* @see #varargs(int...)        Method
+* @see #varargs(int... args)   Method
+* @see #varargs(int[])         Method
+* @see #varargs(int[] args)    Method
+*/
+class ReferenceTestExtras {
+int ReferenceTestExtras;            // field
+ReferenceTestExtras() { }           // constructor
+void ReferenceTestExtras() { }      // method
+int X;
+void X() { }
+static class X { }
+void m() { }
+void m(int i) { }
+void m(int i, int j) { }
+void varargs(int... args) { }
+}

Mercurial > jdk8-mips64-public > langtools / file comparison

comparison: test/tools/javac/doctree/ReferenceTest.java

test/tools/javac/doctree/ReferenceTest.java