svn commit: r507687 - /incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Intent.java

[jb...@apache.org]

Author: jboynes
Date: Wed Feb 14 12:51:08 2007
New Revision: 507687

URL: http://svn.apache.org/viewvc?view=rev&rev=507687
Log:
add targetNamespace and localPart as alternative method of specifying intent qname
add JavaDoc

Modified:
    incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Intent.java

Modified: incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Intent.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Intent.java?view=diff&rev=507687&r1=507686&r2=507687
==============================================================================
--- incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Intent.java (original)
+++ incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Intent.java Wed Feb 14 12:51:08 2007
@@ -6,10 +6,35 @@
 import java.lang.annotation.Target;
 
 /**
+ * Annotation that can be applied to annotations that describe SCA intents.
+ * Adding this annotation allows SCA runtimes to automatically detect user-defined intents.
+ * <p/>
+ * Applications must specify a value, a pairing of targetNamespace and localPort, or both.
+ * If both value and pairing are supplied they must define the name qualified name.
+ *
  * @version $Rev$ $Date$
  */
 @Target({ANNOTATION_TYPE})
 @Retention(RetentionPolicy.RUNTIME)
 public @interface Intent {
-    String value();
+    /**
+     * The qualified name of the intent, in the form defined by {@link javax.xml.namespace.QName#toString}.
+     *
+     * @return the qualified name of the intent
+     */
+    String value() default "";
+
+    /**
+     * The XML namespace for the intent.
+     *
+     * @return the XML namespace for the intent
+     */
+    String targetNamespace() default "";
+
+    /**
+     * The name of the intent within its namespace.
+     *
+     * @return name of the intent within its namespace
+     */
+    String localPart() default "";
 }



---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org