Event prototype: Annotations for producers and consumers

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

2 files changed, 89 insertions, 0 deletions

diff --git a/sandbox/event/modules/sca-api/src/main/java/org/osoa/sca/annotations/Consumer.java b/sandbox/event/modules/sca-api/src/main/java/org/osoa/sca/annotations/Consumer.java
new file mode 100644
index 0000000000..58e479f53d
--- /dev/null
+++ b/sandbox/event/modules/sca-api/src/main/java/org/osoa/sca/annotations/Consumer.java
@@ -0,0 +1,38 @@
+/*
+ * 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 org.osoa.sca.annotations;
+
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+/**
+ * Annotation used to indicate the consumer method exposed by a Java class.
+ *
+ * @version $$
+ */
+@Target({METHOD})
+@Retention(RUNTIME)
+public @interface Consumer {
+	
+	String name() default "";
+	
+}
diff --git a/sandbox/event/modules/sca-api/src/main/java/org/osoa/sca/annotations/Producer.java b/sandbox/event/modules/sca-api/src/main/java/org/osoa/sca/annotations/Producer.java
new file mode 100644
index 0000000000..080c50dcf0
--- /dev/null
+++ b/sandbox/event/modules/sca-api/src/main/java/org/osoa/sca/annotations/Producer.java
@@ -0,0 +1,51 @@
+/*
+ * 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 org.osoa.sca.annotations;
+
+import static java.lang.annotation.ElementType.FIELD;
+import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.ElementType.PARAMETER;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
+/**
+ * Annotation used to indicate a constructor parameter, field or method that is used to inject a producer.
+ *
+ * @version $$
+ */
+@Target({METHOD, FIELD, PARAMETER})
+@Retention(RUNTIME)
+public @interface Producer {
+    /**
+     * The name of the producer. If not specified then the name will be derived from the annotated field or method.
+     *
+     * @return the name of the producer
+     */
+    String name() default "";
+
+    /**
+     * Indicates if a producer must be specified.
+     *
+     * @return true if a producer must be specified
+     */
+    boolean required() default true;
+}
+