Creazione degli esempi di servizi Web JAX-WS con lo strumento di creazione Ant


Portabilità J2EE
Ricreazione degli esempi di servizi Web JAX-WS
Introduzione
Identificazione della struttura di directory degli Esempi
Ricreazione e reinstallazione del file JaxWSServicesSamples.ear

Portabilità J2EE

Uno dei vantaggi principali nelle applicazioni di sviluppo su una piattaforma J2EE è la portabilità.  Tutti i programmi di esempio nella raccolta di esempi vengono sviluppati su una stazione di lavoro ed eseguiti su sistemi z/OS senza modificare alcuna riga del codice Java.  Generando le applicazioni J2EE su Intel o su sistemi operativi quali AIX o Linux, uno sviluppatore può eliminare le problematiche delle conversioni dei file da EBCDIC ad ASCII o da ASCII ad EBCDIC.  La disponibilità di strumenti rende più semplice agli sviluppatori di scrivere e verificare su una stazione di lavoro di sviluppo ed installare i file EAR (enterprise archive) sui sistemi z/OS.

Ricreazione degli esempi JAX-WS

Ogni cliente WebSphere Application Server per z/OS ha diritto ai supporti per server applicazioni per più piattaforme. Se si installa il prodotto base WebSphere Application Server e gli Esempi su una delle piattaforme supportate da questo package, la raccolta visualizzata è la stessa. Tuttavia esiste una differenza. Quando si seleziona nome_esempio > Crea con Ant > piattaforma > Ricreazione e distribuzione del file, le istruzioni per la ricreazione del file EAR sono specifiche per piattaforma.  Poiché i file di testo in un file EAR , come i file XML, xmi o JSP (JavaServer Pages), devono essere in formato ASCII, è più semplice modificare quei file su una macchina ASCII.  Se si apportano modifiche su una macchina ASCII, è possibile reinstallare il file EAR risultante su una piattaforma z/OS, senza dover convertire il formato EBCDIC in ASCII. 

Introduzione

Installare WebSphere Application Server su una piattaforma distribuita a propria scelta ed specificare l'installazione delle applicazioni di esempio. Nel pannello Installa applicazioni di esempio, selezionare Installare le applicazioni di esempio.

Eseguire una copia di backup della directory <root_profilo>/samples/src/JaxWSServicesSamples prima di tentare di modificare o ricreare gli Esempi.

Identificazione della struttura della directory degli Esempi

Gli esempi vengono installati nelle seguenti directory:

<root_profilo>/samples/src/JaxWSServicesSamples Contiene il codice sorgente degli Esempi Ping, Echo e MTOM.
<root_profilo>/samples/lib/JaxWSServicesSamples Contiene i file di archivio Web (WAR), i file di archivio Java (JAR) ed il file finale JaxWSServicesSamples.ear degli esempi. Questa directory viene creata dopo la ricreazione dell'esempio.
<root_profilo>/samples/javadoc/JaxWSServicesSamples Contiene la documentazione degli esempi Javadoc. Questa directory viene creata dopo la ricreazione dell'esempio.
<root_profilo>/samples/bld/JaxWSServicesSamples Contiene i file di classe generati. I file di classe vengono utilizzati per generare il file finale JaxWSServicesSamples.ear. Questa directory viene creata dopo la ricreazione dell'esempio.

Ricreazione e reinstallazione del file JaxWSServicesSamples.ear

Il file EAR (Enterprise Archive) degli esempi di servizi Web JAX-WS viene fornito quando viene installato WebSphere Application Server. Non è necessario creare gli esempi prima di utilizzarli. Le indicazioni che seguono descrivono le operazioni necessarie per ricreare gli esempi, con informazioni aggiuntive per le modifiche.

Esecuzione dello script di creazione di esempi

Trasferimento del file JaxWSServicesSamples.ear ricreato
Rimozione e reinstallazione del file JaxWSServicesSamples.ear

Esecuzione dello script di creazione di esempi

Per rigenerare il file EAR degli esempi di servizi Web JAX-WS, effettuare le seguenti operazioni:

  1. Verificare che <root_profilo>/bin sia contenuto nella variabile di ambiente PATH.
  2. Andare alla directory <root_profilo>/samples/src/JaxWSServicesSamples.
  3. Eseguire lo script di creazione degli esempi.
    • Su piattaforme Windows, sulla riga comandi immettere buildJaxWSSamples.
    • Su piattaforme AIX o Linux, sulla riga comandi immettere buildJaxWSSamples.sh.

L'esempio è stato creato.

Gli script buildJaxWSSamples sono ubicati nella directory <root_profilo>/bin. Gli script impostano le informazioni sul percorso classe appropriate ed eseguono il programma di utilità di creazione Ant. Il programma Ant legge i file build.xml che descrivono come creare gli esempi. Per ulteriore documentazione relativa al programma di utilità Ant, fare riferimento al sito Web Ant Apache.

Informazioni importanti Durante il processo di creazione, verranno ricreati solo i file di classe che sono stati modificati. I file di classe rimanenti verranno compressi in un nuovo file EAR.

Trasferimento del file JaxWSServicesSamples.ear ricreato

Utilizzare FTP (File Transfer Protocol) per trasferire il file EAR binario sul server z/OS, utilizzando le seguenti istruzioni.

  1. Individuare il file EAR ricreato nella directory <root_profilo>/samples/lib/JaxWSServicesSamples.
  2. Aprire una sessione FTP su WebSphere Application Server per z/OS dalla piattaforma di sviluppo.
  3. Andare alla directory <root_profilo>/samples/lib/JaxWSServicesSamples.
  4. Eliminare il file JaxWSServicesSamples.ear esistente. Immettere il comando: del JaxWSServicesSamples.ear
  5. Per trasferire il file in formato binario, immettere il comando: bin
  6. Spostare il file JaxWSServicesSamples.ear ricreato dalla piattaforma di sviluppo al server applicazioni di destinazione. Immettere il comando: put JaxWSServicesSamples.ear
  7. Terminare la sessione FTP. Immettere quit.

Rimozione e reinstallazione del file JaxWSServicesSamples.ear

Per impostazione predefinita, l'esempio di servizi Web JAX-WS viene installato nella directory <root_profilo>/installedApps/<nome cella>, dove <nome cella> è il nome della cella in cui è installata l'applicazione. Installare di nuovo l'esempio come indicato di seguito:

  1. Arrestare il server delle applicazioni.
  2. Per rimuovere il file EAR di esempio di servizi Web JAX-WS:
    1. Immettere i seguenti comandi:

      cd <root_profilo>\bin
      setupCmdLine

      cd <root_profilo>/bin
      . ./setupCmdLine.sh

      cd <root_profilo>/bin
      . ./setupCmdLine.sh

      cd <root_profilo>/bin
      . ./setupCmdLine

      dove <root_profilo> indica la directory di installazione del profilo.
    2. Immettere il seguente comando per disinstallare l'applicazione (<root_profilo>/bin deve essere presente nella variabile di ambiente 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. Installare di nuovo l'esempio:
    • Passare alla directory <root_profilo>/samples/lib/JaxWSServicesSamples
    • Rilevare il file JaxWSServicesSamples.ear
    • Digitare quanto segue:

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<nodo>', 
                  '-server', '<server>' ] )"
                
      dove <nodo> è il nome del nodo e <server> è il nome del server dove installare l'esempio.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nodo>', 
                  '-server', '<server>' ] )"
                
      dove <nodo> è il nome del nodo e <server> è il nome del server dove installare l'esempio.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nodo>', 
                  '-server', '<server>' ] )"
                
      dove <nodo> è il nome del nodo e <server> è il nome del server dove installare l'esempio.
      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nodo>', 
                  '-server', '<server>' ] )"
                
      dove <nodo> è il nome del nodo e <server> è il nome del server dove installare l'esempio.
  4. Avviare il server delle applicazioni.

Ora l'applicazione Esempi di servizi Web JAX-WS è stata ricreata e reinstallata. È possibile configurare ed eseguire i client di esempio Ping, Echo e MTOM.