Preparación del componente de dependencia del módulo ejecutable del Cliente de aplicaciones para Java Web Start

Para lanzar una aplicación de cliente de aplicaciones Java™ Platform, Enterprise Edition (Java EE), una aplicación de cliente de aplicaciones ligero o ambos, utilizando Java Web Start (JWS), en el JWS debe estar instalado un JAR (Java Archive) de implementación de Java Runtime Environment que proporciona IBM®, los archivos JAR de biblioteca y los archivos de propiedades que se empaquetan en Application Client para WebSphere Application Server. Conozca los pasos para construir el componente de dependencia de tiempo de ejecución del cliente de aplicaciones de una instalación de cliente de aplicaciones. Se empaqueta como un archivo WAR (web application archive) que se puede instalar en un servidor de aplicaciones.

Antes de empezar

Instale Application Client para WebSphere Application Server para el sistema operativo en el que se desplieguen las aplicaciones cliente. Si existe un requisito para desplegar la aplicación cliente en varios sistemas operativos, el componente de dependencia de módulo ejecutable del cliente de aplicaciones debe crearse por separado para cada sistema operativo al que dé soporte la aplicación cliente.

[Windows][Linux]Por ejemplo, si la aplicación cliente se despliega tanto en el sistema operativo Windows como el sistema operativo Linux, realice los siguientes pasos para esta tarea con el fin de construir el componente de dependencia de tiempo de ejecución del cliente de aplicaciones para sistemas operativos Windows, con el cliente de aplicaciones para WebSphere Application Server para Windows instalado. A continuación, repita los pasos de esta tarea para construir el componente de dependencia de tiempo de ejecución del cliente de aplicaciones para Linux, en un sistema operativo Linux, con Application Client para WebSphere Application Server para Linux instalado.

Procedimiento

  1. Instale el Cliente de aplicaciones de WebSphere Application Server para los sistemas operativos soportados de la aplicación cliente.

    [Windows]Instale el cliente de aplicaciones en el directorio C:\Archivos de programa\IBM\WebSphere\AppClient.

  2. Vaya al directorio bin de la instalación.
    [Windows]En los sistemas operativos Windows, el directorio es el siguiente:
    CD C:\Archivos de programa\IBM\WebSphere\AppClient\bin
  3. Ejecute la Herramienta buildClientRuntime para generar el archivo JAR del módulo ejecutable del cliente de aplicaciones en un directorio temporal que contenga las propiedades de tiempo de ejecución de Java Standard Edition Runtime Environment, los archivos JAR de biblioteca de tiempo de ejecución y los archivos KeyStore y TrustStore de SSL de la instalación del cliente de aplicaciones.
    [Windows]Por ejemplo, si utiliza la Versión 7.0 y utiliza el certificado de pruebas que se incluye en la instalación del cliente de aplicaciones:
    buildClientRuntime C:\WebApp1\runtime\WASClient7.0_windows.jar ..\etc\DummyClientKeyFilejar WebAS 
    "websphere dummy client" JKS
  4. Ejecute las herramientas buildClientLibJars para empaquetar los archivos de propiedades en el directorio de propiedades de la instalación del cliente de aplicaciones en un archivo properties.jar en la ubicación especificada. Las herramientas buildClientLibJars también copiarán el archivo WebSphereClientLauncher.jar y el archivo WebSphereClientRuntimeInstaller.jar de la instalación del cliente de aplicaciones en la ubicación especificada. Todos los archivos jar de la ubicación especificada se firmarán mediante el certificado del proveedor.
    Por ejemplo, si utiliza la Versión 7.0 y utiliza el certificado de pruebas que se incluye en la instalación del cliente de aplicaciones:
    buildClientLibJars C:\Temp\webstart ..\etc\DummyClientKeyFilejar WebAS "websphere dummy client" JKS
  5. Cree un archivo JSP (JavaServer Pages) o utilice un servlet para generar el descriptor JNLP (Java Network Launching Protocol) del instalador del tiempo de ejecución del cliente de aplicaciones para responder a la solicitud de Java Web Start. Consulte el ejemplo de despliegue de Java Web Start en la instalación del cliente de aplicaciones.
  6. Empaquete los dos archivos JAR firmados, WASClient7.0_windows.jar y WebSphereClientRuntimeInstaller.jar, y el archivo JSP o servlet para la generación del descriptor JNLP del instalador del tiempo de ejecución del cliente de aplicaciones en un archivo WAR (web Archive). Este archivo WAR se empaqueta en un archivo EAR que se puede desplegar en un servidor de aplicaciones. Consulte el ejemplo de despliegue de Java Web Start en la instalación del cliente de aplicaciones.

Resultados

La aplicación web está lista para servir módulo ejecutable del cliente de aplicaciones y el entorno JRE.

Ejemplo

<Este programa de ejemplo se aplica a WebSphere Application Server, Versión 6.1.
Este programa se proporciona TAL CUAL y se puede utilizar, ejecutar, copiar y modificar 
sin que el cliente tenga que pagar derechos (a) para su propia formación 
y estudio para desarrollar aplicaciones diseñadas para ejecutarlas con productos de IBM WebSphere, ya sea para el uso interno propio del cliente 
o para redistribución por parte del cliente, como parte de dicha aplicación, en productos 
propios del cliente.

Product 5630-A36,  (C) COPYRIGHT International Business Machines Corp., 2005
Todos los derechos reservados * Material bajo licencia - Propiedad de IBM
-->

<%-- // establecer la cabecera Last_Modified para que el cliente JNLP sepa si ha de descargar
     // otra vez el archivo JNLP y actualizar la copia en antememoria.
     String jspPath = application.getRealPath(request.getServletPath());
     java.io.File jspFile = new java.io.File(jspPath);
     long lastModified = jspFile.lastModified();
%><%    
      // variables declaradas localmente
      String url=request.getRequestURL().toString(); 
      String jnlpCodeBase=url.substring(0,url.lastIndexOf('/'));
      String jnlpRefURL=url.substring(url.lastIndexOf('/')+1,url.length());

      // Se debe establecer un tipo mime JNLP, si se ha instalado WebStart en el cliente,
      // esta cabecera hará que el navegador dirija el cliente 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 instalador debe contestar con el número de versión de una instalación dada
      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"?>

<!-- ============================================================== -->
<!-- TODO: cambie "codebase" por la ubicación real del url de este jsp -->
<!-- ============================================================== -->

<jnlp spec="1.0+" 
codebase="http://YOUR_APP_SERVER:PORTNUMBER/WEBAPP_CONTEXT_ROOT/Runtime/WebSphereJre">

<information>
  <title>Application Client Java Runtime Environment</title>
  <vendor>IBM</vendor>
  <icon href="icon.gif"/>
  <description>Application Client Java Runtime Environment</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+"/><%-- The installer can use any 1.4 JRE --%> 3
 		<jar href="WebSphereClientRuntimeInstaller.jar" main="true"/>	4		

				<!-- Registro de la versión JRE con Web Start -->
		<property name="com.ibm.websphere.client.jre.version" value="WASClient6.1.0"/>	5	
	</resources>

	<resources os="Windows">	6	
<!-- ============================================================== -->
<!-- TODO: el valor de propiedad para la plataforma UNIX es "java/jre/bin/javaw" -->
<!--   y el valor "os" debe coincidir con la plataforma de la máquina cliente de destino -->
<!-- ============================================================== -->

			<jar href="WASClient6.1.0_Windows.jar"/>	7	
	
<!-- ============================================================== -->
<!-- TODO: el valor de propiedad para la plataforma UNIX es "java/jre/bin/javaw" -->
<!-- ============================================================== -->
<!-- vía de acceso relativa del ejecutable 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. Especifica que el archivo es un tipo mime JNLP de modo que el navegador puede procesar el archivo JNLP.
  2. Especifica la versión exacta de este componente de dependencia del módulo ejecutable de cliente de aplicaciones en la respuesta estableciendo el campo de cabecera HTTP: x-java-jnlp-version-id.
  3. Especifica la versión de JRE obligatoria para ejecutar el programa de instalación.
  4. Especifica el archivo WebSphereClientRuntimeInstaller.jar del programa de instalación, que contiene la clase ClientRuntimeInstaller.
  5. Especifica una propiedad del sistema que define la versión del componente de dependencia del módulo ejecutable del cliente de aplicaciones. Esta versión está registrada en el cliente JNLP.
  6. Especifica recursos de una plataforma determinada. Cada plataforma de aplicación cliente soportada necesita su propio archivo JAR independiente.
  7. Especifica el archivo JAR del componente de dependencia del módulo ejecutable del cliente de aplicaciones.
  8. Especifica el programa que se va a llamar para que inicie una JVM para la aplicación cliente.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tcli_jrerun
File name: tcli_jrerun.html