[weld-commits] Weld SVN: r4375 - api/trunk/cdi/src/main/java/javax/enterprise/inject/spi.
weld-commits at lists.jboss.org
weld-commits at lists.jboss.org
Wed Oct 28 23:56:24 EDT 2009
Author: gavin.king at 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();
}
More information about the weld-commits
mailing list