[weld-commits] Weld SVN: r4485 - api/trunk/cdi/src/main/java/javax/enterprise/inject/spi.

[weld-commits at lists.jboss.org]

Author: gavin.king at jboss.com
Date: 2009-10-31 10:27:27 -0400 (Sat, 31 Oct 2009)
New Revision: 4485

Modified:
   api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Decorator.java
   api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Interceptor.java
   api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/ObserverMethod.java
Log:
links

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Decorator.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Decorator.java	2009-10-31 14:05:35 UTC (rev 4484)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Decorator.java	2009-10-31 14:27:27 UTC (rev 4485)
@@ -22,7 +22,7 @@
 import java.util.Set;
 
 /**
- * <p>Represents an enabled decorator.</p>
+ * <p>Represents an enabled {@linkplain javax.decorator decorator}.</p>
  * 
  * @author Gavin King
  * @author Pete Muir
@@ -33,22 +33,23 @@
 {
 
    /**
-    * <p>Obtains the delegate {@linkplain Type type}.</p>
+    * <p>Obtains the {@linkplain Type type} of the 
+    * {@linkplain javax.decorator.Delegate delegate injection point}.</p>
     * 
     * @return the delegate {@linkplain Type type}
     */
    public Type getDelegateType();
 
    /**
-    * <p>Obtains the {@linkplain javax.inject.Qualifier qualifiers} of the delegate
-    * injection point.</p>
+    * <p>Obtains the {@linkplain javax.inject.Qualifier qualifiers} of the 
+    * {@linkplain javax.decorator.Delegate delegate injection point}.</p>
     * 
     * @return the delegate {@linkplain javax.inject.Qualifier qualifiers}
     */
    public Set<Annotation> getDelegateQualifiers();
    
    /**
-    * <p>Obtains the decorated {@linkplain Type types}.</p>
+    * <p>Obtains the {@linkplain javax.decorator decorated types}.</p>
     * 
     * @return the set of decorated {@linkplain Type types}
     */

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Interceptor.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Interceptor.java	2009-10-31 14:05:35 UTC (rev 4484)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/Interceptor.java	2009-10-31 14:27:27 UTC (rev 4485)
@@ -23,7 +23,7 @@
 import javax.interceptor.InvocationContext;
 
 /**
- * <p>Represents an enabled interceptor.</p>
+ * <p>Represents an enabled {@linkplain javax.interceptor interceptor}.</p>
  * 
  * @author Gavin King
  * @author Pete Muir
@@ -46,7 +46,7 @@
     * <p>Determines if the interceptor intercepts the specified 
     * {@linkplain InterceptionType kind of lifecycle callback or method invocation}.</p>
     * 
-    * @param type the type of interception
+    * @param type the {@linkplain InterceptionType kind of interception}
     * @return  returns <tt>true</tt> if the interceptor intercepts callbacks 
     * or business methods of the given type, and <tt>false</tt> otherwise.
     */
@@ -56,10 +56,10 @@
     * <p>Invokes the specified {@linkplain InterceptionType kind of lifecycle 
     * callback or method invocation interception} upon the given interceptor instance.</p>
     * 
-    * @param type the interception type
+    * @param type the {@linkplain InterceptionType kind of interception}
     * @param instance the interceptor instance to invoke
     * @param ctx the context for the invocation
-    * @return the return value from the invocation
+    * @return the invocation return value
     */
    public Object intercept(InterceptionType type, T instance, InvocationContext ctx); 
 

Modified: api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/ObserverMethod.java
===================================================================
--- api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/ObserverMethod.java	2009-10-31 14:05:35 UTC (rev 4484)
+++ api/trunk/cdi/src/main/java/javax/enterprise/inject/spi/ObserverMethod.java	2009-10-31 14:27:27 UTC (rev 4485)
@@ -18,21 +18,22 @@
 public interface ObserverMethod<T>
 {
    /**
-    * Obtains the {@linkplain Class class} of bean defining the observer method.
+    * Obtains the bean {@linkplain Class class} of the bean that declares the 
+    * observer method.
     * 
     * @return the defining {@linkplain Class class}
     */
    public Class<?> getBeanClass();
 
    /**
-    * Obtains the observed event {@linkplain Type type}.
+    * Obtains the {@linkplain javax.enterprise.event observed event type}.
     * 
     * @return the observed event {@linkplain Type type}
     */
    public Type getObservedType();
 
    /**
-    * Obtains the set of observed event {@linkplain javax.inject.Qualifier qualifiers}.
+    * Obtains the set of {@linkplain javax.enterprise.event observed event qualifiers}.
     * 
     * @return the observed event {@linkplain javax.inject.Qualifier qualifiers}
     */
@@ -54,7 +55,7 @@
    public TransactionPhase getTransactionPhase();
 
    /**
-    * Calls the observer method passing the given event object.
+    * Calls the observer method, passing the given event object.
     * 
     * @param event the event object
     */