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

[jb...@apache.org]

Author: jboynes
Date: Wed Feb 14 13:54:56 2007
New Revision: 507707

URL: http://svn.apache.org/viewvc?view=rev&rev=507707
Log:
add javadoc

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

Modified: incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Confidentiality.java
URL: http://svn.apache.org/viewvc/incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Confidentiality.java?view=diff&rev=507707&r1=507706&r2=507707
==============================================================================
--- incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Confidentiality.java (original)
+++ incubator/tuscany/java/spec/sca-api-r1.0/src/main/java/org/osoa/sca/annotations/Confidentiality.java Wed Feb 14 13:54:56 2007
@@ -2,22 +2,45 @@
 
 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.ElementType.TYPE;
 import java.lang.annotation.Retention;
-import java.lang.annotation.RetentionPolicy;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
 import java.lang.annotation.Target;
 
 import static org.osoa.sca.Constants.SCA_PREFIX;
 
 /**
+ * Annotation denoting the intent that service operations require confidentiality.
+ * <p/>
+ * Applied to the injection site (field, method or constructor parameter) for a reference,
+ * it indicates that all invocations through that reference require confidentiality.
+ * <p/>
+ * Applied to a interface method on a service contract, it indicates that all invocations
+ * of that service operation require confidentiality; applied to the type of a service contract,
+ * it indicates that all service operations on that interface require confidentiality.
+ * <p/>
+ * Applied to a method on an implementation class, it indicates that all invocations that
+ * are dispatched to that implementation method (through any service) require confidentiality.
+ * Applied to a interface implemented by an implementation class, it indicates that all
+ * invocations that are dispatched to the implementation method for that interface operation
+ * require confidentiality.
+ * <p/>
+ * Applied to an implementation class, it indicates that all invocations of that implementation
+ * and that all invocations made by that implementation require confidentiality.
+ *  
  * @version $Rev$ $Date$
  */
-@Target({TYPE, FIELD, METHOD})
-@Retention(RetentionPolicy.RUNTIME)
+@Target({TYPE, FIELD, METHOD, PARAMETER})
+@Retention(RUNTIME)
 @Intent(Confidentiality.CONFIDENTIALITY)
 public @interface Confidentiality {
     String CONFIDENTIALITY = SCA_PREFIX + "confidentiality";
 
+    /**
+     * List of confidentiality qualifiers (such as "message" or "transport").
+     * @return confidentiality qualifiers
+     */
     @Qualifier
     String[] value() default "";
 }



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