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


Portabilidad de J2EE
Volver a crear los ejemplos que se suministran en esta galería
Cómo empezar
Identificar la estructura de directorios de los ejemplos creados
Cómo volver a crear e instalar el archivo WebServicesSamples.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 sistemas Intel o UNIX, el desarrollador puede eliminar los retos de EBCDIC en ASCII o las conversiones de archivos de ASCII a 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 que se suministran en esta galería

Todos los clientes de WebSphere Application Server (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, podrá ver la galería de ejemplos. La única excepción es cuando pulsa nombre_ejemplo > Créelo con Ant > plataforma > Volver a crear e instalar el archivo sample.ear, que aparecen instrucciones para volver a crear el archivo EAR en esta plataforma.   Como los archivos de texto en un archivo EAR (XML, xmi, archivos JSP (JavaServer Pages), entre otros) 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 también las aplicaciones de ejemplo del servidor de aplicaciones.

Realice una copia de seguridad del directorio <raíz_perfil>/samples/src/WebServicesSamples 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/WebServicesSamples Contiene el código fuente de ejemplo para los ejemplos de AddressBook y Stock Quote.
<raíz_perfil>/samples/lib/WebServicesSamples Contiene los archivos archivadores Web (WAR), los archivos archivadores Java (JAR) y el archivo WebServicesSamples.ear final de los ejemplos. Este directorio se crea después de volver a crear el ejemplo.
<raíz_perfil>/samples/javadoc/WebServicesSamples Contiene la documentación Javadoc de los ejemplos. Este directorio se crea después de volver a crear el ejemplo.
<raíz_perfil>/samples/bld/WebServicesSamples Contiene los archivos de clase generados. Estos archivos de clases se utilizan para generar el archivo WebServicesSamples.ear final. Este directorio se crea después de volver a crear este ejemplo.

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

El archivo EAR (Enterprise Archive) de ejemplos de servicios Web de JAX-RPC 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 archivo WebServicesSamples.ear que se ha vuelto a crear
Eliminar y volver a instalar el archivo WebServicesSamples.ear

Ejecutar el script de creación de los ejemplos

Para volver a crear este ejemplo, verifique que <raíz_perfil>/bin está en la variable de entorno PATH. Siga estos pasos para ejecutar el script de creación del ejemplo, que vuelve a crear el ejemplo:

  1. Abra un indicador de mandatos.
  2. En la línea de mandatos, cambie al directorio <raíz_perfil>/samples/src/WebServicesSamples.
  3. Ejecute el script de creación del ejemplo:
  4. Escriba buildWebServiceSamples en la línea de mandatos.
    • En las plataformas de desarrollo Windows, escriba buildWebServiceSamples en la línea de mandatos.
    • En las plataformas de desarrollo UNIX y Linux, escriba buildWebServiceSamples.sh en la línea de mandatos.

Ya se ha creado el ejemplo.

El archivo buildWebServicesSamples.bat y el script buildWebServicesSamples.sh en el directorio <raíz_perfil>/samples/bin/WebServicesSamples establecen la información de vía de acceso de clases adecuada y ejecutan el programa de utilidad de creación Ant. ANT lee los archivos build.xml, que describen cómo crear el ejemplo. Consulte el sitio Web de Jakarta para obtener documentación adicional sobre 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 archivo WebServicesSamples.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. Busque y vuelva a crear el archivo EAR en el directorio <raíz_perfil>/samples/lib/WebServicesSamples
  2. Abra una sesión de FTP en WebSphere Application Server para z/OS de la plataforma de desarrollo
  3. Cambie al directorio <raíz_perfil>/samples/lib/WebServicesSamples
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

Eliminar y volver a instalar el archivo WebServicesSamples.ear

Por omisión, el ejemplo de Servicios Web de JAX-RPC 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-RPC:
    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('WebServicesSamples')" 

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

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

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

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

      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node',
      '<nodo>',
                  '-server', '<servidor>', '-deployejb' ] )"
                
      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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node',
      '<nodo>',
                  '-server', '<servidor>', '-deployejb' ] )"
                
      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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node',
      '<nodo>',
                  '-server', '<servidor>', '-deployejb' ] )"
                
      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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node',
      '<nodo>',
                  '-server', '<servidor>', '-deployejb' ] )"
                
      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-RPC. Puede configurar y ejecutar los clientes de ejemplos de Address Book y Stock Quote.