查看部署描述符
部署描述符是可扩展标记语言 (XML) 文件,用于指定应用程序或模块的配置和容器选项。
开始之前
本主题假定您已在服务器上安装应用程序或模块,并且想要查看其部署描述符。
关于此任务
在组装工具中创建 Java™ 2 Platform, Enterprise Edition (J2EE) 应用程序或模块时,组装工具将为该应用程序或模块创建部署描述符文件。Java Platform Enterprise Edition (Java EE) 5 或更高版本应用程序和模块可能使用注释而不是部署描述符。
在服务器上安装应用程序或模块后,您可以在管理控制台中查看它的部署描述符。无法查看 Java EE 5 或更高版本注释。
除非应用程序支持 Java EE 5 或更高版本,否则企业归档 (EAR) 文件必须包含 application.xml 文件。application.xml 标识应用程序的每个模块。不需要 Java EE 5 应用程序即可在 EAR 文件中提供 application.xml 文件。如果 application.xml 文件不存在,那么产品会检查 Java 归档 (JAR) 文件内容以确定 JAR 文件是企业 Bean (EJB) 模块还是应用程序客户机模块。JAR 文件不应包含多个部署描述符。如果在 JAR 文件中找到 ejb-jar.xml 文件,那么产品会将其视为 EJB 模块。如果找不到 ejb-jar.xml 文件,但找到 application-client.xml,那么产品会将该 JAR 文件视为应用程序客户机模块。如果 JAR 文件中同时存在 ejb-jar.xml 和 application-client.xml 文件,那么产品会将应该是应用程序客户机模块的 JAR 文件视为 EJB 模块,或者将应该是 EJB 模块的 JAR 文件视为应用程序客户机模块。JAR 文件不应该包含多种部署描述符。
过程
结果
此时将显示应用程序或模块的部署描述符。
示例
产品 DefaultApplication 的部署描述符如下所示:
<application id="Application_ID" >
<display-name> DefaultApplication.ear</display-name>
<description> This is the IBM WebSphere Application Server Default Application.</<description>
<module id="WebModule_1" >
<web>
<web-uri> DefaultWebApplication.war</web-uri>
<context-root> /</context-root>
</web>
</module>
<module id="EjbModule_1" >
<ejb> Increment.jar</ejb>
</module>
<security-role id="SecurityRole_1204342979281" >
<description> All Authenticated users role.</description>
<role-name> All Role</role-name>
</security-role>
</application>
下一步做什么
在控制台页面中显示部署描述符之后,执行下列操作:
- 检查部署描述符内容,包括它包含的任何有关应用程序绑定、安全角色、对其他资源的引用或
Java 命名和目录接口 (JNDI) 名称的配置。
例如,检查 Java EE 5 或更高版本模块的 JAR 文件,以确保每个 JAR 文件均未包含多种部署描述符。如果 JAR 文件包含多种部署描述符,请转到下一步并移除额外的部署描述符。因此,如果 ejb-jar.xml 和 application-client.xml 文件都存在于 JAR 文件中,请移除模块不需要的部署描述符。
- 根据需要,更改部署描述符。
您可以手动编辑部署描述符文件。但是,更好的方法是使用控制台或组装工具部署描述符编辑器来编辑部署描述符,以确保部署描述符具有有效的属性并且它的引用包含适当的值。
如果 Java EE 5 或更高版本模块未将 metadata-complete 属性或 metadata-complete 属性设置为 false,那么您可以指示产品将整个模块部署描述符(包括注释中的部署信息)编写为 XML 格式。在“模块的元数据”页面中,选择 metadata-complete 属性。
