Préparation du composant de dépendance d'exécution des clients d'application pour Java Web Start

Pour qu'une application de client d'application Java™ EE (Java Platform, Enterprise Edition) ou une application de client partiel soit lancée à l'aide de JWS (Java Web Start), un fichier JAR (archive Java) d'implémentation de l'environnement JRE Java Runtime Environment) fourni par IBM® ainsi que les fichiers JAR de la bibliothèque et les fichiers de propriétés regroupés dans Application Client for WebSphere Application Server doivent être installés dans JWS. Suivez la procédure permettant de créer le composant de dépendance d'exécution des clients d'application à partir d'une installation de client d'application. Il est livré sous forme de fichier WAR (archive d'application Web) qui peut être installé sur un serveur d'applications.

Avant de commencer

Installez Application Client for WebSphere Application Server pour le système d'exploitation sur lequel vous prévoyez de déployer l'application client. Si l'application client doit être déployée sur plusieurs systèmes d'exploitation, le composant de dépendance d'exécution des clients d'application doit être créé de manière distincte pour chaque système d'exploitation pris en charge par l'application client.

[Windows][Linux]Par exemple, si l'application client est déployée sur Windows et Linux, suivez les étapes de cette tâche pour créer le composant de dépendance d'exécution des clients d'application pour les systèmes d'exploitation Windows sur lesquels Application Client for WebSphere Application Server for Windows est installé. Répétez ensuite les étapes de cette tâche pour créer le composant de dépendance d'exécution des clients d'application pour Linux, sur un système d'exploitation Linux sur lequel Application Client for WebSphere Application Server for Linux est installé.

Procédure

  1. Installez Application Client for WebSphere Application Server pour les systèmes d'exploitation pris en charge par l'application client.

    [Windows]Installez le client d'application dans le répertoire C:\Program Files\IBM\WebSphere\AppClient.

  2. Accédez au répertoire bin de l'installation.
    [Windows]Sur les systèmes d'exploitation Windows, le répertoire est le suivant :
    CD C:\Program files\IBM\WebSphere\AppClient\bin
  3. Exécutez l'outil Outil buildClientRuntime pour générer le fichier JAR d'exécution des clients d'exécution contenant l'environnement Java Standard Edition Runtime Environment, les fichiers JAR de la bibliothèque d'exécution, les fichiers de propriétés, ainsi que les fichiers SSL KeyStore et TrustStore provenant de l'installation du client d'application.
    [Windows]Par exemple, si vous utilisez la version 7.0 et le certificat de test inclus dans l'installation du client d'application :
    buildClientRuntime C:\WebApp1\runtime\WASClient7.0_windows.jar ..\etc\DummyClientKeyFilejar WebAS 
    "websphere dummy client" JKS
  4. Exécutez les outils buildClientLibJars pour intégrer les fichiers de propriétés du répertoire de propriétés de l'installation du client d'application dans le fichier properties.jar, à l'emplacement spécifié. Les outils buildClientLibJars copient également les fichiers WebSphereClientLauncher.jar et WebSphereClientRuntimeInstaller.jar à partir de l'installation du client d'application vers l'emplacement spécifié. Tous les fichiers JAR situés à l'emplacement indiqué sont signés par le certificat fourni.
    Par exemple, si vous utilisez la version 7.0 et le certificat de test inclus dans l'installation du client d'application :
    buildClientLibJars C:\Temp\webstart ..\etc\DummyClientKeyFilejar WebAS "websphere dummy client" JKS
  5. Créez un fichier JSP (JavaServer Pages) ou utilisez un servlet pour générer le descripteur JNLP (Java Network Launching Protocol) du programmation d'installation d'exécution du client d'application pour répondre à la requête Java Web Start. Voir l'exemple de déploiement Java Web Start inclus dans l'installation du client d'application.
  6. Intégrez dans un fichier WAR (archive Web) les deux fichiers JAR WASClient7.0_windows.jar et WebSphereClientRuntimeInstaller.jar signés, ainsi que le fichier JSP ou le servlet utilisé pour générer le descripteur JNLP du programmation d'installation d'exécution du client d'application. Ce fichier WAR est intégré dans un fichier EAR qui peut être déployé sur un serveur d'applications. Voir l'exemple de déploiement Java Web Start inclus dans l'installation du client d'application.

Résultats

Votre application Web est prête à servir l'environnement d'exécution du client d'application et l'environnement JRE.

Exemple

<!-- Cet exemple de programme s'applique à WebSphere Application Server, Version 6.1.
Il est fourni EN L'ETAT et peut être utilisé, exécuté, copié et modifié 
par le client (a) dans le cadre de son instruction personnelle et de sujets d'étude, (b) 
pour développer des applications conçues pour s'exécuter avec un produit IBM WebSphere 
ou pour être redistribué dans les propres produits du client, dans le cadre de ces applications 
.

Product 5630-A36,  (C) COPYRIGHT International Business Machines Corp., 2005
Tous droits réservés * Eléments sous licence - Propriété d'IBM
-->

<%-- // pour définir l'en-tête Last_Modified afin que le client JNLP sache s'il doit télécharger
     // à nouveau le fichier JNLP et mettre à jour la copie mise en cache.
     String jspPath = application.getRealPath(request.getServletPath());
     java.io.File jspFile = new java.io.File(jspPath);
     long lastModified = jspFile.lastModified();
%><%    
      // variables déclarées localement
      String url=request.getRequestURL().toString(); 
      String jnlpCodeBase=url.substring(0,url.lastIndexOf('/'));
      String jnlpRefURL=url.substring(url.lastIndexOf('/')+1,url.length());

      // Doit définir un typemime JNLP - si WebStart est installé sur le client,
      // cet en-tête indique au navigateur de conduire le client de WebStart
      response.setContentType("application/x-java-jnlp-file");                            1
      response.setHeader("Cache-Control", null);
      response.setHeader("Set-Cookie", null);
      response.setHeader("Vary", null);
      response.setDateHeader("Last-Modified", lastModified);

      // Un programme d'installation doit répondre par le numéro de version pour une installation donnée
      if (response.containsHeader("x-java-jnlp-version-id"))
        response.setHeader("x-java-jnlp-version-id", "WASClient6.1.0");               2
      else
        response.addHeader("x-java-jnlp-version-id", "WASClient6.1.0");
%>
     
<?xml version="1.0" encoding="utf-8"?>

<!-- ============================================================== -->
<!-- A faire : remplacer "codebase" par l'emplacement de l'url réelle de ce jsp -->
<!-- ============================================================== -->

<jnlp spec="1.0+" 
codebase="http://VOTRE_SERVEUR_APP:NUMEROPORT/RACINE_CONTEXTE_APPWEB/Runtime/WebSphereJre">

<information>
  <title>Environnement d'exécution Java du client d'application</title>
  <vendor>IBM</vendor>
  <icon href="icon.gif"/>
  <description>Environnement d'exécution Java du client d'application</description>
  <description kind="short">Application Client JRE</description>
  <description kind="tooltip">Application Client JRE</description>
  <offline-allowed/>
</information>

<security>
	<all-permissions/>
</security>

	<resources>
		<j2se version="1.4+"/><%-- Le programme d'installation peut utiliser n'importe quel JRE 1.4 --%> 3
 		<jar href="WebSphereClientRuntimeInstaller.jar" main="true"/>	4		

		<!-- Enregistrement de la version de JRE à l'aide de Web Start -->
		<property name="com.ibm.websphere.client.jre.version" value="WASClient6.1.0"/>	5	
	</resources>

	<resources os="Windows">	6	
<!-- ============================================================== -->
<!-- A faire : la valeur de la propriété pour la plateforme UNIX est "java/jre/bin/javaw" -->
<!--   et la valeur "os" correspond à la plateforme de la machine client cible            -->
<!-- ============================================================== -->

			<jar href="WASClient6.1.0_Windows.jar"/>	7	
	
<!-- ============================================================== -->
<!-- A faire :  la valeur de la propriété pour la plateforme UNIX est "java/jre/bin/javaw" -->
<!-- ============================================================== -->
<!-- chemin d'accès relatif à l'exécutable jre —->

			<property name="com.ibm.websphere.client.jre.launch.java" 
	value="java\jre\bin\javaw.exe"/>	8	
	
	</resources>
	<installer-desc main-class="com.ibm.websphere.client.installer.ClientRuntimeInstaller"/>
</jnlp>
  1. Indique que le fichier est de type mime JNLP pour que le navigateur puisse traiter le fichier JNLP.
  2. Indique la version exacte de ce composant de dépendance d'exécution des clients d'application dans la réponse en définissant la zone de l'en-tête HTTP : x-java-jnlp-version-id.
  3. Spécifie la version JRE requise pour exécuter le programme d'installation.
  4. Spécifie le fichier WebSphereClientRuntimeInstaller.jar du programme d'installation, qui contient la classe ClientRuntimeInstaller.
  5. Indique une propriété système qui définit la version du composant de dépendance d'exécution des clients d'application. Cette version est enregistrée sur le client JNLP.
  6. Spécifie les ressources d'une plateforme spécifique. Chaque plateforme d'application client prise en charge requiert son propre fichier JAR distinct.
  7. Indique le fichier JAR du composant de dépendance d'exécution des clients d'application.
  8. Spécifie le programme à appeler qui démarre une machine JVM pour l'application client.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tcli_jrerun
Nom du fichier : tcli_jrerun.html