Construirea Exemplelor de servicii Web JAX-WS cu unealta pentru build Ant


Portabilitatea J2EE
Reconstruirea exemplelor de servicii Web JAX-WS
Iniţiere
Identificarea structurii de directoare a build-ului Exemple
Reconstruirea şi reinstalarea fişierului JaxWSServicesSamples

Portabilitatea J2EE

Unul din 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 pe sisteme de operare ca AIX sau Linux, un dezvoltator poate elimina provocările date 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 arhivă enterprise (EAR) pe sistemele z/OS.

Reconstruirea exemplelor JAX-WS

Fiecare WebSphere Application Server pentru un beneficiar 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 vedeţi aceeaşi galerie. Totuşi, există o diferenţă. Când faceţi clic pe nume_exemplu > Construire cu Ant > platforma > Reconstruire şi instalare fişier sample.ear, instrucţiunile pentru reconstruirea fişierului EAR pe acea platformă sunt specifice.  Deoarece fişierele text într-un fişier EAR, cum ar fi XML, xmi, fişierele JSP 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ă o conversie EBCDIC la ASCII.  

Iniţiere

Instalaţi WebSphere Application Server pe platforma distribuită la alegere şi indicaţi să instalaţi aplicaţiile exemplu. Pe panoul de instalare a aplicaţiilor exemplu, selectaţi Instalare aplicaţii exemplu.

Înainte de a încerca să modificaţi sau să reconstruiţi Exemplele, faceţi o copie de rezervă a directorului <profile_root>/samples/src/JaxWSServicesSamples.

Identificarea structurii de directoare a build-ului Exemple

Exemplele sunt instalate în următoarele directoare:

<profile_root>/samples/src/JaxWSServicesSamples Conţine codul sursă exemplu pentru exemplele Ping, Echo şi MTOM.
<profile_root>/samples/lib/JaxWSServicesSamples Conţine fişierele de arhivă Web (WAR), fişierele de arhivă (JAR) şi fişierul final JaxWSServicesSamples.ear pentru Exemple. Directorul este creat după ce exemplul este reconstruit.
<profile_root>/samples/javadoc/JaxWSServicesSamples Conţine documentaţia Javadoc pentru Exemple. Directorul este creat după ce exemplul este reconstruit.
<profile_root>/samples/bld/JaxWSServicesSamples Conţine fişierele de clasă generate. Aceste fişiere de clasă sunt folosite pentru a genera fişierul final JaxWSServicesSamples.ear. Directorul este creat după ce exemplul este reconstruit.

Reconstruirea şi instalarea fişierului JaxWSServicesSamples.ear

Fişierul EAR al JAX-WS Web services Samples este furnizat la instalatrea 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 modificare.

Rularea scriptului de construire (build) a Exemplelor

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

Rularea scriptului de construire (build) a Exemplelor

Pentru a reconstrui fişierul EAR al Exemplelor de servicii Web JAX-WS, realizaţi următorii paşi:

  1. Verificaţi că <profile_root>/bin este în variabila de mediu PATH.
  2. Mergeţi în directorul <profile_root>/samples/src/JaxWSServicesSamples.
  3. Rulaţi scriptul de construire a exemplelor.
    • Pe platformele Windows, introduceţi buildJaxWSSamples.bat în linia de comandă.
    • Pe platforme ca AIX sau Linux, introduceţi în linia de comandă buildJaxWSSamples.sh.

Exemplul este acum construit.

Scripturile buildJaxWSSamples se află în directorul <profile_root>/bin. Scripturile setează informaţiile de clasă corespunzătoare şi rulează utilitarul de build Ant. Utilitarul Ant citeşte fişierele build.xml, care descriu cum să construiţi Exemplele. Consultaţi situl web Apache Ant pentru documentaţie suplimentară despre utilitarul Ant.

Informaţii importante În timpul procesului de build, numai fişierele clasă care au modificări sunt reconstruite. Fişierele de clasă rămase sunt reîmpachetate în fişierul EAR nou.

Transferarea fişierului reconstruit JaxWSServicesSamples.ear

Folosiţ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 reconstruit EAR în directorul <profile_root>/samples/lib/JaxWSServicesSamples
  2. Deschideţi o sesiune FTP pe un WebSphere Application Server for z/OS de pe platforma de dezvoltare.
  3. Mergeţi în directorul <profile_root>/samples/lib/JaxWSServicesSamples.
  4. Ştergeţi fişierul JaxWSServicesSamples.ear existent. Introduceţi comanda: del JaxWSServicesSamples.ear
  5. Pentru a transfera fişierul în format binar, introduceţi comanda: bin
  6. Muteţi JaxWSServicesSamples.ear reconstruit de pe platforma de dezvoltare pe serverul de aplicaţii. Introduceţi comanda: put JaxWSServicesSamples.ear
  7. Terminaţi sesiunea FTP. Introduceţi quit.

Mutarea şi reinstalarea fişierului JaxWSServicesSamples

Implicit exemplul pentru servicii Web JAX-WS se instalează în directorul <profile_root>/installedApps/<cell_name>, unde <cell_name> este numele celulei unde este instalată aplicaţia dumneavoastră. Reinstalaţi Exemplul aşa cum este descris în următorii paşi:

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

      cd <profile_root>\bin
      setupCmdLine

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

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

      cd <profile_root>/bin
      . ./setupCmdLine

      unde <profile_root> reprezintă directorul de instalare profil.
    2. Introduceţi următoarea comandă pentru a dezinstala aplicaţia (<profile_root>/bin trebuie să fie în 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. Reinstalaţi Exemplul:
    • Mergeţi în directorul <profile_root>/samples/lib/JaxWSServicesSamples
    • Găsiţi fişierul JaxWSServicesSamples.ear
    • Introduceţi următoarele:

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
      		['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<node>',
                  '-server', '<server>' ] )"
                
      unde <node> este numele nodului şi <server> este numele serverului unde să instalaţi Exemplul

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
      		['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>',
                  '-server', '<server>' ] )"
                
      unde <node> este numele nodului şi <server> este numele serverului unde să instalaţi Exemplul

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
      		['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>',
                  '-server', '<server>' ] )"
                
      unde <node> este numele nodului şi <server> este numele serverului unde să instalaţi Exemplul
      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>',
                  '-server', '<server>' ] )"
                
      unde <node> este numele nodului şi <server> este numele serverului unde să instalaţi Exemplul
  4. Porniţi serverul de aplicaţii.

Trebuie acum să reconstruiţi şi să reinstalaţi aplicaţia JAX-WS Web services Samples. Puteţi rula clienţii Ping, Echo şi MTOM Sample.