客户机应用程序 Java 网络启动程序协议部署描述符文件
部署描述符文件是客户机应用程序的主要 Java™ 网络启动程序协议 (JNLP) 描述符文件。
位置
客户机应用程序具有提供下列内容的应用程序客户机运行时依赖项:- 来自 IBM® 的 Java SE 运行时环境
- 应用程序客户机运行时属性
- SSL 密钥库和信任库文件
- 应用程序客户机运行时库 JAR 文件(对于瘦应用程序客户机应用程序,可选)
<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 中进行指定。请参阅Java EE 应用程序客户机应用程序的 JNLP 描述符文件,以获取示例。
- 如果它是瘦应用程序客户机应用程序,那么必须指定瘦应用程序客户机应用程序的 JAR 文件作为 JAR 资源,这样才能将其下载到 JWS,并在系统属性 com.ibm.websphere.launcher.main 中指定包含主要方法入口点的类名称。 请参阅瘦应用程序客户机应用程序的 JNLP 描述符文件,以获取示例。
JNLP 规范要求签署在 JNLP 文件中使用的所有资源(JAR 或 EAR)文件。
可以在 JNLP 描述符文件的应用程序参数部分为 J2EE 应用程序客户机应用程序指定在 launchClient 工具中定义的 –CC 参数。但是,瘦应用程序客户机应用程序仅支持 –CCD 来定义系统属性,并且还可以使用 JNLP <property> 标记来定义系统属性。请参阅以下示例以了解详细信息:
<property name="java.naming.provider.url" value="corbaloc:iiop:myserver.com:9089"/>
像在 JNLP 中定义的那样,为 J2EE 应用程序客户机应用程序指定下列应用程序参数。
- 如以下示例所示,指定您的目标服务器提供程序 URL:
<argument> >-CCDjava.naming.provider.url =corbaloc:iiop:myserver.mydomain.com:9080 </argument>
- 指定 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>
- 如以下示例所示,指定初始命名上下文因子:
<argument>-CCDjava.naming.factory.initial=com.ibm.websphere.naming.WsnInitialContextFactory </argument>
对于瘦应用程序客户机应用程序,还需要指定 sas.client.props 和 ssl.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.props 和 sas.client.props 文件中的任何缺省设置需要修改,那么请使用 –CCD 通过系统属性来更改设置,如以下示例所示:<argument>-CCDjavacom.ibm.CORBA.securityEnabled=false </argument>
要点: 启动程序类 com.ibm.websphere.client.launcher.ClientLauncher 将在 JNLP 文件中使用的 ${WAS_ROOT} 令牌替换为 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>