geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From strub...@apache.org
Subject svn commit: r1600038 - in /geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise: context/ inject/ inject/spi/
Date Wed, 04 Jun 2014 09:12:10 GMT
Author: struberg
Date: Wed Jun  4 09:12:09 2014
New Revision: 1600038

URL: http://svn.apache.org/r1600038
Log:
GERONIMO-6514 add a few more missing classes and add JavaDoc

This should now finally be all classes of CDI-1.2

Added:
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Destroyed.java
  (with props)
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Initialized.java
  (with props)
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/Vetoed.java
  (with props)
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSyntheticAnnotatedType.java
      - copied, changed from r1599961, geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSynthethicAnnotatedType.java
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/WithAnnotations.java
  (with props)
Removed:
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSynthethicAnnotatedType.java
Modified:
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/AfterTypeDiscovery.java
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/Unmanaged.java

Added: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Destroyed.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Destroyed.java?rev=1600038&view=auto
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Destroyed.java
(added)
+++ geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Destroyed.java
Wed Jun  4 09:12:09 2014
@@ -0,0 +1,56 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package javax.enterprise.context;
+
+import javax.inject.Qualifier;
+import java.lang.annotation.Annotation;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Qualifier for events which get fired when a Context ends.
+ * The exact point is before the contextual instances of that Context
+ * actually get destroyed.
+ *
+ * Extensions should use a reasonable event object.
+ * For built-in scopes the following event-classes will be used
+ * <ul>
+ *     <li>&#064;RequestScoped: the ServletRequest for web requests, any other
Object for other 'requests'</li>
+ *     <li>&#064;SessionScoped: the HttpSession</li>
+ *     <li>&#064;ApplicationScoped: ServletContext for web apps, any other Object
for other apps</li>
+ *     <li>&#064;ConversationScoped: ServletRequest if handled during a web request,
or any other Object for </li>
+ * </ul>
+ *
+ * @see javax.enterprise.context.Initialized
+ * @since 1.1
+ */
+@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER, ElementType.FIELD})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+@Qualifier
+public @interface Destroyed
+{
+    /**
+     * @return the Scope annotation this is for.
+     */
+    Class<? extends Annotation> value();
+}

Propchange: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Destroyed.java
------------------------------------------------------------------------------
    svn:eol-style = native

Added: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Initialized.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Initialized.java?rev=1600038&view=auto
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Initialized.java
(added)
+++ geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Initialized.java
Wed Jun  4 09:12:09 2014
@@ -0,0 +1,56 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package javax.enterprise.context;
+
+import javax.inject.Qualifier;
+import java.lang.annotation.Annotation;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Qualifier for events which get fired when a Context starts.
+ * The exact point is after the Context gets set up, but before it
+ * accepts storing Contextual Instances in it.
+ *
+ * Extensions should use a reasonable event object.
+ * For built-in scopes the following event-classes will be used
+ * <ul>
+ *     <li>&#064;RequestScoped: the ServletRequest for web requests, any other
Object for other 'requests'</li>
+ *     <li>&#064;SessionScoped: the HttpSession</li>
+ *     <li>&#064;ApplicationScoped: ServletContext for web apps, any other Object
for other apps</li>
+ *     <li>&#064;ConversationScoped: ServletRequest if handled during a web request,
or any other Object for </li>
+ * </ul>
+ *
+ * @see javax.enterprise.context.Destroyed
+ * @since 1.1
+ */
+@Target({ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER, ElementType.FIELD})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+@Qualifier
+public @interface Initialized
+{
+    /**
+     * @return the Scope annotation this is for.
+     */
+    Class<? extends Annotation> value();
+}

Propchange: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/context/Initialized.java
------------------------------------------------------------------------------
    svn:eol-style = native

Added: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/Vetoed.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/Vetoed.java?rev=1600038&view=auto
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/Vetoed.java
(added)
+++ geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/Vetoed.java
Wed Jun  4 09:12:09 2014
@@ -0,0 +1,40 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package javax.enterprise.inject;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Marks a class as to get ignored during CDI processing.
+ *
+ * If placed on a package, then exclude all the classes in that package.
+ * If the same package is used in multiple classpath entries, non-portable behvaiour results.
+ *
+ * @since 1.1
+ */
+@Target({ElementType.TYPE, ElementType.PACKAGE})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface Vetoed
+{
+}

Propchange: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/Vetoed.java
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/AfterTypeDiscovery.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/AfterTypeDiscovery.java?rev=1600038&r1=1600037&r2=1600038&view=diff
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/AfterTypeDiscovery.java
(original)
+++ geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/AfterTypeDiscovery.java
Wed Jun  4 09:12:09 2014
@@ -45,7 +45,7 @@ public interface AfterTypeDiscovery
      *
      * The AnnotatedTypes added via this method will not get passed
      * to Extensions via {@link ProcessAnnotatedType} but only via
-     * {@link ProcessSynthethicAnnotatedType}
+     * {@link ProcessSyntheticAnnotatedType}
      *
      * @param type
      * @param id the unique id or <code>null</code>

Copied: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSyntheticAnnotatedType.java
(from r1599961, geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSynthethicAnnotatedType.java)
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSyntheticAnnotatedType.java?p2=geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSyntheticAnnotatedType.java&p1=geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSynthethicAnnotatedType.java&r1=1599961&r2=1600038&rev=1600038&view=diff
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSynthethicAnnotatedType.java
(original)
+++ geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/ProcessSyntheticAnnotatedType.java
Wed Jun  4 09:12:09 2014
@@ -4,7 +4,7 @@ package javax.enterprise.inject.spi;
  * This event gets fired for AnnotatedTypes which are not a result
  * of the scanning process but got manually added.
  */
-public interface ProcessSynthethicAnnotatedType<X> extends ProcessAnnotatedType<X>
+public interface ProcessSyntheticAnnotatedType<X> extends ProcessAnnotatedType<X>
 {
     /**
      * @return the Extension which added this AnnotatedType

Modified: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/Unmanaged.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/Unmanaged.java?rev=1600038&r1=1600037&r2=1600038&view=diff
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/Unmanaged.java
(original)
+++ geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/Unmanaged.java
Wed Jun  4 09:12:09 2014
@@ -40,6 +40,7 @@ import javax.enterprise.context.spi.Crea
  * Please note that this classes are not thread safe!
  *
  * @param <T> the type of the CDI instance to create
+ * @since 1.1
  */
 public class Unmanaged<T>
 {

Added: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/WithAnnotations.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/WithAnnotations.java?rev=1600038&view=auto
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/WithAnnotations.java
(added)
+++ geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/WithAnnotations.java
Wed Jun  4 09:12:09 2014
@@ -0,0 +1,49 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package javax.enterprise.inject.spi;
+
+import java.lang.annotation.Annotation;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * This allows for applying an annotation filter to
+ * {@link javax.enterprise.inject.spi.ProcessAnnotatedType}.
+ *
+ * Sample usage:
+ * <pre>
+ *     public void processWindowBeans(&#064;Observes &#064;WithAnnotation(WindowBean.class)
ProcessAnnotatedType pat) {..}
+ * </pre>
+ * This Extension method e.g. will get fired for all classes which have a <code>&#064;WindowBean</code>
annotation.
+ *
+ * @since 1.1
+ */
+@Target(ElementType.PARAMETER)
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface WithAnnotations
+{
+    /**
+     * @return the annotations the {@link javax.enterprise.inject.spi.ProcessAnnotatedType}
should get filtered for
+     */
+    Class<? extends Annotation>[] value();
+}

Propchange: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/spi/WithAnnotations.java
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message