查看部署描述符

部署描述符是可扩展标记语言 (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.xmlapplication-client.xml 文件,那么产品会将应该是应用程序客户机模块的 JAR 文件视为 EJB 模块,或者将应该是 EJB 模块的 JAR 文件视为应用程序客户机模块。JAR 文件不应该包含多种部署描述符。

过程

  1. 访问部署描述符视图。

    单击访问控制台视图中说明的导航选项以查看给定模块的部署描述符:

    表 1. 在控制台中访问“查看部署描述符”页面. 单击控制台导航树和页面中的链接。
    模块 部署描述符文件 访问控制台视图
    企业应用程序 application.xml 应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 查看部署描述符
    Web 应用程序 WEB-INF/web.xml 应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 管理模块 > module_name > 查看部署描述符
    WEB-INF/portlet.xml 应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 管理模块 > module_name > 查看 portlet 部署描述符
    企业 Bean ejb-jar.xml 应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 管理模块 > module_name > 查看部署描述符
    应用程序客户机 application-client.xml 应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 管理模块 > module_name > 查看部署描述符
    Web Service webservices.xml 应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 管理模块 > module_name >
    • 查看 Web Service 客户机部署描述符扩展
    • 查看 Web Service 服务器部署描述符
    • 查看 Web Service 服务器部署描述符扩展
    有关视图的信息,请参阅“在管理控制台中查看 Web Service 部署描述符”主题。
    嵌入在企业应用程序中的资源适配器 ra.xml 应用程序 > 应用程序类型 > WebSphere 企业应用程序 > application_name > 管理模块 > ra_module_name > 查看部署描述符
    独立资源适配器 ra.xml 资源 > 资源适配器 > 资源适配器 > module_name > 查看部署描述符
  2. 单击全部展开以查看部署描述符内容。

结果

此时将显示应用程序或模块的部署描述符。

示例

产品 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>

下一步做什么

在控制台页面中显示部署描述符之后,执行下列操作:

  1. 检查部署描述符内容,包括它包含的任何有关应用程序绑定、安全角色、对其他资源的引用或 Java 命名和目录接口 (JNDI) 名称的配置。

    例如,检查 Java EE 5 或更高版本模块的 JAR 文件,以确保每个 JAR 文件均未包含多种部署描述符。如果 JAR 文件包含多种部署描述符,请转到下一步并移除额外的部署描述符。因此,如果 ejb-jar.xmlapplication-client.xml 文件都存在于 JAR 文件中,请移除模块不需要的部署描述符。

  2. 根据需要,更改部署描述符。

    您可以手动编辑部署描述符文件。但是,更好的方法是使用控制台或组装工具部署描述符编辑器来编辑部署描述符,以确保部署描述符具有有效的属性并且它的引用包含适当的值。

如果 Java EE 5 或更高版本模块未将 metadata-complete 属性或 metadata-complete 属性设置为 false,那么您可以指示产品将整个模块部署描述符(包括注释中的部署信息)编写为 XML 格式。在“模块的元数据”页面中,选择 metadata-complete 属性

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

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_deploymtdesc
文件名:trun_app_deploymtdesc.html