Construirea exemplului JAX-RPC Web services cu unealta de build Ant


Portabilitatea J2EE
Reconstruirea exemplelor livrate în această galerie
Iniţiere
Identificarea structurii de directoare a build-ului Exemple
Reconstruirea şi instalarea fişierului WebServicesSamples.ear

Portabilitatea J2EE

Unul dintre marele avantaje ale dezvoltării aplicaţiilor pe o platformă J2EE este portabilitatea.  Toate programele Exemplu din galeria Exemple sunt pe o staţie de lucru şi rulate pe sistemele z/OS fără modificarea unei singure linii de cod Java.   Prin construirea aplicaţiilor J2EE pe sistemele Intel sau UNIX, un dezvoltator poate elimina problemele create de conversiiile de fişiere din EBCDIC în ASCII sau din ASCII în EBCDIC.  Disponibilitatea uneltelor face uşoară pentru dezvoltatori scrierea şi testarea pe o staţie de lucru şi instalarea fişierelor EAR (enterprise archive) pe sistemele z/OS.

Reconstruirea Exemplelor livrate în această galerie

Fiecare WebSphere Application Server (Application Server) al unui utilizator z/OS este îndreptăţit la un mediu de stocare Application Server pentru multiplatforme. Dacă aţi instalat produsul de bază WebSphere Application Server şi Exemplele pe una din platformele suportate de acest pachet, veţi vedea aceeaşi galerie. Apare o singură excepţie: când faceţi clic pe nume_exemplu > Construire cu Ant > platformă > Reconstruire şi instalare fişier sample.ear, primiţi instrucţiuni să reconstruiţi fişierul EAR pe acea platformă.  Deoarece fişierele text dintr-un fişier EAR (XML, xmi, fişierele JSP ş.a.m.d.) trebuie să fie într-un format ASCII, este mai uşor să editaţi aceste fişiere pe o maşină ASCII.  Dacă faceţi modificări pe o maşină ASCII, puteţi apoi reinstala fişierul EAR rezultat pe platforma z/OS fără conversia EBCDIC la ASCII. 

Iniţiere

Instalaţi WebSphere Application Server pe platforma distribuită aleasă de dumneavoastră şi indicaţi să se instaleze şi aplicaţiile Application Server Sample.

Înainte de a încerca să modificaţi sau să reconstruiţi exemplele, faceţi o copie de rezervă a directorului <rădăcină_profil>/samples/src/WebServicesSamples.

Identificarea structurii de directoare a build-ului Exemple

Exemplele sunt instalate în următoarele directoare:

<rădăcină_profil>/samples/src/WebServicesSamples Conţine codul sursă exemplu pentru exemplele AddressBook şi Stock Quote.
<rădăcină_profil>/samples/lib/WebServicesSamples Conţine fişierele de arhivă Web (WAR), fişierele de arhivă Java (JAR) şi fişierul final WebServicesSamples.ear pentru exemple. Acest director este creat după ce este reconstruit exemplul.
<rădăcină_profil>/samples/javadoc/WebServicesSamples Conţine documentaţia Javadoc pentru exemple. Acest director este creat după ce este reconstruit exemplul.
<rădăcină-profil>/samples/bld/WebServicesSamples Conţine fişierele de clasă generate. Aceste fişiere de clasă sunt folosite pentru a genera fişierul final WebServicesSamples.ear. Directorul este creat după ce exemplul este reconstruit.

Reconstruirea şi instalarea fişierului WebServicesSamples.ear

Fişierul EAR al exemplelor JAX-RPC Web services este furnizat atunci când este instalat WebSphere Application Server. Nu trebuie să construiţi exemplele înainte de a le folosi. Indicaţiile care urmează descriu paşii pentru reconstruirea exemplelor, împreună cu informaţii suplimentare pentru modificări.

Executarea scriptului de construire a exemplelor

Transferarea fişierului WebServicesSamples.ear reconstruit
Înlăturarea şi reinstalarea fişierului WebServicesSamples.ear

Executarea scriptului de construire a exemplelor

Pentru a reconstrui exemplul, verificaţi că <rădăcină_profil>/bin este în variabila de mediu PATH. Parcurgeţi paşii următori pentru a executa scriptul de build pentru a reconstrui exemplul:

  1. Deschideţi un prompt de comandă.
  2. În linia de comandă, schimbaţi la directorul <rădăcină_profil>/samples/src/WebServicesSamples.
  3. Rulaţi scriptul de construire a exemplului:
  4. Introduceţi în linia de comandă buildWebServiceSamples.
    • Pe platformele de dezvoltare Windows, introduceţi buildWebServiceSamples în linia de comandă.
    • Pe platformele de dezvoltare UNIX şi Linux, introduceţi buildWebServiceSamples.sh în linia de comandă.

Exemplul este acum construit.

buildWebServicesSamples.bat şi scriptul buildWebServicesSamples.sh din directorul <rădăcină_profil>/samples/bin/WebServicesSamples setează informaţiile corespunzătoare pentru calea de clasă şi execută utilitarul de build Ant. Ant citeşte fişierele build.xml, care descriu cum să se construiască exemplele. Consultaţi situl web Jakarta pentru documentaţie suplimentară despre Ant.

Informaţii importante În timpul procesului de build, sunt reconstruite numai fişierele de clasă care au modificări. Celelalte fişiere sunt reîmpachetate într-un nou fişier EAR.

Transferarea fişierului WebServicesSamples.ear reconstruit

Utilizaţi FTP (File Transfer Protocol) pentru a transfera fişierul EAR binar pe serverul z/OS, folosind următoarele instrucţiuni.

  1. Găsiţi fişierul EAR reconstruit în directorul <rădăcină_profil>/samples/lib/WebServicesSamples
  2. Deschideţi o sesiune FTP pe un WebSphere Application Server for z/OS de pe platforma de dezvoltare
  3. Schimbaţi directorul la <rădăcină_profil>/samples/lib/WebServicesSamples
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

Înlăturarea şi reinstalarea fişierului WebServicesSamples.ear

Implicit, exemplul JAX-RPC Web Services se instalează în directorul <rădăcină_profil>/installedApps/<nume celulă>, unde <nume celulă> este numele celulei unde este instalată aplicaţia dumneavoastră. Reinstalaţi exemplul, aşa cum se arată în următorii paşi:

  1. Opriţi serverul de aplicaţii.
  2. Înlăturaţi fişierul EAR al exemplului JAX-RPC Web services:
    1. Introduceţi următoarele comenzi:

      cd <rădăcină_profil>\bin
      setupCmdLine

      cd <rădăcină_profil>/bin
      . ./setupCmdLine.sh

      cd <rădăcină_profil>/bin
      . ./setupCmdLine.sh

      cd <rădăcină_profil>/bin
      . ./setupCmdLine

      unde <rădăcină_profil> reprezintă directorul de instalare al profilului.
    2. Introduceţi următoarea comandă pentru a dezinstala aplicaţia (<rădăcină_profil>/bin trebuie să fie în 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. Reinstalaţi exemplul:
    • Mergeţi în directorul <rădăcină_profil>/samples/lib/WebServicesSamples
    • Găsiţi fişierul WebServicesSamples.ear
    • Tastaţi următoarele:

      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nod>',
                  '-server', '<server>', '-deployejb' ] )"
                
      unde <nod> este numele nodului, iar <server> este numele serverului pe care aţi instalat exemplul.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nod>',
                  '-server', '<server>', '-deployejb' ] )"
                
      unde <nod> este numele nodului, iar <server> este numele serverului pe care aţi instalat exemplul.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nod>',
                  '-server', '<server>', '-deployejb' ] )"
                
      unde <nod> este numele nodului, iar <server> este numele serverului pe care aţi instalat exemplul.
      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nod>',
                  '-server', '<server>', '-deployejb' ] )"
                
      unde <nod> este numele nodului, iar <server> este numele serverului pe care aţi instalat exemplul.
  4. Porniţi serverul de aplicaţii.

Aţi reconstruit şi reinstalat aplicaţia exemplu JAX-RPC Web Services. Puteţi să configuraţi şi să rulaţi clienţii exemplu Address Book şi Stock Quote.