基于注释的编程标记

从应用程序开发者要使用的 Java™ 接口和类的集合这种意义上来说,“WebSphere® 快速部署”不会定义传统 API。然而,WRD 的基于注释的编程部分定义了一组 Javadoc 语法标记,可以将这些标记插入源代码中。

  1. 标记类型

    基于注释的编程标记划分为三组:

    • 技术标记

      技术标记直接映射至 J2EE 和其它标准中的关键技术。许多这些标记都直接来源于 XDoclet 社区。有关更多详细信息,请参阅 http://xdoclet.sourceforge.net/xdoclet/index.html

    • 绑定和扩展标记

      这些标记允许您指定特定于 WebSphere 的绑定和扩展数据,并且这些数据不是标准技术的一部分。

    • 行为标记

      行为标记对期望行为或服务质量作注解并且没有特定实现技术。WRD 稍后会在执行过程中确定适当的实现技术。

  2. 范围

    范围指的是标记在 Java 源文件中的位置。四个有效的范围选项是:包、类、方法和字段。

    • 添加至包注释。此范围提供适用于整个 Java 包、模块或者整个应用程序的信息。

    • 添加至类注释。此范围提供有关整个 Java 类型或接口的信息。

    • 方法

      添加至类中的特定方法的注释。此范围提供有关类中所引用方法的信息。

    • 字段

      添加至类中的特定字段的注释。此范围提供特定于类中所引用字段的信息。

  3. 多重性

    多重性指的是一个特定标记在一个 Java 源文件中可以出现的次数。在 XDoclet 表示法中,多重性是在标记名后面的括号中指示的。

    示例

    @ejb.bean(0..1) 表示在 Java 源文件中可以不使用“@ejb.bean”标记或使用一次该标记。

    @ejb.ejb-external-ref(0..*) 表示在 Java 源文件中可以不使用“@ejb.ejb-external-ref”标记或使用无穷多次该标记。

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.