从应用程序开发者要使用的 Java™ 接口和类的集合这种意义上来说,“WebSphere® 快速部署”不会定义传统 API。然而,WRD 的基于注释的编程部分定义了一组 Javadoc 语法标记,可以将这些标记插入源代码中。
标记类型
基于注释的编程标记划分为三组:
技术标记
技术标记直接映射至 J2EE 和其它标准中的关键技术。许多这些标记都直接来源于 XDoclet 社区。有关更多详细信息,请参阅 http://xdoclet.sourceforge.net/xdoclet/index.html。
绑定和扩展标记
这些标记允许您指定特定于 WebSphere 的绑定和扩展数据,并且这些数据不是标准技术的一部分。
行为标记
行为标记对期望行为或服务质量作注解并且没有特定实现技术。WRD 稍后会在执行过程中确定适当的实现技术。
范围
范围指的是标记在 Java 源文件中的位置。四个有效的范围选项是:包、类、方法和字段。
添加至包注释。此范围提供适用于整个 Java 包、模块或者整个应用程序的信息。
添加至类注释。此范围提供有关整个 Java 类型或接口的信息。
添加至类中的特定方法的注释。此范围提供有关类中所引用方法的信息。
添加至类中的特定字段的注释。此范围提供特定于类中所引用字段的信息。
多重性
多重性指的是一个特定标记在一个 Java 源文件中可以出现的次数。在 XDoclet 表示法中,多重性是在标记名后面的括号中指示的。
示例
@ejb.bean(0..1) 表示在 Java 源文件中可以不使用“@ejb.bean”标记或使用一次该标记。
@ejb.ejb-external-ref(0..*) 表示在 Java 源文件中可以不使用“@ejb.ejb-external-ref”标记或使用无穷多次该标记。