JNLP-Implementierungsdeskriptordatei der Clientanwendung

Die Implementierungsdeskriptordatei ist die Haupt-JNLP-Deskriptordatei (Java™ Network Launcher Protocol) für die Clientanwendung.

Standort

Die Clientanwendung besitzt eine Laufzeitabhängigkeit von Application Client, die Folgendes bereitstellt:
  • Java SE Runtime Environment von IBM®
  • Laufzeiteigenschaften für Application Client
  • SSL-Keystore- und -Truststore-Datei
  • JAR-Dateien für die Application Client-Laufzeitbibliotheken (optional für Thin-Application-Client-Anwendungen)
Wenn die Laufzeitabhängigkeit von Application Clients nicht erfüllt wird, wird sie heruntergeladen und in Java Web Start (JWS) installiert, wie in der JNLP-Deskriptordatei des Laufzeitinstallationsprogramms von Application Clients beschrieben. Beispiel:
<j2se version="1.6" href="http://your_server.com/jws/wasappclient/download.jnlp"/>

Verwendungshinweise

Die Clientanwendung muss auch die Datei WebSphereClientLauncher.jar mit der Startklasse com.ibm.websphere.client.launcher.ClientLauncher enthalten, die eine der folgenden Aktionen ausführt:
  • Wenn es sich um eineJava EE-Anwendungsclientanwendung ( Java Platform, Enterprise Edition ) handelt (d. h., die Ressourcen für die Anwendung enthalten eine EAR-Datei mit einer Clientanwendung), muss die EAR-Datei als JAR-Ressource angegeben werden, damit sie in JWS heruntergeladen und in der Systemeigenschaft com.ibm.websphere.client.launcher.earangegeben werden kann. Ein Beispiel finden Sie unter JNLP-Deskriptordatei für eine Java EE Anwendungsclientanwendung .
  • Wenn es sich um eine Thin-Application-Client-Anwendung handelt, muss die JAR-Datei der Thin-Application-Client-Anwendung als JAR-Ressource angegeben werden, sodass Sie in JWS heruntergeladen werden kann, und der der Name der klasse, die den Einstiegspunkt für die Methode "main" enthält, muss in der Systemeigenschaft com.ibm.websphere.launcher.main angegeben werden. Ein Beispiel finden Sie unter JNLP descriptor file for a Thin Application client application .

Die JNLP-Spezifikation erfordert, dass alle in einer JNLP-Datei verwendeten Ressourcendateien (JAR oder EAR) signiert sind.

Für eine J2EE-Application-Client-Anwendung können Sie die im Tool "launchClient" definierten "-CC"-Argumente im Abschnitt mit den Anwendungsargumenten der JNLP-Deskriptordateien angeben. Für eine Thin-Application-Client-Anwendung wird jedoch nur -CCD unterstützt, um Systemeigenschaften zu definieren, und der JNLP-Tag < property> kann auch verwendet werden, um Systemeigenschaften zu definieren. Details können Sie dem folgenden Beispiel entnehmen:
<property name="java.naming.provider.url" value="corbaloc:iiop:myserver.com:9089"/>
Geben Sie für eine J2EE-Application-Client-Anwendung die folgenden Anwendungsargumente wie in JNLP definiert an.
  1. Geben Sie den URL Ihres Zielserverproviders wie im folgenden Beispiel an:
    <argument> >-CCDjava.naming.provider.url =corbaloc:iiop:myserver.mydomain.com:9080 </argument>
  2. Geben Sie die Position der SSL-Schlüsseldatei und der SSL-Trust-Datei an. Es wird vorausgesetzt, dass diese Dateien auf der Clientmaschine verfügbar sind. Wenn Sie die Dateien verwenden möchten, die von Application Client für die Laufzeit bereitgestellt und im JWS-Cache installiert wurden, geben Sie die folgenden Anwendungsargumente an:
    <argument> -CCDcom.ibm.ssl.keyStore=${WAS_ROOT}/etc/key.p12 </argument>
<argument> -CCDcom.ibm.ssl.trustStore=${WAS_ROOT}/etc/trust.p12 </argument>
  3. Geben Sie die Factory für den Ausgangs-Naming-Kontext wie im folgenden Beispiel an:
    <argument>-CCDjava.naming.factory.initial=com.ibm.websphere.naming.WsnInitialContextFactory </argument>
    Für eine Thin-Application-Client-Anwendung müssen Sie außerdem die tatsächliche Position der Dateien sas.client.props und ssl.client.props angeben, die sich in der im JWS-Cache installierten Laufzeitabhängigkeit von Application Client befinden.
    <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>
    Falls eine der Standardeinstellungen in den Dateien sas.client.props und sas.client.props geändert werden muss, ändern Sie die Einstellung wie im folgenden Beispiel mit "–CCD" über die Systemeigenschaften:
    <argument>-CCDjavacom.ibm.CORBA.securityEnabled=false </argument>
    Wichtig: Das Token ${WAS_ROOT} , das in der JNLP-Datei verwendet wird, wird durch die Launcher-Klasse com.ibm.websphere.client.launcher.ClientLauncheran der tatsächlichen Position der Laufzeitabhängigkeitsinstallation von Application Clients im JWS-Cache ersetzt. Falls Sie diese JNLP-Beschreibungsdatei mit JSP dynamisch erstellen, müssen Sie dieses Token mit einem Escape-Zeichen versehen, da es in JSP 2.0 eine andere Bedeutung hat. Details können Sie dem folgenden Beispiel entnehmen:
    <argument>-CCDcom.ibm.ssl.keyStore=\${WAS_ROOT}/etc/key.p12 </argument>
<argument>-CCDcom.ibm.ssl.trustStore=\${WAS_ROOT}/etc/trust.p12 </argument>