svn commit: r1590904 - /geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/TransientReference.java

[st...@apache.org]

Author: struberg
Date: Tue Apr 29 08:00:41 2014
New Revision: 1590904

URL: http://svn.apache.org/r1590904
Log:
GERONIMO-6458 add @TransientReference

Txs to Arne Limburg (apacheId: arne) for the patch!  

Added:
    geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/TransientReference.java   (with props)

Added: geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/TransientReference.java
URL: http://svn.apache.org/viewvc/geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/TransientReference.java?rev=1590904&view=auto
==============================================================================
--- geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/TransientReference.java (added)
+++ geronimo/specs/trunk/geronimo-jcdi_1.1_spec/src/main/java/javax/enterprise/inject/TransientReference.java Tue Apr 29 08:00:41 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;
+
+import static java.lang.annotation.ElementType.PARAMETER;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+/**
+ * Marks an injected parameter to be destroyed after invocation.
+ *  
+ * When a constructor or a method is annotated with {@link javax.inject.Inject},
+ * its parameters may be annotated with <tt>\@TransientReference</tt>.
+ * If a parameter is annotated with <tt>\@TransientReference</tt>
+ * and the injected bean is {@link javax.enterprise.context.Dependent}-scoped,
+ * it may be destroyed by the container right after the invocation
+ * of the constructor or method.
+ * 
+ * Technically spoken, the parameter will not be added to the
+ * {@link javax.enterprise.context.spi.CreationalContext}
+ * of the bean of the constructor or method, but will be created with a separate
+ * {@link javax.enterprise.context.spi.CreationalContext}
+ * that will be destroyed after the invocation.
+ */
+@Target(value = PARAMETER)
+@Retention(value = RUNTIME)
+@Documented
+public @interface TransientReference
+{
+}
\ No newline at end of file

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