Branch to experiment with dynamic component interfaces and implementations.

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@965346 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 36 insertions, 0 deletions

diff --git a/sandbox/sebastien/java/dynamic/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Scope.java b/sandbox/sebastien/java/dynamic/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Scope.java
new file mode 100644
index 0000000000..087f589168
--- /dev/null
+++ b/sandbox/sebastien/java/dynamic/modules/sca-api/src/main/java/org/oasisopen/sca/annotation/Scope.java
@@ -0,0 +1,36 @@
+/*
+ * Copyright(C) OASIS(R) 2005,2010. All Rights Reserved.
+ * OASIS trademark, IPR and other policies apply.
+ */
+package org.oasisopen.sca.annotation;
+
+import static java.lang.annotation.ElementType.TYPE;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+/**
+ * The @Scope annotation MUST only be used on a service's implementation
+ * class. It is an error to use this annotation on an interface.
+ */
+@Target(TYPE)
+@Retention(RUNTIME)
+public @interface Scope {
+
+    /**
+     * The name of the scope.
+     *
+     * For 'STATELESS' implementations, a different implementation
+     * instance can be used to service each request. Implementation
+     * instances can be newly created or be drawn from a pool of instances.
+     *
+     * SCA defines the following scope names, but others can be defined
+     * by particular Java-based implementation types:
+     *  STATELESS
+     *  COMPOSITE
+     * The default value is STATELESS.
+     *
+     * @return the name of the scope
+     */
+    String value() default "STATELESS";
+}