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


Portabilità J2EE
Ricreazione di esempi forniti in questa raccolta
Introduzione
Identificazione della struttura di directory degli Esempi
Ricreazione e reinstallazione del file WebServicesSamples.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 sono sviluppati su una stazione di lavoro ed eseguiti sui sistemi z/OS senza modificare alcuna riga del codice Java.  Creando le applicazioni J2EE sui sistemi Intel o UNIX, uno sviluppatore è in grado di eliminare le problematiche delle conversioni file EBCDIC in ASCII o ASCII in 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 forniti in questa raccolta

Ciascun WebSphere Application Server (server delle applicazioni) per z/OS è definito sul supporto del server delle applicazioni per più piattaforme. Se si installa il prodotto di base WebSphere Application Server e gli esempi su una delle piattaforme supportate da questo package, viene visualizzata la stessa raccolta. L'unica eccezione è che quando si seleziona nome_esempio > Crea con Ant > piattaforma > Ricreazione e installazione del file sample.ear, vengono visualizzate le istruzioni per ricreare il file EAR su tale piattaforma.  Poiché i file di testo in un file EAR  (XML, xmi, file JSP (JavaServer Page) e così via) devono essere in formato ASCII, è più semplice modificare questi 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 sulla piattaforma distribuita desiderata e indicare di installare le applicazioni di esempio del server delle applicazioni.

Eseguire una copia di backup della directory <root_profilo>/samples/src/WebServicesSamples prima di modificare o ricreare gli esempi.

Identificazione della struttura della directory degli Esempi

Gli esempi vengono installati nelle seguenti directory:

<root_profilo>/samples/src/WebServicesSamples Contiene il codice sorgente degli esempi Rubrica e Quotazioni di borsa.
<root_profilo>/samples/lib/WebServicesSamples Contiene i file WAR (Web archive), i file JAR (Java archive) e il file finale WebServicesSamples.ear degli esempi. Questa directory viene creata dopo la ricreazione dell'esempio.
<root_profilo>/samples/javadoc/WebServicesSamples Contiene la documentazione degli esempi Javadoc. Questa directory viene creata dopo la ricreazione dell'esempio.
<root_profilo>/samples/bld/WebServicesSamples Contiene i file di classe generati. Questi file di classe vengono utilizzati per creare il file finale WebServicesSamples.ear. Questa directory viene creata dopo la ricreazione dell'esempio.

Ricreazione del reinstallazione del file WebServicesSamples.ear

Il file EAR (Enterprise Archive) degli esempi dei servizi Web JAX-RPC viene fornito con l'installazione di 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 degli esempi

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

Esecuzione dello script di creazione degli esempi

Per ricreare questo esempio, verificare che la directory <root_profilo>/bin sia presente nella variabile di ambiente PATH. Seguire queste istruzioni per eseguire lo script di creazione degli esempi, che crea nuovamente l'esempio:

  1. Aprire un prompt di comandi:
  2. Dalla riga comandi, andare alla directory <root_profilo>/samples/src/WebServicesSamples.
  3. Eseguire lo script di creazione dell'esempio:
  4. Sulla riga comandi, digitare buildWebServiceSamples.
    • Sulle piattaforme di sviluppo Windows, immettere buildWebServiceSamples sulla riga comandi.
    • Sulle piattaforme di sviluppo UNIX e Linux, immettere buildWebServiceSamples.sh sulla riga comandi.

L'esempio è stato creato.

Gli script buildWebServicesSamples.bat e buildWebServicesSamples.sh contenuti nella directory <root_profilo>/samples/bin/WebServicesSamples consentono di impostare le informazioni del percorso di classe e di eseguire il programma di utilità di creazione Ant appropriato. Ant legge i file build.xml, che descrivono come creare l'esempio. Per ulteriori informazioni sulla documentazione relativa a Ant, fare riferimento al sito Web di Jakarta .

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 WebServicesSamples.ear ricreato

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

  1. Rilevare il file EAR ricreato nella directory <root_profilo>/samples/lib/WebServicesSamples
  2. Aprire una sessione FTP in WebSphere Application Server per z/OS dalla piattaforma di sviluppo
  3. Passare alla directory <root_profilo>/samples/lib/WebServicesSamples
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

Rimozione e reinstallazione del file WebServicesSamples.ear

Per impostazione predefinita, l'esempio JAX-RPC Web Services 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-RPC:
    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('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. Installare di nuovo l'esempio:
    • Passare alla directory <root_profilo>/samples/lib/WebServicesSamples
    • Individuare il file WebServicesSamples.ear
    • Digitare quanto segue:

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

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

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

Ora l'applicazione Esempi di servizi Web JAX-RPC è stata ricreata e reinstallata. È possibile configurare ed eseguire i client di esempio Address Book e Stock Quote.