jdk-sandbox: comparison langtools/src/jdk.compiler/share/classes/com/sun/tools/javac/api/JavacTrees.java

equal deleted inserted replaced

-:46aacfffd3b5
+:2d24bda701dc
 import com.sun.tools.javac.tree.TreeInfo;
 import com.sun.tools.javac.tree.TreeMaker;
 import com.sun.tools.javac.util.Abort;
 import com.sun.tools.javac.util.Assert;
 import com.sun.tools.javac.util.Context;
+import com.sun.tools.javac.util.DefinedBy;
+import com.sun.tools.javac.util.DefinedBy.Api;
 import com.sun.tools.javac.util.JCDiagnostic;
 import com.sun.tools.javac.util.List;
 import com.sun.tools.javac.util.ListBuffer;
 import com.sun.tools.javac.util.Log;
 import com.sun.tools.javac.util.Name;
 JavacTask t = context.get(JavacTask.class);
 if (t instanceof JavacTaskImpl)
 javacTaskImpl = (JavacTaskImpl) t;
 }
+@DefinedBy(Api.COMPILER_TREE)
 public DocSourcePositions getSourcePositions() {
 return new DocSourcePositions() {
+@DefinedBy(Api.COMPILER_TREE)
 public long getStartPosition(CompilationUnitTree file, Tree tree) {
 return TreeInfo.getStartPos((JCTree) tree);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public long getEndPosition(CompilationUnitTree file, Tree tree) {
 EndPosTable endPosTable = ((JCCompilationUnit) file).endPositions;
 return TreeInfo.getEndPos((JCTree) tree, endPosTable);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public long getStartPosition(CompilationUnitTree file, DocCommentTree comment, DocTree tree) {
 return ((DCTree) tree).getSourcePosition((DCDocComment) comment);
 }
-@SuppressWarnings("fallthrough")
+@SuppressWarnings("fallthrough") @DefinedBy(Api.COMPILER_TREE)
 public long getEndPosition(CompilationUnitTree file, DocCommentTree comment, DocTree tree) {
 DCDocComment dcComment = (DCDocComment) comment;
 if (tree instanceof DCEndPosTree) {
 int endPos = ((DCEndPosTree) tree).getEndPos(dcComment);
 private DocTree getLastChild(DocTree tree) {
 final DocTree[] last = new DocTree[] {null};
 tree.accept(new DocTreeScanner<Void, Void>() {
-@Override public Void scan(DocTree node, Void p) {
+@Override @DefinedBy(Api.COMPILER_TREE)
+public Void scan(DocTree node, Void p) {
 if (node != null) last[0] = node;
 return null;
 }
 }, null);
 return last[0];
 }
+@DefinedBy(Api.COMPILER_TREE)
 public JCClassDecl getTree(TypeElement element) {
 return (JCClassDecl) getTree((Element) element);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public JCMethodDecl getTree(ExecutableElement method) {
 return (JCMethodDecl) getTree((Element) method);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public JCTree getTree(Element element) {
 return getTree(element, null);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public JCTree getTree(Element e, AnnotationMirror a) {
 return getTree(e, a, null);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public JCTree getTree(Element e, AnnotationMirror a, AnnotationValue v) {
 Pair<JCTree, JCCompilationUnit> treeTopLevel = elements.getTreeAndTopLevel(e, a, v);
 if (treeTopLevel == null)
 return null;
 return treeTopLevel.fst;
 }
+@DefinedBy(Api.COMPILER_TREE)
 public TreePath getPath(CompilationUnitTree unit, Tree node) {
 return TreePath.getPath(unit, node);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public TreePath getPath(Element e) {
 return getPath(e, null, null);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public TreePath getPath(Element e, AnnotationMirror a) {
 return getPath(e, a, null);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public TreePath getPath(Element e, AnnotationMirror a, AnnotationValue v) {
 final Pair<JCTree, JCCompilationUnit> treeTopLevel = elements.getTreeAndTopLevel(e, a, v);
 if (treeTopLevel == null)
 return null;
 return TreePath.getPath(treeTopLevel.snd, treeTopLevel.fst);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public Symbol getElement(TreePath path) {
 JCTree tree = (JCTree) path.getLeaf();
 Symbol sym = TreeInfo.symbolFor(tree);
 if (sym == null) {
 if (TreeInfo.isDeclaration(tree)) {
 }
 }
 return sym;
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public Element getElement(DocTreePath path) {
 DocTree forTree = path.getLeaf();
 if (forTree instanceof DCReference)
 return attributeDocReference(path.getTreePath(), ((DCReference) forTree));
 if (forTree instanceof DCIdentifier) {
 return s.hasTag(CLASS)
 && t.tsym.name == ((ClassType) s).tsym.name;
 }
 };
+@DefinedBy(Api.COMPILER_TREE)
 public TypeMirror getTypeMirror(TreePath path) {
 Tree t = path.getLeaf();
 return ((JCTree)t).type;
 }
+@DefinedBy(Api.COMPILER_TREE)
 public JavacScope getScope(TreePath path) {
 return JavacScope.create(getAttrContext(path));
 }
+@DefinedBy(Api.COMPILER_TREE)
 public String getDocComment(TreePath path) {
 CompilationUnitTree t = path.getCompilationUnit();
 Tree leaf = path.getLeaf();
 if (t instanceof JCTree.JCCompilationUnit && leaf instanceof JCTree) {
 JCCompilationUnit cu = (JCCompilationUnit) t;
 }
 }
 return null;
 }
+@DefinedBy(Api.COMPILER_TREE)
 public DocCommentTree getDocCommentTree(TreePath path) {
 CompilationUnitTree t = path.getCompilationUnit();
 Tree leaf = path.getLeaf();
 if (t instanceof JCTree.JCCompilationUnit && leaf instanceof JCTree) {
 JCCompilationUnit cu = (JCCompilationUnit) t;
 }
 }
 return null;
 }
+@DefinedBy(Api.COMPILER_TREE)
 public boolean isAccessible(Scope scope, TypeElement type) {
 if (scope instanceof JavacScope && type instanceof ClassSymbol) {
 Env<AttrContext> env = ((JavacScope) scope).env;
 return resolve.isAccessible(env, (ClassSymbol)type, true);
 } else
 return false;
 }
+@DefinedBy(Api.COMPILER_TREE)
 public boolean isAccessible(Scope scope, Element member, DeclaredType type) {
 if (scope instanceof JavacScope
 && member instanceof Symbol
 && type instanceof com.sun.tools.javac.code.Type) {
 Env<AttrContext> env = ((JavacScope) scope).env;
 * Returns the original type from the ErrorType object.
 * @param errorType The errorType for which we want to get the original type.
 * @returns TypeMirror corresponding to the original type, replaced by the ErrorType.
 *          noType (type.tag == NONE) is returned if there is no original type.
 */
+@DefinedBy(Api.COMPILER_TREE)
 public TypeMirror getOriginalType(javax.lang.model.type.ErrorType errorType) {
 if (errorType instanceof com.sun.tools.javac.code.Type.ErrorType) {
 return ((com.sun.tools.javac.code.Type.ErrorType)errorType).getOriginalType();
 }
 * @param kind the kind of message
 * @param msg  the message, or an empty string if none
 * @param t    the tree to use as a position hint
 * @param root the compilation unit that contains tree
 */
+@DefinedBy(Api.COMPILER_TREE)
 public void printMessage(Diagnostic.Kind kind, CharSequence msg,
 com.sun.source.tree.Tree t,
 com.sun.source.tree.CompilationUnitTree root) {
 printMessage(kind, msg, ((JCTree) t).pos(), root);
 }
+@DefinedBy(Api.COMPILER_TREE)
 public void printMessage(Diagnostic.Kind kind, CharSequence msg,
 com.sun.source.doctree.DocTree t,
 com.sun.source.doctree.DocCommentTree c,
 com.sun.source.tree.CompilationUnitTree root) {
 printMessage(kind, msg, ((DCTree) t).pos((DCDocComment) c), root);
 if (oldSource != null)
 log.useSource(oldSource);
 }
 }
-@Override
+@Override @DefinedBy(Api.COMPILER_TREE)
 public TypeMirror getLub(CatchTree tree) {
 JCCatch ct = (JCCatch) tree;
 JCVariableDecl v = ct.param;
 if (v.type != null && v.type.getKind() == TypeKind.UNION) {
 UnionClassType ut = (UnionClassType) v.type;

changeset 26266	2d24bda701dc
parent 26264	a09fedde76be
child 27224	228abfa87080