Fichier du descripteur de déploiement JNLP (Java Network Launcher Protocol) de l'application client

Le fichier de descripteur de déploiement est le principal fichier de descripteur JNLP (Java™ Network Launcher Protocol) de l'application client.

Emplacement

L'application client a une dépendance d'environnement d'exécution des clients d'application qui fournit les éléments suivants :

Environnement d'exécution Java SE à partir d' IBM®
Propriétés d'environnement d'exécution des clients d'application
Fichier SSL KeyStore and TrustStore
Fichiers JAR de bibliothèque d'environnement d'exécution des clients d'application (facultatif pour les applications des clients d'application partiels)

Si la dépendance d'exécution des clients d'application n'est pas détectée, elle est téléchargée et installée dans JWS (Java Web Start), comme décrit par le fichier du descripteur JNLP du programme d'installation de l'environnement d'exécution des clients d'application. Par exemple :

<j2se version="1.6" href="http://your_server.com/jws/wasappclient/download.jnlp"/>

Remarques relatives à l'utilisation

L'application client doit aussi inclure le fichier WebSphereClientLauncher.jar, qui contient la classe du programme de lancement com.ibm.websphere.client.launcher.ClientLauncher, qui effectue l'une des actions suivantes :

S'il s'agit d'une application client d'application Java Platform, Enterprise Edition (Java EE) (c'est-à-dire que les ressources de l'application contiennent un fichier EAR avec une application client), le fichier EAR doit être spécifié en tant que ressource JAR pour pouvoir être téléchargé sur JWS et spécifié dans la propriété système com.ibm.websphere.client.launcher.ear. Pour un exemple, voir Fichier de descripteur JNLP d'une application client d'application Java EE .
S'il s'agit d'une application client d'application simple, le fichier JAR de l'application client d'application simple doit être spécifié en tant que ressource JAR pour pouvoir être téléchargé dans JWS et le nom de la classe contenant le point d'entrée de la méthode principale est spécifié dans la propriété système com.ibm.websphere.launcher.main. Pour obtenir un exemple, voir Fichier de descripteur JNLP d'une application client d'application simple .

La spécification JNLP requiert tous les fichiers de ressource (JAR ou EAR) utilisés dans un fichier JNLP à signer.

Vous pouvez spécifier les arguments –CC définis dans l'outil launchClient d'une application de client d'application J2EE dans la section relative aux arguments de l'application des fichiers de descripteur JNLP. Toutefois, seule l'option -CCD est prise en charge pour une application client d'application partiel afin de définir les propriétés système et la balise JNLP < propriété> peut également être utilisée pour définir les propriétés système. Pour plus de détails, voir l'exemple suivant :

<property name="java.naming.provider.url" value="corbaloc:iiop:myserver.com:9089"/>

Pour une application de client d'application J2EE, spécifiez les arguments d'application suivants, comme défini dans le JNLP.

Spécifiez l'URL du fournisseur de votre serveur cible, comme indiqué dans l'exemple suivant :

<argument> >-CCDjava.naming.provider.url =corbaloc:iiop:myserver.mydomain.com:9080 </argument>

Spécifiez l'emplacement du fichier de clés SSL et du fichier des tiers dignes de confiance SSL. Ces fichiers doivent être disponibles sur la machine client. Pour utiliser ceux de la dépendance d'exécution des clients d'application installés dans le cache JWS, spécifiez les arguments d'application suivants :
```
<argument> -CCDcom.ibm.ssl.keyStore=${WAS_ROOT}/etc/key.p12 </argument>
<argument> -CCDcom.ibm.ssl.trustStore=${WAS_ROOT}/etc/trust.p12 </argument>
```
Spécifiez le facteur initial du contexte de nommage, comme indiqué dans l'exemple suivant :
```
<argument>-CCDjava.naming.factory.initial=com.ibm.websphere.naming.WsnInitialContextFactory </argument>
```
Pour une application de clients d'application partiels, vous devez également spécifier l'emplacement des fichiers sas.client.props et ssl.client.props situés dans la dépendance d'exécution des clients d'application installée dans le cache 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>
```
Si des paramètres par défaut contenus dans le fichier sas.client.props et sas.client.props nécessitent des modifications, utilisez –CCD pour effectuer ces modifications via les propriétés système, comme indiqué dans l'exemple ci-dessous :
```
<argument>-CCDjavacom.ibm.CORBA.securityEnabled=false </argument>
```
Important: Le jeton ${WAS_ROOT} utilisé dans le fichier JNLP est remplacé par la classe du lanceur, com.ibm.websphere.client.launcher.ClientLauncher, à l'emplacement réel de l'installation de la dépendance d'exécution des clients d'application dans le cache JWS. Si vous utilisez JSP pour créer de manière dynamique ce fichier de description JNLP, vous devez précéder ce symbole d'un caractère d'échappement car sa signification est différente dans JSP 2.0. Pour plus de détails, voir l'exemple suivant :
```
<argument>-CCDcom.ibm.ssl.keyStore=\${WAS_ROOT}/etc/key.p12 </argument>
<argument>-CCDcom.ibm.ssl.trustStore=\${WAS_ROOT}/etc/trust.p12 </argument>
```