客户机应用程序 Java 网络启动程序协议部署描述符文件

部署描述符文件是客户端应用程序的主要 Java™ 网络启动器协议 (JNLP) 描述符文件。

位置

客户机应用程序具有提供下列内容的应用程序客户机运行时依赖项:
  • Java SE 运行时环境IBM®
  • 应用程序客户机运行时属性
  • SSL 密钥库和信任库文件
  • 应用程序客户机运行时库 JAR 文件(对于瘦应用程序客户机应用程序,可选)
如果不满足应用程序客户端运行时依赖性,则会在 Java Web Start (JWS) 中下载并安装,如应用程序客户端运行时安装程序 JNLP 描述符文件所述。 例如:
<j2se version="1.6" href="http://your_server.com/jws/wasappclient/download.jnlp"/>

使用说明

客户机应用程序还必须包括 WebSphereClientLauncher.jar 文件,该文件包含完成下列其中一个操作的启动程序类 com.ibm.websphere.client.launcher.ClientLauncher:
  • 如果它是一个Java Platform, Enterprise Edition( Java EE )应用程序客户端应用程序(即应用程序的资源包含带有客户端应用程序的 EAR 文件),必须将 EAR 文件指定为 JAR 资源,以便可以将其下载到 JWS 并在系统属性中指定,com.ibm.websphere.client.launcher.ear 。 看JNLP 描述文件Java EE应用程序客户端应用程序举个例子。
  • 如果它是瘦应用程序客户机应用程序,那么必须指定瘦应用程序客户机应用程序的 JAR 文件作为 JAR 资源,这样才能将其下载到 JWS,并在系统属性 com.ibm.websphere.launcher.main 中指定包含主要方法入口点的类名称。 看瘦应用程序客户端应用程序的 JNLP 描述符文件举个例子。

JNLP 规范要求签署在 JNLP 文件中使用的所有资源(JAR 或 EAR)文件。

您可以指定在launchClient工具J2EE JNLP 描述符文件的应用程序参数部分中的应用程序客户端应用程序。 但是,只有 -CCD 才支持 Thin Application 客户端应用程序定义系统属性,并且 JNLP <property> 标记也可用于定义系统属性。 请参阅以下示例以了解详细信息:
<property name="java.naming.provider.url" value="corbaloc:iiop:myserver.com:9089"/>
像在 JNLP 中定义的那样,为 J2EE 应用程序客户机应用程序指定下列应用程序参数。
  1. 如以下示例所示,指定您的目标服务器提供程序 URL:
    <argument> >-CCDjava.naming.provider.url =corbaloc:iiop:myserver.mydomain.com:9080 </argument>
    
  2. 指定 SSL 密钥文件和 SSL 信任文件的位置。 可以在客户端机器中获得这些文件。 要使用应用程序客户机运行时从属项(安装在 JWS 高速缓存中)中的文件,指定以下这些应用程序参数:
    <argument> -CCDcom.ibm.ssl.keyStore=${WAS_ROOT}/etc/key.p12 </argument>
    <argument> -CCDcom.ibm.ssl.trustStore=${WAS_ROOT}/etc/trust.p12 </argument>
    
  3. 如以下示例所示,指定初始命名上下文因子:
    <argument>-CCDjava.naming.factory.initial=com.ibm.websphere.naming.WsnInitialContextFactory </argument>
    
    对于瘦应用程序客户机应用程序,还需要指定 sas.client.propsssl.client.props 文件的实际位置,它们位于安装在 JWS 高速缓存中的应用程序客户机运行时依赖项中。
    <argument>-CCDcom.ibm.CORBA.ConfigURL=file:${WAS_ROOT}/properties/sas.client.props </argument>
    <argument>-CCDcom.ibm.SSL.ConfigURL=file:${WAS_ROOT}/properties/ssl.client.props </argument>
    
    如果任何默认设置sas.client.propssas.client.props文件需要修改,使用-CCD 通过系统属性更改设置,如下例所示:
    <argument>-CCDjavacom.ibm.CORBA.securityEnabled=false </argument>
    
    重要的:美元{WAS_ROOT} JNLP 文件中使用的 token 被启动器类替换, com.ibm.websphere.client.launcher.ClientLauncher,应用程序客户端运行时依赖项在 JWS 缓存中的实际安装位置。 如果您要使用 JSP 动态地创建此 JNLP 描述文件,那么您必须避开此令牌,因为它在 JSP 2.0 中有另外的含义。 请参阅以下示例以了解详细信息:
    <argument>-CCDcom.ibm.ssl.keyStore=\${WAS_ROOT}/etc/key.p12 </argument>
    <argument>-CCDcom.ibm.ssl.trustStore=\${WAS_ROOT}/etc/trust.p12 </argument>