模块的元数据设置
使用此页面来指示 Java™ Platform, Enterprise Edition (Java EE) 企业 Bean (EJB) 部署描述符、Web 模块部署描述符或 JCA 资源适配器归档 (RAR) 模块以忽略用于指定部署信息的注释。
要查看此管理控制台页面,请单击模块的元数据”页面相同。
。此页面与应用程序安装和更新向导中的“如果应用程序中包含 Java EE 5 或更高版本模块,那么您可以在“模块的元数据”页面上选择锁定一个或多个模块的部署描述符。如果您选中 metadata-complete 属性复选框(将 metadata-complete 属性设置为 true)并且锁定部署描述符,那么产品会将完整的模块部署描述符(包括注释中的部署信息)编写为 XML 格式。
注释是一种对 Java 类添加元数据的标准机制。可以使用元数据来简化 Java EE 5 或更高版本工件的开发和部署。在引入 Java 语言注释之前,部署描述符是 Java EE 组件使用的标准机制。这些部署描述符被映射至 XML 格式,这样便于持久保存。如果您选择锁定部署描述符,那么产品会将基于 Java EE 注释的元数据与基于 XML 的现有部署描述符元数据进行合并,并保存结果。
- 确定模块是否需要使用 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 文件中)有多层压缩,所以对其进行搜索会非常麻烦。
模块
指定已安装(或已部署)的应用程序中的模块的名称。
信息 | 值 |
---|---|
数据类型 | String |
URI
指定模块相对于 EAR 文件根的位置。
信息 | 值 |
---|---|
数据类型 | String |
metadata-complete 属性
指定是否将完整的模块部署描述符(包括注释中的部署信息)编写为可扩展标记语言 (XML) 格式。
缺省情况下,未选中 metadata-complete 属性复选框,并且产品不会将注释数据写出到模块部署描述符。
如果模块的 metadata-complete 属性或 metadata-complete 属性未设置为 false,那么您可以选中一个复选框并指示产品将注释数据写出到模块部署描述符。

选中复选框之后,就不能取消选中(清除)该复选框,并且该模块将不再显示在此页面上的模块列表中。如果选中了所有复选框,那么与此页面的链接将不再显示在“企业应用程序设置”页面上。
信息 | 值 |
---|---|
数据类型 | Boolean |
缺省值 | false(已取消选中) |