模块的元数据设置

使用此页面来指示 Java Platform, Enterprise Edition (Java EE) 企业 Bean (EJB) 部署描述符、Web 模块部署描述符或 JCA 资源适配器归档 (RAR) 模块以忽略用于指定部署信息的注释。

要查看此管理控制台页面，请单击应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 模块的元数据。此页面与应用程序安装和更新向导中的“模块的元数据”页面相同。

如果应用程序中包含 Java EE 5 或更高版本模块，那么您可以在“模块的元数据”页面上选择锁定一个或多个模块的部署描述符。如果您选中 metadata-complete 属性复选框（将 metadata-complete 属性设置为 true）并且锁定部署描述符，那么产品会将完整的模块部署描述符（包括注释中的部署信息）编写为 XML 格式。

注释是一种对 Java 类添加元数据的标准机制。可以使用元数据来简化 Java EE 5 或更高版本工件的开发和部署。在引入 Java 语言注释之前，部署描述符是 Java EE 组件使用的标准机制。这些部署描述符被映射至 XML 格式，这样便于持久保存。如果您选择锁定部署描述符，那么产品会将基于 Java EE 注释的元数据与基于 XML 的现有部署描述符元数据进行合并，并保存结果。

应用程序包含大量 Java 类时，注释的部署处理时间可能会增加。为最大程度地减少对性能的影响，可以使用下列其中一种方法：

确定模块是否需要使用 Java EE 5 或 6。如果模块不需要使用 Java EE 5 或 6，那么将不会扫描 Java 类中的注释。
如果模块使用 Java EE 5 或更高版本且不包含任何注释，请在模块描述符中使用 metadata-complete 属性。此属性将对模块禁用注释处理，但仍可将 Java EE 5 或更高版本模块放入描述符文件中。如果要迁移应用程序，但不打算添加注释，请考虑使用此属性值。
如果实用程序 Java 归档 (JAR) 文件不包含注释信息，请重构应用程序以将这些 JAR 文件放入共享库。如果无法设置 metadata-complete 属性，那么请考虑此方法。
将 WEB-INF/lib 目录中的 JAR 文件移至企业归档 (EAR) 文件的根目录。由于嵌套归档（如 JAR 文件在 Web 应用程序归档 (WAR) 中，而 WAR 在 EAR 文件中）有多层压缩，所以对其进行搜索会非常麻烦。

模块

指定已安装（或已部署）的应用程序中的模块的名称。

信息	值
数据类型	字符串

URI

指定模块相对于 EAR 文件根的位置。

信息	值
数据类型	字符串

metadata-complete 属性

指定是否将完整的模块部署描述符（包括注释中的部署信息）编写为可扩展标记语言 (XML) 格式。

缺省情况下，未选中 metadata-complete 属性复选框，并且产品不会将注释数据写出到模块部署描述符。

如果模块的 metadata-complete 属性或 metadata-complete 属性未设置为 false，那么您可以选中一个复选框并指示产品将注释数据写出到模块部署描述符。

避免故障：如果 Java EE 5 或更高版本应用程序使用注释和共享库，请不要选择 metadata-complete 属性。当应用程序使用注释和共享库时，将 metadata-complete 属性设置为 true 会导致产品将部署描述符中的 @EJB 注释错误地表示为 <ejb-ref> 而不是 <ejb-local-ref>。对于 Web 模块，将 metadata-complete 属性设置为 true 可能会导致 InjectionException 错误。如果必须选中 metadata-complete 属性（将 metadata-complete 属性设置为 true），请不要使用共享库、将共享库放入应用程序服务器的 classes 或 lib 目录或者在部署描述符中指定全部元数据，以避免出错。gotcha

选中复选框之后，就不能取消选中（清除）该复选框，并且该模块将不再显示在此页面上的模块列表中。如果选中了所有复选框，那么与此页面的链接将不再显示在“企业应用程序设置”页面上。

信息	值
数据类型	布尔型
缺省值	false（已取消选中）

文件名： urun_rapp_metadata_lockdd.html