WebSphere® Rapid Deployment does not define traditional APIs in the sense of a collection of Java™ interfaces and classes to be used by an application developer. Instead, the annotation-based programming portion of WRD defines a collection of Javadoc-syntax tags that you insert into your source code.
Types of Tags
Annotation-based programming tags are classified in three groups:
Technology Tags
Technology tags map directly to key technologies in J2EE and other standards. Many of these tags are derived directly from the XDoclet community. See http://xdoclet.sourceforge.net/xdoclet/index.html for more details
Bindings and Extension Tags
These tags allow you to specify WebSphere-specific bindings and extensions data that are not part of standard technology.
Behavioral Tags
Behavioral tags annotate a desired behavior or quality of service and not specific implementation technologies. WRD determines the appropriate implementation technology later in the process.
Scope
Scope refers to the location of the tags within the Java source file. Four valid scope options are package, class, method, and field.
Added to the package comment. This scope provides information applicable to the entire Java package, to the module, or to the application as a whole.
Added to the class comment. This scope provides information about the Java type or interface as a whole.
Added to the comments of a particular method within the class. This scope provides information about the referenced method within the class.
Added to the comments of a particular field within the class. This scope provides information specific to the referenced field within the class.
Multiplicity
Multiplicity refers to the number of times a particular tag can appear in one Java source file. In XDoclet notation, multiplicity is indicated in parenthesis following the tag name
Example
@ejb.bean (0..1) indicates that the "@ejb.bean" tag can be used zero or one time in a Java source file.
@ejb.ejb-external-ref (0..*) indicates that the "@ejb.ejb-external-ref" tag can be used zero to an infinite number of times in a Java source file.