Creación de los ejemplos de servicios Web de JAX-WS con la herramienta de creación Ant


Portabilidad de J2EE
Volver a crear los ejemplos de servicios Web de JAX-WS
Cómo empezar
Identificar la estructura de directorios de los ejemplos creados
Cómo volver a crear e instalar el archivo JaxWSServicesSamples.ear

Portabilidad de J2EE

Una de las grandes ventajas del desarrollo de aplicaciones en una plataforma J2EE es la portabilidad.  Todos los programas de ejemplo de la galería de ejemplos se desarrollan en una estación de trabajo y se ejecutan en los sistemas z/OS sin que cambie una línea del código Java.  Al crear aplicaciones J2EE en Intel o en sistemas operativos como AIX o Linux, el desarrollador puede eliminar los retos de EBCDIC en ASCII o las conversiones de archivos de ASCII en EBCDIC.   La disponibilidad de las herramientas facilita a los desarrolladores la escritura y las pruebas en una estación de trabajo de desarrollo, así como la instalación de los archivos EAR (Enterprise Archive) en los sistemas z/OS.

Volver a crear los ejemplos de JAX-WS

Todos los clientes de WebSphere Application Server para z/OS tienen derecho al soporte de Application Server para multiplataformas. Si instala el producto WebSphere Application Server base y los ejemplos en una de las plataformas soportadas por este paquete, galería que verá será la misma. No obstante, hay una diferencia. Al pulsar nombre_ejemplo > Créelo con Ant > plataforma > Volver a crear e instalar el archivo, las instrucciones para volver a crear el archivo EAR son específicas para esta plataforma.   Como los archivos de texto en un archivo EAR como archivos XML, xmi, JSP (JavaServer Pages) deben estar en formato ASCII, es más fácil editar esos archivos en una máquina ASCII.   Si realiza cambios en una máquina ASCII, a continuación, puede reinstalar el archivo EAR resultante en la plataforma z/OS sin una conversión de EBCDIC a ASCII. 

Cómo empezar

Instale WebSphere Application Server en la plataforma distribuida que prefiera e indique que desea instalar las aplicaciones de ejemplo. En el panel Instalar aplicaciones de ejemplo, seleccione Instalar las aplicaciones de ejemplos.

Realice una copia de seguridad del directorio <raíz_perfil>/samples/src/JaxWSServicesSamples antes de intentar modificar o volver a generar los ejemplos.

Identificar la estructura de directorios de los ejemplos creados

Los ejemplos están instalados en los siguientes directorios:

<raíz_perfil>/samples/src/JaxWSServicesSamples Contiene el código de origen de ejemplo para los ejemplos Ping, Echo y MTOM.
<raíz_perfil>/samples/lib/JaxWSServicesSamples Contiene los archivos archivadores Web (WAR), los archivos archivadores Java (JAR) y el archivo JaxWSServicesSamples.ear final de los ejemplos. Este directorio se crea después de volver a crear este ejemplo.
<raíz_perfil>/samples/javadoc/JaxWSServicesSamples Contiene la documentación Javadoc de los ejemplos. Este directorio se crea después de volver a crear este ejemplo.
<raíz_perfil>/samples/bld/JaxWSServicesSamples Contiene los archivos de clase generados. Estos archivos de clases se utilizan para generar el archivo JaxWSServicesSamples.ear final. Este directorio se crea después de volver a crear este ejemplo.

Cómo volver a crear e instalar el archivo JaxWSServicesSamples.ear

El archivo EAR (Enterprise Archive) de ejemplos de servicios Web de JAX-WS se proporciona cuando se instala WebSphere Application Server. No es necesario que cree los ejemplos antes de utilizarlos. Las instrucciones que se proporcionan a continuación describen los pasos para volver a crear los ejemplos, junto con información adicional para modificarlos.

Ejecutar el script de creación de los ejemplos

Transferir el archivoJaxWSServicesSamples.ear que se ha vuelto a crear
Eliminar y volver a instalar el archivo JaxWSServicesSamples.ear

Ejecutar el script de creación de los ejemplos

Para volver a crear el archivo EAR de ejemplos de servicios Web de JAX-WS, efectúe los siguientes pasos:

  1. Verifique que <raíz_perfil>/bin está en la variable de entorno PATH.
  2. Vaya al directorio <raíz_perfil>/samples/src/JaxWSServicesSamples.
  3. Ejecute el script de creación de ejemplos.
    • En las plataformas Windows, escriba buildJaxWSSamples en la línea de mandatos.
    • En las plataformas como AIX o Linux, escriba buildJaxWSSamples.sh en la línea de mandatos.

Ya se ha creado el ejemplo.

Los scripts buildJaxWSSamples se encuentran en el directorio <raíz_perfil>/bin. Los scripts establecen la información de vía de acceso de clases adecuada y ejecutan el programa de utilidad de creación Ant. El programa de utilidad Ant lee los archivos build.xml, que describen cómo se crean los ejemplos. Consulte el sitio Web de Apache Ant para obtener documentación adicional sobre el programa de utilidad Ant.

Información importanteDurante el proceso de creación, sólo se vuelven a crear los archivos de clases que tengan cambios. Los demás archivos de clase se vuelven a empaquetar en el nuevo archivo EAR.

Transferir el archivoJaxWSServicesSamples.ear que se ha vuelto a crear

Utilice FTP (File Transfer Protocol) para transferir el archivo EAR binario al servidor z/OS utilizando las siguientes instrucciones.

  1. Localice el archivo EAR que se ha vuelto a crear en el directorio <raíz_perfil>/samples/lib/JaxWSServicesSamples.
  2. Abra una sesión de FTP en WebSphere Application Server para z/OS de la plataforma de desarrollo.
  3. Vaya al directorio <raíz_perfil>/samples/lib/JaxWSServicesSamples.
  4. Suprima el archivo JaxWSServicesSamples.ear existente. Escriba el mandato: del JaxWSServicesSamples.ear
  5. Para transferir el archivo en formato binario, escriba el mandato: bin
  6. Mueva el JaxWSServicesSamples.ear que se ha vuelto a crear de la plataforma de desarrollo al servidor de aplicaciones de destino. Escriba el mandato: put JaxWSServicesSamples.ear
  7. Finalice la sesión FTP. Escriba quit.

Eliminar y volver a instalar el archivo JaxWSServicesSamples.ear

Por omisión, el ejemplo de Servicios Web de JAX-WS se instala en el directorio <raíz_perfil>/installedApps/<nombre de célula>, donde <nombre de célula> es el nombre de la célula donde se ha instalado la aplicación. Vuelva a instalar el ejemplo como se describe en los pasos siguientes:

  1. Detenga el servidor de aplicaciones.
  2. Elimine el archivo EAR del ejemplo de servicios Web de JAX-WS:
    1. Escriba los siguientes mandatos:

      cd <raíz_perfil>\bin
      setupCmdLine

      cd <raíz_perfil>/bin
      . ./setupCmdLine.sh

      cd <raíz_perfil>/bin
      . ./setupCmdLine.sh

      cd <raíz_perfil>/bin
      . ./setupCmdLine

      donde <raíz_perfil> representa el directorio de instalación del perfil.
    2. Escriba el siguiente mandato para desinstalar la aplicación (<raíz_perfil>/bin debe estar en la variable PATH):

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

  3. Vuelva a instalar el ejemplo:
    • Cambie al directorio <raíz_perfil>/samples/lib/JaxWSServicesSamples
    • Busque el archivo JaxWSServicesSamples.ear
    • Escriba lo siguiente:

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node',
      '<nodo>',
                  '-server', '<servidor>' ] )"
                
      donde <nodo> es el nombre del nodo y <servidor> es el nombre del servidor donde se va a instalar el ejemplo.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node',
      '<nodo>',
                  '-server', '<servidor>' ] )"
                
      donde <nodo> es el nombre del nodo y <servidor> es el nombre del servidor donde se va a instalar el ejemplo.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node',
      '<nodo>',
                  '-server', '<servidor>' ] )"
                
      donde <nodo> es el nombre del nodo y <servidor> es el nombre del servidor donde se va a instalar el ejemplo.
      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node',
      '<nodo>',
                  '-server', '<servidor>' ] )"
                
      donde <nodo> es el nombre del nodo y <servidor> es el nombre del servidor donde se va a instalar el ejemplo.
  4. Inicie el servidor de aplicaciones.

Ya ha vuelto a crear e instalar la aplicación de ejemplos de servicios Web de JAX-WS. Puede configurar y ejecutar los clientes de ejemplo de Ping, Echo y MTOM.