jdk8-mips64-public/langtools: comparison src/share/classes/javax/lang/model/util/Types.java

-:5c956be64b9e
+:71f35e4b93a5
 /*
-* Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved.
+* Copyright (c) 2005, 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.  Oracle designates this
 * questions.
 */
 package javax.lang.model.util;
+import java.lang.annotation.Annotation;
+import java.lang.annotation.AnnotationTypeMismatchException;
+import java.lang.annotation.IncompleteAnnotationException;
 import java.util.List;
 import javax.lang.model.element.*;
 import javax.lang.model.type.*;
 /**
 * @return the type of the element as viewed from the containing type
 * @throws IllegalArgumentException if the element is not a valid one
 *          for the given type
 */
 TypeMirror asMemberOf(DeclaredType containing, Element element);
+/**
+* Returns the annotations targeting the type.
+*
+* @param type the targeted type
+* @return the type annotations targeting the type
+*/
+List<? extends AnnotationMirror> typeAnnotationsOf(TypeMirror type);
+/**
+* Returns the type's annotation for the specified type if
+* such an annotation is present, else {@code null}.  The
+* annotation has to be directly present on this
+* element.
+*
+* <p> The annotation returned by this method could contain an element
+* whose value is of type {@code Class}.
+* This value cannot be returned directly:  information necessary to
+* locate and load a class (such as the class loader to use) is
+* not available, and the class might not be loadable at all.
+* Attempting to read a {@code Class} object by invoking the relevant
+* method on the returned annotation
+* will result in a {@link MirroredTypeException},
+* from which the corresponding {@link TypeMirror} may be extracted.
+* Similarly, attempting to read a {@code Class[]}-valued element
+* will result in a {@link MirroredTypesException}.
+*
+* <blockquote>
+* <i>Note:</i> This method is unlike others in this and related
+* interfaces.  It operates on runtime reflective information &mdash;
+* representations of annotation types currently loaded into the
+* VM &mdash; rather than on the representations defined by and used
+* throughout these interfaces.  Consequently, calling methods on
+* the returned annotation object can throw many of the exceptions
+* that can be thrown when calling methods on an annotation object
+* returned by core reflection.  This method is intended for
+* callers that are written to operate on a known, fixed set of
+* annotation types.
+* </blockquote>
+*
+* @param <A>   the annotation type
+* @param type  the targeted type
+* @param annotationType  the {@code Class} object corresponding to
+*          the annotation type
+* @return the type's annotation for the specified annotation
+*         type if present on the type, else {@code null}
+*
+* @see Element#getAnnotationMirrors()
+* @see EnumConstantNotPresentException
+* @see AnnotationTypeMismatchException
+* @see IncompleteAnnotationException
+* @see MirroredTypeException
+* @see MirroredTypesException
+*/
+<A extends Annotation> A typeAnnotationOf(TypeMirror type, Class<A> annotationType);
+/**
+* Returns the annotations targeting the method receiver type.
+*
+* @param type the targeted type
+* @return the receiver type of the executable type
+*/
+TypeMirror receiverTypeOf(ExecutableType type);
+/**
+* Returns the type's annotation for the specified executable type
+* receiver if such an annotation is present, else {@code null}.  The
+* annotation has to be directly present on this
+* element.
+*
+* <p> The annotation returned by this method could contain an element
+* whose value is of type {@code Class}.
+* This value cannot be returned directly:  information necessary to
+* locate and load a class (such as the class loader to use) is
+* not available, and the class might not be loadable at all.
+* Attempting to read a {@code Class} object by invoking the relevant
+* method on the returned annotation
+* will result in a {@link MirroredTypeException},
+* from which the corresponding {@link TypeMirror} may be extracted.
+* Similarly, attempting to read a {@code Class[]}-valued element
+* will result in a {@link MirroredTypesException}.
+*
+* <blockquote>
+* <i>Note:</i> This method is unlike others in this and related
+* interfaces.  It operates on runtime reflective information &mdash;
+* representations of annotation types currently loaded into the
+* VM &mdash; rather than on the representations defined by and used
+* throughout these interfaces.  Consequently, calling methods on
+* the returned annotation object can throw many of the exceptions
+* that can be thrown when calling methods on an annotation object
+* returned by core reflection.  This method is intended for
+* callers that are written to operate on a known, fixed set of
+* annotation types.
+* </blockquote>
+*
+* @param <A>   the annotation type
+* @param type  the method type
+* @param annotationType  the {@code Class} object corresponding to
+*          the annotation type
+* @return the type's annotation for the specified annotation
+*         type if present on the type, else {@code null}
+*
+* @see Element#getAnnotationMirrors()
+* @see EnumConstantNotPresentException
+* @see AnnotationTypeMismatchException
+* @see IncompleteAnnotationException
+* @see MirroredTypeException
+* @see MirroredTypesException
+*/
+// TODO: no longer needed?
+// <A extends Annotation> A receiverTypeAnnotationOf(ExecutableType type, Class<A> annotationType);
 }

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

comparison: src/share/classes/javax/lang/model/util/Types.java

src/share/classes/javax/lang/model/util/Types.java