com.sun.source.doctree.ThrowsTree Java Examples

The following examples show how to use com.sun.source.doctree.ThrowsTree. You can vote up the ones you like or vote down the ones you don't like, and go to the original project or source file by following the links above each example. You may check out the related API usage on the sidebar.
Example #1
Source File: Checker.java    From jdk8u60 with GNU General Public License v2.0 6 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree tree, Void ignore) {
    ReferenceTree exName = tree.getExceptionName();
    Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
    if (ex == null) {
        env.messages.error(REFERENCE, tree, "dc.ref.not.found");
    } else if (isThrowable(ex.asType())) {
        switch (env.currElement.getKind()) {
            case CONSTRUCTOR:
            case METHOD:
                if (isCheckedException(ex.asType())) {
                    ExecutableElement ee = (ExecutableElement) env.currElement;
                    checkThrowsDeclared(exName, ex.asType(), ee.getThrownTypes());
                }
                break;
            default:
                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
    } else {
        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
    }
    warnIfEmpty(tree, tree.getDescription());
    return scan(tree.getDescription(), ignore);
}
Example #2
Source File: Checker.java    From openjdk-jdk8u with GNU General Public License v2.0 6 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree tree, Void ignore) {
    ReferenceTree exName = tree.getExceptionName();
    Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
    if (ex == null) {
        env.messages.error(REFERENCE, tree, "dc.ref.not.found");
    } else if (isThrowable(ex.asType())) {
        switch (env.currElement.getKind()) {
            case CONSTRUCTOR:
            case METHOD:
                if (isCheckedException(ex.asType())) {
                    ExecutableElement ee = (ExecutableElement) env.currElement;
                    checkThrowsDeclared(exName, ex.asType(), ee.getThrownTypes());
                }
                break;
            default:
                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
    } else {
        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
    }
    warnIfEmpty(tree, tree.getDescription());
    return scan(tree.getDescription(), ignore);
}
Example #3
Source File: Checker.java    From openjdk-8 with GNU General Public License v2.0 6 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree tree, Void ignore) {
    ReferenceTree exName = tree.getExceptionName();
    Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
    if (ex == null) {
        env.messages.error(REFERENCE, tree, "dc.ref.not.found");
    } else if (isThrowable(ex.asType())) {
        switch (env.currElement.getKind()) {
            case CONSTRUCTOR:
            case METHOD:
                if (isCheckedException(ex.asType())) {
                    ExecutableElement ee = (ExecutableElement) env.currElement;
                    checkThrowsDeclared(exName, ex.asType(), ee.getThrownTypes());
                }
                break;
            default:
                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
    } else {
        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
    }
    warnIfEmpty(tree, tree.getDescription());
    return scan(tree.getDescription(), ignore);
}
Example #4
Source File: Checker.java    From openjdk-8-source with GNU General Public License v2.0 6 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree tree, Void ignore) {
    ReferenceTree exName = tree.getExceptionName();
    Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
    if (ex == null) {
        env.messages.error(REFERENCE, tree, "dc.ref.not.found");
    } else if (isThrowable(ex.asType())) {
        switch (env.currElement.getKind()) {
            case CONSTRUCTOR:
            case METHOD:
                if (isCheckedException(ex.asType())) {
                    ExecutableElement ee = (ExecutableElement) env.currElement;
                    checkThrowsDeclared(exName, ex.asType(), ee.getThrownTypes());
                }
                break;
            default:
                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
    } else {
        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
    }
    warnIfEmpty(tree, tree.getDescription());
    return scan(tree.getDescription(), ignore);
}
Example #5
Source File: Checker.java    From hottub with GNU General Public License v2.0 6 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree tree, Void ignore) {
    ReferenceTree exName = tree.getExceptionName();
    Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
    if (ex == null) {
        env.messages.error(REFERENCE, tree, "dc.ref.not.found");
    } else if (isThrowable(ex.asType())) {
        switch (env.currElement.getKind()) {
            case CONSTRUCTOR:
            case METHOD:
                if (isCheckedException(ex.asType())) {
                    ExecutableElement ee = (ExecutableElement) env.currElement;
                    checkThrowsDeclared(exName, ex.asType(), ee.getThrownTypes());
                }
                break;
            default:
                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
    } else {
        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
    }
    warnIfEmpty(tree, tree.getDescription());
    return scan(tree.getDescription(), ignore);
}
Example #6
Source File: Checker.java    From openjdk-jdk9 with GNU General Public License v2.0 6 votes vote down vote up 
@Override @DefinedBy(Api.COMPILER_TREE)
public Void visitThrows(ThrowsTree tree, Void ignore) {
    ReferenceTree exName = tree.getExceptionName();
    Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
    if (ex == null) {
        env.messages.error(REFERENCE, tree, "dc.ref.not.found");
    } else if (isThrowable(ex.asType())) {
        switch (env.currElement.getKind()) {
            case CONSTRUCTOR:
            case METHOD:
                if (isCheckedException(ex.asType())) {
                    ExecutableElement ee = (ExecutableElement) env.currElement;
                    checkThrowsDeclared(exName, ex.asType(), ee.getThrownTypes());
                }
                break;
            default:
                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
    } else {
        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
    }
    warnIfEmpty(tree, tree.getDescription());
    return scan(tree.getDescription(), ignore);
}
Example #7
Source File: Checker.java    From openjdk-jdk8u-backup with GNU General Public License v2.0 6 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree tree, Void ignore) {
    ReferenceTree exName = tree.getExceptionName();
    Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
    if (ex == null) {
        env.messages.error(REFERENCE, tree, "dc.ref.not.found");
    } else if (isThrowable(ex.asType())) {
        switch (env.currElement.getKind()) {
            case CONSTRUCTOR:
            case METHOD:
                if (isCheckedException(ex.asType())) {
                    ExecutableElement ee = (ExecutableElement) env.currElement;
                    checkThrowsDeclared(exName, ex.asType(), ee.getThrownTypes());
                }
                break;
            default:
                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
    } else {
        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
    }
    warnIfEmpty(tree, tree.getDescription());
    return scan(tree.getDescription(), ignore);
}
Example #8
Source File: Checker.java    From TencentKona-8 with GNU General Public License v2.0 6 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree tree, Void ignore) {
    ReferenceTree exName = tree.getExceptionName();
    Element ex = env.trees.getElement(new DocTreePath(getCurrentPath(), exName));
    if (ex == null) {
        env.messages.error(REFERENCE, tree, "dc.ref.not.found");
    } else if (isThrowable(ex.asType())) {
        switch (env.currElement.getKind()) {
            case CONSTRUCTOR:
            case METHOD:
                if (isCheckedException(ex.asType())) {
                    ExecutableElement ee = (ExecutableElement) env.currElement;
                    checkThrowsDeclared(exName, ex.asType(), ee.getThrownTypes());
                }
                break;
            default:
                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
    } else {
        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
    }
    warnIfEmpty(tree, tree.getDescription());
    return scan(tree.getDescription(), ignore);
}
Example #9
Source File: Analyzer.java    From netbeans with Apache License 2.0 5 votes vote down vote up 
@NbBundle.Messages({"# {0} - [@throws|@exception]", "# {1} - @throws name",
                    "DUPLICATE_THROWS_DESC=Duplicate @{0} tag: {1}",
                    "# {0} - [@throws|@exception]", "# {1} - @throws name",
                    "UNKNOWN_THROWABLE_DESC=Unknown throwable: @{0} {1}"})
private void checkThrowsDeclared(ThrowsTree tree, Element ex, String fqn, List<? extends TypeMirror> list, DocTreePathHandle dtph, int start, int end, List<ErrorDescription> errors) {
    boolean found = false;
    final TypeMirror type;
    if(ex != null) {
        type = ex.asType();
    } else {
        TypeElement typeElement = javac.getElements().getTypeElement(fqn);
        if(typeElement != null) {
            type = typeElement.asType();
        } else {
            type = null;
        }
    }
    for (TypeMirror t: list) {
        if(ctx.isCanceled()) { return; }
        if(type != null && javac.getTypes().isAssignable(type, t)) {
            if(!foundThrows.add(type)) {
                errors.add(ErrorDescriptionFactory.forSpan(ctx, start, end, DUPLICATE_THROWS_DESC(tree.getTagName(), fqn), new RemoveTagFix(dtph, "@" + tree.getTagName()).toEditorFix()));
            }
            found = true;
            break;
        }
        if (type == null && fqn.equals(t.toString())) {
            if(!foundThrows.add(t)) {
                errors.add(ErrorDescriptionFactory.forSpan(ctx, start, end, DUPLICATE_THROWS_DESC(tree.getTagName(), fqn), new RemoveTagFix(dtph, "@" + tree.getTagName()).toEditorFix()));
            }
            found = true;
            break;
        }
    }
    if (!found) {
        errors.add(ErrorDescriptionFactory.forSpan(ctx, start, end, UNKNOWN_THROWABLE_DESC(tree.getTagName(), fqn), new RemoveTagFix(dtph, "@" + tree.getTagName()).toEditorFix()));
    }
}
Example #10
Source File: CommentHelper.java    From openjdk-jdk9 with GNU General Public License v2.0 5 votes vote down vote up 
public Element getException(Configuration c, DocTree dtree) {
    if (dtree.getKind() == THROWS || dtree.getKind() == EXCEPTION) {
        ThrowsTree tt = (ThrowsTree)dtree;
        ReferenceTree exceptionName = tt.getExceptionName();
        return getElement(c, exceptionName);
    }
    return null;
}
Example #11
Source File: ImmutableDocTreeTranslator.java    From netbeans with Apache License 2.0 5 votes vote down vote up 
protected final ThrowsTree rewriteChildren(ThrowsTree tree) {
    ThrowsTree value = tree;
    ReferenceTree exception = (ReferenceTree) translate(tree.getExceptionName());
    List<? extends DocTree> description = translateDoc(tree.getDescription());
    if (exception != tree.getExceptionName() || description != tree.getDescription()) {
        value = make.Throws(exception, description);
    }
    return value;
}
Example #12
Source File: VeryPretty.java    From netbeans with Apache License 2.0 5 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree node, Void p) {
    printTagName(node);
    needSpace();
    doAccept((DCTree)node.getExceptionName());
    if(!node.getDescription().isEmpty()) {
        needSpace();
        for (DocTree docTree : node.getDescription()) {
            doAccept((DCTree)docTree);
        }
    }
    return null;
}
Example #13
Source File: JavadocFormatter.java    From openjdk-jdk9 with GNU General Public License v2.0 4 votes vote down vote up 
@Override @DefinedBy(Api.COMPILER_TREE)
public Object visitThrows(ThrowsTree node, Object p) {
    return formatDef(node.getExceptionName().getSignature(), node.getDescription());
}
Example #14
Source File: JavadocConverter.java    From j2objc with Apache License 2.0 4 votes vote down vote up 
@Override
public Void visitThrows(ThrowsTree node, TagElement tag) {
  setTagValues(tag, TagElement.TagKind.THROWS, node, node.getExceptionName());
  scan(node.getDescription(), tag);
  return null;
}
Example #15
Source File: CommentHelper.java    From openjdk-jdk9 with GNU General Public License v2.0 4 votes vote down vote up 
public ReferenceTree getExceptionName(DocTree dtree) {
    return (dtree.getKind() == THROWS || dtree.getKind() == EXCEPTION)
            ? ((ThrowsTree)dtree).getExceptionName()
            : null;
}
Example #16
Source File: ImmutableDocTreeTranslator.java    From netbeans with Apache License 2.0 4 votes vote down vote up 
@Override
public DocTree visitThrows(ThrowsTree tree, Object p) {
    return rewriteChildren(tree);
}
Example #17
Source File: JavadocHelper.java    From openjdk-jdk9 with GNU General Public License v2.0 4 votes vote down vote up 
private String getThrownException(JavacTask task, TreePath rootOn, DocCommentTree comment, ThrowsTree tt) {
    DocTrees trees = DocTrees.instance(task);
    Element exc = trees.getElement(new DocTreePath(new DocTreePath(rootOn, comment), tt.getExceptionName()));
    return exc != null ? exc.toString() : null;
}
Example #18
Source File: TreeFactory.java    From netbeans with Apache License 2.0 4 votes vote down vote up 
public ThrowsTree Throws(ReferenceTree name, List<? extends DocTree> description) {
    return docMake.at(NOPOS).newThrowsTree(name, description);
}
Example #19
Source File: Analyzer.java    From netbeans with Apache License 2.0 4 votes vote down vote up 
private void findInheritedParams(ExecutableElement method, TypeElement typeElement, Set<String> inheritedParams, Set<String> inheritedTypeParams, Set<String> inheritedThrows) {
    if(typeElement == null) return;

    List<TypeMirror> superTypes = new ArrayList<>();

    superTypes.add(typeElement.getSuperclass());
    superTypes.addAll(typeElement.getInterfaces());

    for (TypeMirror typeMirror : superTypes) {
        for (Element el : javac.getElementUtilities().getMembers(typeMirror, (e, type) -> e.getKind() == ElementKind.METHOD)) {
            if(ctx.isCanceled()) { return; }
            if(javac.getElements().overrides(method, (ExecutableElement) el, typeElement)) {
                ElementHandle<ExecutableElement> overriddenMethod = ElementHandle.create((ExecutableElement) el);
                FileObject source = SourceUtils.getFile(overriddenMethod, ctx.getInfo().getClasspathInfo());
                if (source == null) {
                    continue;
                }
                try {
                    JavaSource.forFileObject(source).runUserActionTask(cc -> {
                        cc.toPhase(Phase.ELEMENTS_RESOLVED);
                        if (ctx.isCanceled()) {
                            return ; //cancel
                        }
                        ExecutableElement m = overriddenMethod.resolve(cc);
                        TreePath tp = m != null ? cc.getTrees().getPath(m) : null;
                        if (tp == null) {
                            return ; //TODO: log???
                        }
                        DocCommentTree methodDoc = cc.getDocTrees().getDocCommentTree(tp);
                        if(methodDoc != null) {
                            for (DocTree tag : methodDoc.getBlockTags()) {
                                switch (tag.getKind()) {
                                    case PARAM:
                                        String name = ((ParamTree) tag).getName().getName().toString();
                                        if (((ParamTree) tag).isTypeParameter()) {
                                            inheritedTypeParams.add(name);
                                        } else {
                                            inheritedParams.add(name);
                                        }
                                        break;
                                    case THROWS:
                                        Element thrownType = cc.getDocTrees().getElement(new DocTreePath(new DocTreePath(new DocTreePath(tp, methodDoc), tag), ((ThrowsTree) tag).getExceptionName()));
                                        if (thrownType != null && thrownType.getKind().isClass()) {
                                            inheritedThrows.add(((TypeElement) thrownType).getQualifiedName().toString());
                                        }
                                        break;
                                    case RETURN:
                                        returnTypeFound |= true;
                                }
                            }
                        }
                    }, true);
                } catch (IOException ex) {
                    LOG.log(Level.FINE, null, ex);
                }
            }
        }
    }
}
Example #20
Source File: Analyzer.java    From netbeans with Apache License 2.0 4 votes vote down vote up 
@Override
    public Void visitThrows(ThrowsTree tree, List<ErrorDescription> errors) {
        boolean oldInheritDoc = foundInheritDoc;
        ReferenceTree exName = tree.getExceptionName();
        DocTreePath refPath = new DocTreePath(getCurrentPath(), tree.getExceptionName());
        Element ex = javac.getDocTrees().getElement(refPath);
        Types types = javac.getTypes();
        Elements elements = javac.getElements();
        final TypeElement throwableEl = elements.getTypeElement("java.lang.Throwable");
        final TypeElement errorEl = elements.getTypeElement("java.lang.Error");
        final TypeElement runtimeEl = elements.getTypeElement("java.lang.RuntimeException");
        if(throwableEl == null || errorEl == null || runtimeEl == null) {
            LOG.warning("Broken java-platform, cannot resolve " + throwableEl == null? "java.lang.Throwable" : errorEl == null? "java.lang.Error" : "java.lang.RuntimeException"); //NOI18N
            return null;
        }
        TypeMirror throwable = throwableEl.asType();
        TypeMirror error = errorEl.asType();
        TypeMirror runtime = runtimeEl.asType();
        DocTreePath currentDocPath = getCurrentPath();
        DocTreePathHandle dtph = DocTreePathHandle.create(currentDocPath, javac);
        if(dtph == null) {
            return null;
        }
        DocSourcePositions sp = (DocSourcePositions) javac.getTrees().getSourcePositions();
        int start = (int) sp.getStartPosition(javac.getCompilationUnit(), currentDocPath.getDocComment(), tree);
        int end = (int) sp.getEndPosition(javac.getCompilationUnit(), currentDocPath.getDocComment(), tree);
        if (ex == null || (ex.asType().getKind() == TypeKind.DECLARED
                && types.isAssignable(ex.asType(), throwable))) {
            switch (currentElement.getKind()) {
                case CONSTRUCTOR:
                case METHOD:
                    if (ex == null || !(types.isAssignable(ex.asType(), error)
                            || types.isAssignable(ex.asType(), runtime))) {
                        ExecutableElement ee = (ExecutableElement) currentElement;
                        String fqn;
                        if (ex != null) {
                            fqn = ((TypeElement) ex).getQualifiedName().toString();
                        } else {
                            ExpressionTree referenceClass = javac.getTreeUtilities().getReferenceClass(new DocTreePath(currentDocPath, exName));
                            if(referenceClass == null) break;
                            fqn = referenceClass.toString();
                        }
                        checkThrowsDeclared(tree, ex, fqn, ee.getThrownTypes(), dtph, start, end, errors);
                    }
                    break;
                default:
//                        env.messages.error(REFERENCE, tree, "dc.invalid.throws");
            }
        } else {
//                env.messages.error(REFERENCE, tree, "dc.invalid.throws");
        }
        warnIfEmpty(tree, tree.getDescription());
        super.visitThrows(tree, errors);
        foundInheritDoc = oldInheritDoc;
        return null;
    }
Example #21
Source File: TreeFactory.java    From netbeans with Apache License 2.0 4 votes vote down vote up 
public ThrowsTree Exception(ReferenceTree name, List<? extends DocTree> description) {
    return docMake.at(NOPOS).newExceptionTree(name, description);
}
Example #22
Source File: RefactoringVisitor.java    From netbeans with Apache License 2.0 4 votes vote down vote up 
public DocTree visitThrows(ThrowsTree node, Element p, Void ignore) {
    return super.visitThrows(node, p);
}
Example #23
Source File: RefactoringVisitor.java    From netbeans with Apache License 2.0 4 votes vote down vote up 
@Override
public DocTree visitThrows(ThrowsTree node, Element p) {
    return instance.visitThrows(node, p);
}
Example #24
Source File: RefactoringVisitor.java    From netbeans with Apache License 2.0 4 votes vote down vote up 
/**
 * @since 1.47
 */
@Override
public DocTree visitThrows(ThrowsTree node, Element p) {
    return docScanner.visitThrows(node, p, null);
}
Example #25
Source File: TreeMaker.java    From netbeans with Apache License 2.0 2 votes vote down vote up 
/**Creates the DocTree's ThrowsTree that will produce @throws.
 * 
 * @param name reference to the documented exception
 * @param description the description of the thrown exception
 * @return newly created ThrowsTree
 * @since 0.124
 */
public ThrowsTree Throws(ReferenceTree name, List<? extends DocTree> description) {
    return delegate.Throws(name, description);
}
Example #26
Source File: DocTreeFactory.java    From openjdk-jdk9 with GNU General Public License v2.0 2 votes vote down vote up 
/**
 * Create a new {@code ExceptionTree} object, to represent an {@code @exception } tag.
 * @param name the name of the exception
 * @param description a description of why the exception might be thrown
 * @return an {@code ExceptionTree} object
 */
ThrowsTree newExceptionTree(ReferenceTree name, List<? extends DocTree> description);
Example #27
Source File: DocTreeFactory.java    From openjdk-jdk9 with GNU General Public License v2.0 2 votes vote down vote up 
/**
 * Create a new {@code ThrowsTree} object, to represent a {@code @throws } tag.
 * @param name the name of the exception
 * @param description a description of why the exception might be thrown
 * @return a {@code ThrowsTree} object
 */
ThrowsTree newThrowsTree(ReferenceTree name, List<? extends DocTree> description);
Example #28
Source File: DocTreeFactory.java    From lua-for-android with BSD 3-Clause "New" or "Revised" License 2 votes vote down vote up 
/**
 * Create a new {@code ThrowsTree} object, to represent a {@code @throws } tag.
 * @param name the name of the exception
 * @param description a description of why the exception might be thrown
 * @return a {@code ThrowsTree} object
 */
ThrowsTree newThrowsTree(ReferenceTree name, List<? extends DocTree> description);
Example #29
Source File: DocTreeFactory.java    From lua-for-android with BSD 3-Clause "New" or "Revised" License 2 votes vote down vote up 
/**
 * Create a new {@code ExceptionTree} object, to represent an {@code @exception } tag.
 * @param name the name of the exception
 * @param description a description of why the exception might be thrown
 * @return an {@code ExceptionTree} object
 */
ThrowsTree newExceptionTree(ReferenceTree name, List<? extends DocTree> description);
Example #30
Source File: TreeMaker.java    From netbeans with Apache License 2.0 2 votes vote down vote up 
/**Creates the DocTree's ThrowsTree that will produce @exception.
 * 
 * @param name reference to the documented exception
 * @param description the description of the thrown exception
 * @return newly created Exception
 * @since 0.124
 */
public ThrowsTree Exception(ReferenceTree name, List<? extends DocTree> description) {
    return delegate.Exception(name, description);
}