Author: gavin.king(a)jboss.com Date: 2009-10-28 23:56:24 -0400 (Wed, 28 Oct 2009) New Revision: 4375 Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Annotated.java api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedCallable.java api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedConstructor.java api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedField.java api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedMember.java api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedMethod.java api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedParameter.java api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedType.java Log: Refresh all Annotated stuff Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Annotated.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Annotated.java 2009-10-29 03:43:10 UTC (rev 4374) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Annotated.java 2009-10-29 03:56:24 UTC (rev 4375) @@ -22,7 +22,7 @@ import java.util.Set; /** - * <p>Represents an annotated program element.<p> + * <p>Represents a Java program element that can be annotated.<p> * * <p>A portable extension may provide an alternative metadata * source, such as configuration by XML. <tt>Annotated</tt> Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedCallable.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedCallable.java 2009-10-29 03:43:10 UTC (rev 4374) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedCallable.java 2009-10-29 03:56:24 UTC (rev 4375) @@ -16,24 +16,21 @@ */ package javax.enterprise.inject.spi; -import java.lang.reflect.Member; import java.util.List; /** - * The metadata for a callable member which can be parsed by the - * {@link BeanManager}. + * <p>Represents a callable member of a Java type.</p> * - * The semantics are similar to {@link Member} - * + * @author Gavin King * @author Pete Muir * - * @param <X> the type of the member + * @param <X> the declaring type */ public interface AnnotatedCallable<X> extends AnnotatedMember<X> { /** - * Get the parameters of the callable member. + * <p>Get the parameters of the callable member.</p> * * @return the parameters */ Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedConstructor.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedConstructor.java 2009-10-29 03:43:10 UTC (rev 4374) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedConstructor.java 2009-10-29 03:56:24 UTC (rev 4375) @@ -20,22 +20,21 @@ import java.lang.reflect.Constructor; /** - * The metadata for an annotated constructor which can be parsed by the - * {@link BeanManager}. + * <p>Represents a constructor of a Java class.</p> * - * The semantics are similar to {@link Constructor}. - * + * @author Gavin King * @author Pete Muir * - * @param <X> the type of declaring class + * @param <X> the declaring class + * @see Constructor */ public interface AnnotatedConstructor<X> extends AnnotatedCallable<X> { /** - * Get the underlying {@link Constructor} instance. + * <p>Get the underlying {@link Constructor}.</p> * - * @return the constructor instance + * @return the constructor */ public Constructor<X> getJavaMember(); Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedField.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedField.java 2009-10-29 03:43:10 UTC (rev 4374) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedField.java 2009-10-29 03:56:24 UTC (rev 4375) @@ -17,23 +17,22 @@ package javax.enterprise.inject.spi; import java.lang.reflect.Field; -import java.lang.reflect.Member; /** - * The metadata for an annotated field which can be parsed by the {@link BeanManager}. + * <p>Represents a field of a Java class.</p> * - * The semantics are similar to {@link Field}. - * + * @author Gavin King * @author Pete Muir * - * @param <X> the type of the field + * @param <X> the declaring type + * @see Field */ public interface AnnotatedField<X> extends AnnotatedMember<X> { /** - * Get the underlying {@link Member} instance. + * <p>Get the underlying {@link Field}.</p> * - * @return the member instance + * @return the {@link Field} */ public Field getJavaMember(); Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedMember.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedMember.java 2009-10-29 03:43:10 UTC (rev 4374) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedMember.java 2009-10-29 03:56:24 UTC (rev 4375) @@ -20,32 +20,35 @@ import java.lang.reflect.Member; /** - * The metadata for an annotated member which can be parsed by the - * {@link BeanManager}. The semantics are similar to {@link Member}. + * <p>Represents a member of a Java type.</p> * + * @author Gavin King * @author Pete Muir - * @param <X> the type of the declaring type + * + * @param <X> the declaring type + * @see Member */ public interface AnnotatedMember<X> extends Annotated { /** - * Get the underlying {@link Member} instance. + * <p>Get the underlying {@link Member}.</p> * - * @return the {@linkplain Member member} + * @return the {@link Member} */ public Member getJavaMember(); /** - * Determines if the member is static. + * <p>Determines if the member is static.</p> * - * @return true if the member is static + * @return <tt>true</tt> if the member is static */ public boolean isStatic(); /** - * Get the {@linkplain AnnotatedType type} which declares this member. + * <p>Get the {@linkplain AnnotatedType type} which declares this + * member.</p> * - * @return the {@linkplain AnnotatedType type} of which declares this member + * @return the type which declares this member */ public AnnotatedType<X> getDeclaringType(); } Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedMethod.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedMethod.java 2009-10-29 03:43:10 UTC (rev 4374) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedMethod.java 2009-10-29 03:56:24 UTC (rev 4375) @@ -19,18 +19,21 @@ import java.lang.reflect.Method; /** - * The metadata for an annotated method which can be parsed by the - * {@link BeanManager}. The semantics are similar to {@link Method}. + * <p>Represents a method of a Java type.</p> * + * @author Gavin King * @author Pete Muir - * @param <X> the return type of the method + * + * @param <X> the declaring type + * @see Method */ public interface AnnotatedMethod<X> extends AnnotatedCallable<X> { /** - * Get the underlying {@link Method} instance. return the {@linkplain Method - * method} + * <p>Get the underlying {@link Method}.</p> + * + * @return the {@link Method} */ public Method getJavaMember(); } Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedParameter.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedParameter.java 2009-10-29 03:43:10 UTC (rev 4374) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedParameter.java 2009-10-29 03:56:24 UTC (rev 4375) @@ -18,27 +18,29 @@ package javax.enterprise.inject.spi; /** - * The metadata for an annotated parameter which can be parsed by the - * {@link BeanManager}. + * <p>Represents a parameter of a method or constructor.</p> * + * @author Gavin King * @author Pete Muir * - * @param <X> the type of the parameter + * @param <X> the type that declares the method or constructor */ public interface AnnotatedParameter<X> extends Annotated { /** - * The position of the parameter in the callable's argument list. + * <p>Get the position of the parameter in the method or + * constructor argument list.</p> * * @return the position of the parameter */ public int getPosition(); /** - * The declaring {@linkplain AnnotatedCallable callable}. + * <p>Get the declaring {@linkplain AnnotatedCallable method or + * constructor}.</p> * - * @return the declaring {@linkplain AnnotatedCallable callable} + * @return the declaring callable */ public AnnotatedCallable<X> getDeclaringCallable(); Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedType.java =================================================================== --- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedType.java 2009-10-29 03:43:10 UTC (rev 4374) +++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/AnnotatedType.java 2009-10-29 03:56:24 UTC (rev 4375) @@ -20,41 +20,44 @@ import java.util.Set; /** - * The metadata for an annotated type which can be parsed by the - * {@link BeanManager}. The semantics are similar to {@link Class}. + * <p>Represents a Java type.</p> * + * @author Gavin King * @author Pete Muir - * @param <X> the type of the class + * + * @param <X> the type + * @see java.lang.Class */ public interface AnnotatedType<X> extends Annotated { /** - * Get the underlying {@linkplain java.lang.Class class} instance. + * <p>Get the underlying {@link java.lang.Class}.</p> * - * @return the {@link java.lang.Class} of the instance + * @return the {@link java.lang.Class} */ public Class<X> getJavaClass(); /** - * Get the {@linkplain AnnotatedConstructor constructors} belonging to the class If an empty set is returned, a - * default (no-args) constructor will be assumed. + * <p>Get the {@linkplain AnnotatedConstructor constructors} of the type. + * If an empty set is returned, a default constructor with no parameters + * will be assumed.</p> * - * @return the {@linkplain AnnotatedConstructor constructors}, or an empty set if none are defined + * @return the constructors, or an empty set if none are defined */ public Set<AnnotatedConstructor<X>> getConstructors(); /** - * Get the {@linkplain AnnotatedMethod business methods} belonging to the class. + * <p>Get the {@linkplain AnnotatedMethod methods} of the type.</p> * - * @return the {@linkplain AnnotatedMethod methods}, or an empty set if none are defined + * @return the methods, or an empty set if none are defined */ public Set<AnnotatedMethod<? super X>> getMethods(); /** - * Get the {@linkplain AnnotatedField fields} belonging to the class. + * <p>Get the {@linkplain AnnotatedField fields} of the type.<p> * - * @return the {@linkplain AnnotatedField fields}, or an empty set if none are defined + * @return the fields, or an empty set if none are defined */ public Set<AnnotatedField<? super X>> getFields(); }