svn commit: r788938 - /incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java

[ge...@apache.org]

Author: gerdogdu
Date: Sat Jun 27 08:48:58 2009
New Revision: 788938

URL: http://svn.apache.org/viewvc?rev=788938&view=rev
Log:
OWB-108 Updating of the injection point interface.

Modified:
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java?rev=788938&r1=788937&r2=788938&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/inject/spi/InjectionPoint.java Sat Jun 27 08:48:58 2009
@@ -14,7 +14,10 @@
 package javax.enterprise.inject.spi;
 
 import java.lang.annotation.Annotation;
+import java.lang.reflect.Constructor;
+import java.lang.reflect.Field;
 import java.lang.reflect.Member;
+import java.lang.reflect.Method;
 import java.lang.reflect.Type;
 import java.util.Set;
 
@@ -29,24 +32,70 @@
  *  <li>a disposer method</li>
  *  <li>an observer method</li>
  * </ul>
+ * 
+ * @version $Rev$ $Date$
  */
 public interface InjectionPoint
 {
+    /**
+     * Returns required type of the injection point.
+     * 
+     * @return type of the injection point
+     */
     public Type getType();
 
+    /**
+     * Returns required binding types of the injection point.
+     * 
+     * @return bindings at the injection point
+     */
     public Set<Annotation> getBindings();
 
+    /**
+     * Returns the injection point owner bean.
+     * <p>
+     * If there is no bean for the injection point,
+     * it returns null.
+     * </p>
+     * 
+     * @return injection point owner bean
+     */
     public Bean<?> getBean();
 
+    /**
+     * Returns appered point for injection point. One of
+     * <ul>
+     *  <li>{@link Field} object</li>
+     *  <li>{@link Constructor} parameter</li>
+     *  <li>{@link Method} producer method parameter</li>
+     *  <li>{@link Method} disposal method parameter</li>
+     *  <li>{@link Method} observer method parameter</li>
+     * </ul>
+     * 
+     * @return where the injection point is appeared 
+     */
     public Member getMember();
-
-    /** @deprecated old signatures have to be dropped */
-    public <T extends Annotation> T getAnnotation(Class<T> annotationType);
-
-    /** @deprecated old signatures have to be dropped */
-    public Annotation[] getAnnotations();
-
-    /** @deprecated old signatures have to be dropped */
-    public boolean isAnnotationPresent(Class<? extends Annotation> annotationType);
-
+    
+    /**
+     * Returns annotated object representation of member.
+     * 
+     * @return annotated
+     */
+    public Annotated getAnnotated();
+    
+    /**
+     * Returns true if injection point is decorator delegate,
+     * false otherwise.
+     * 
+     * @return true if injection point is decorator delegate
+     */
+    public boolean isDelegate();
+    
+    /**
+     * Returns true if injection point is transient,
+     * false otherwise.
+     * 
+     * @return true if injection point is transient
+     */
+    public boolean isTransient();
 }