You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openwebbeans.apache.org by ge...@apache.org on 2009/07/04 20:57:35 UTC

svn commit: r791163 - in /incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax: decorator/ enterprise/context/spi/ enterprise/event/ event/

Author: gerdogdu
Date: Sat Jul  4 18:57:34 2009
New Revision: 791163

URL: http://svn.apache.org/viewvc?rev=791163&view=rev
Log:
Reflecting API changes. Removing old classes.

Removed:
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/AfterTransactionCompletion.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/AfterTransactionFailure.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/AfterTransactionSuccess.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Asynchronously.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/BeforeTransactionCompletion.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/IfExists.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/event/
Modified:
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorates.java   (contents, props changed)
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorator.java   (contents, props changed)
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Context.java   (contents, props changed)
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Contextual.java   (contents, props changed)
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/CreationalContext.java   (contents, props changed)
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Event.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Notify.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observer.java   (contents, props changed)
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/ObserverException.java
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observes.java   (contents, props changed)
    incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/TransactionPhase.java

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorates.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorates.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorates.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorates.java Sat Jul  4 18:57:34 2009
@@ -20,6 +20,12 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
+/**
+ * Annotates delegate bean.
+ * 
+ * @version $Rev$ $Date$
+ *
+ */
 @Target(FIELD)
 @Retention(RUNTIME)
 @Documented

Propchange: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorates.java
------------------------------------------------------------------------------
    svn:keywords = Rev Date

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorator.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorator.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorator.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorator.java Sat Jul  4 18:57:34 2009
@@ -22,6 +22,12 @@
 
 import javax.enterprise.inject.stereotype.Stereotype;
 
+/**
+ * Defines decorator classes.
+ * 
+ * @version $Rev$ $Date$
+ *
+ */
 @Target(value = ElementType.TYPE)
 @Retention(value = RetentionPolicy.RUNTIME)
 @Documented

Propchange: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/decorator/Decorator.java
------------------------------------------------------------------------------
    svn:keywords = Rev Date

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Context.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Context.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Context.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Context.java Sat Jul  4 18:57:34 2009
@@ -37,6 +37,7 @@
  * webbeans components.
  * </p>
  * 
+ * @version $Rev$ $Date$
  */
 public interface Context
 {   

Propchange: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Context.java
------------------------------------------------------------------------------
    svn:keywords = Rev Date

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Contextual.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Contextual.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Contextual.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Contextual.java Sat Jul  4 18:57:34 2009
@@ -24,6 +24,8 @@
  * 
  * @param <T> type of the webbeans component
  * @see Context
+ * 
+ * @version $Rev$ $Date$
  */
 public interface Contextual<T>
 {

Propchange: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/Contextual.java
------------------------------------------------------------------------------
    svn:keywords = Rev Date

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/CreationalContext.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/CreationalContext.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/CreationalContext.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/CreationalContext.java Sat Jul  4 18:57:34 2009
@@ -31,6 +31,7 @@
  * Generally it is used for prohibiting the circular references of the webbeans.
  * </p>
  * 
+ * @version $Rev$ $Date$
  */
 public interface CreationalContext<T>
 {

Propchange: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/context/spi/CreationalContext.java
------------------------------------------------------------------------------
    svn:keywords = Rev Date

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Event.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Event.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Event.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Event.java Sat Jul  4 18:57:34 2009
@@ -15,11 +15,17 @@
 
 import java.lang.annotation.Annotation;
 
+import javax.enterprise.inject.TypeLiteral;
+
 public interface Event<T>
 {
 
-    public void fire(T event, Annotation... bindings);
-
-    public void observe(Observer<T> observer, Annotation... bindings);
+    public void fire(T event);
+    
+    public Event<T> select(Annotation... bindings);
+    
+    public <U extends T> Event<U> select(Class<U> subtype, Annotation... bindings);
+    
+    public <U extends T> Event<U> select(TypeLiteral<U> subtype, Annotation... bindings);
 
 }

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Notify.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Notify.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Notify.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Notify.java Sat Jul  4 18:57:34 2009
@@ -21,7 +21,9 @@
  */
 public enum Notify
 {
-    SYNCHRONOUSLY,    
-    ASYNCHRONOUSLY,
-    IF_EXISTS    
+    /**Notify observer if owner bean exist*/
+    IF_EXISTS,
+    
+    /**Always notify observer*/
+    ALWAYS
 }

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observer.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observer.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observer.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observer.java Sat Jul  4 18:57:34 2009
@@ -13,7 +13,20 @@
  */
 package javax.enterprise.event;
 
+/**
+ * Container call {@link Observer#notify(Object)}
+ * method when firing events with given T. 
+ * 
+ * @version $Rev$ $Date$
+ *
+ * @param <T> event type
+ */
 public interface Observer<T>
 {
+    /**
+     * Notifies the observer.
+     * 
+     * @param event event object
+     */
     public void notify(T event);
 }
\ No newline at end of file

Propchange: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observer.java
------------------------------------------------------------------------------
    svn:keywords = Rev Date

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/ObserverException.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/ObserverException.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/ObserverException.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/ObserverException.java Sat Jul  4 18:57:34 2009
@@ -13,29 +13,53 @@
  */
 package javax.enterprise.event;
 
-
+/**
+ * Exception related with observers.
+ * 
+ * @version $Rev$ $Date$
+ *
+ */
 public class ObserverException extends RuntimeException
 {
     private static final long serialVersionUID = -6392759733390664652L;
 
+    /**
+     * Creates new exception.
+     */
     public ObserverException()
     {
 
     }
 
+    /**
+     * Creates new exception with message.
+     * 
+     * @param message exception message
+     */
     public ObserverException(String message)
     {
         super(message);
     }
 
+    /**
+     * Creates new exception with cause.
+     * 
+     * @param cause exception cause
+     */
     public ObserverException(Throwable cause)
     {
         super(cause);
     }
 
+    /**
+     * Creates new exception with given message and cause.
+     * 
+     * @param message exception message
+     * @param cause exception cause
+     */
     public ObserverException(String message, Throwable cause)
     {
         super(message, cause);
     }
 
-}
+}
\ No newline at end of file

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observes.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observes.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observes.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observes.java Sat Jul  4 18:57:34 2009
@@ -20,10 +20,20 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.Target;
 
+/**
+ * Speicifies that method is observer method.
+ * 
+ * @version $Rev$ $Date$
+ * 
+ */
 @Target(PARAMETER)
 @Retention(RUNTIME)
 @Documented
 public @interface Observes
 {
-
-}
+    /**Specifies whether or not call observer according to owner bean instace*/
+    public Notify notifyObserver() default Notify.ALWAYS;
+    
+    /**Transaction phase*/
+    public TransactionPhase during() default TransactionPhase.IN_PROGRESS;
+}
\ No newline at end of file

Propchange: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/Observes.java
------------------------------------------------------------------------------
    svn:keywords = Rev Date

Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/TransactionPhase.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/TransactionPhase.java?rev=791163&r1=791162&r2=791163&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/TransactionPhase.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/enterprise/event/TransactionPhase.java Sat Jul  4 18:57:34 2009
@@ -15,16 +15,28 @@
 
 /**
  * Transactional observer phases.
- * Observers are notified on trnasaction phases.
+ * 
+ * <p>
+ * Observers are notified on transaction phases.
+ * </p>
  * 
  * @version $Rev$ $Date$
  *
  */
 public enum TransactionPhase
 {
+    /**Means in trnasaction*/
     IN_PROGRESS,
+    
+    /**Before completion phase*/
     BEFORE_COMPLETION,
+    
+    /**After completion phase*/
     AFTER_COMPLETION,
+    
+    /**After failure phase*/
     AFTER_FAILURE,
+    
+    /**After success phase*/
     AFTER_SUCCESS
 }