Construirea exemplului BeenThere cu unealta de build Ant


Portabilitatea J2EE
Reconstruirea Exemplelor care se livrează în această galerie
Iniţiere
Identificarea structurii de directoare
Reconstruirea şi instalarea Exemplului

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 UNIX, 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 care se livrează în această galerie

Fiecare WebSphere Application Server (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. O singură excepţie apare când faceţi clic pe nume_exemplu > Construire cu Ant > platforma > Reconstruire şi instalaţi fişierul sample.ear, primiţi instrucţiuni să reconstruiţi fişierul EAR pe acea platformă.  Deoarece fişierele text într-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 implementa şi instala 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ă 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 <profile_root>. Creaţi un fişier zip al directorului samples. Puteţi restaura directorul samples la starea lui originală prin extragerea fişierului zip.



Identificarea structurii de directoare

Structura de directoare a exemplului este dum urmează:


profile_root/samples/src/BeenThere Conţine codul sursă exemplu pentru exemplul BeenThere.
profile_root/samples/lib/BeenThere Conţine fişierul BeenThere.ear pentru exemplul BeenThere.
profile_root/samples/javadoc/BeenThere Conţine documentaţia Javadoc care se generează când este construit exemplul BeenThere.
profile_root/samples/bld/BeenThere Conţine fişierele de clasă generate. Folosiţi aceste fişiere clasă pentru a genera fişierul final BeenThere.ear. Directorul bld este creat după ce exemplul BeenThere este construit.



Reconstruirea şi instalarea Exemplului

Indicaţiile care urmează descriu paşii pentru reconstruirea Exemplului.


Rularea scriptului de construire (build) a exemplului

Urmaţi aceşti paşi pentru a rula scriptul de build pentru exemplu pentru a reconstrui Exemplul.

  1. Deschideţi un prompt de comandă.
  2. În linia de comandă, schimbaţi la directorul profile_root/samples/src/BeenThere.
  3. Rulaţi scriptul de construire a exemplului:

  4. Introduceţi următoarea comandă:

    profile_root\samples\bin\BeenThere\buildBeenThere.bat

    Introduceţi următoarea comandă:

    . profile_root/samples/bin/BeenThere/buildBeenThere.sh

    • Pe platformele de dezvoltare Windows, introduceţi următoarea comandă:

      profile_root\samples\bin\BeenThere\buildBeenThere.bat

    • Pe platformele de dezvoltare UNIX şi Linux, introduceţi următoarea comandă:

      . profile_root/samples/bin/BeenThere/buildBeenThere.sh
    Introduceţi următoarea comandă:

    . profile_root/samples/bin/BeenThere/buildBeenThere.sh

Exemplul este acum construit.

Găsiţi buildBeenThere.bat sau scriptul buildBeenThere în directorul profile_root/samples/bin/BeenThere. Scripturile setează infomaţiile de cale clase corespunzătoare şi rulează utilitarul de build Ant. Utilitarul 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.

Transferarea fişierului reconstruit BeenThere.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/BeenThere
  2. Deschideţi o sesiune FTP pe un WebSphere Application Server for z/OS de pe platforma de dezvoltare
  3. Schimbaţi directorul la <profile_root>/samples/lib/BeenThere
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

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

Reinstalaţi Exemplul aşa cum este descris în următorii paşi:


  1. Lansaţi consola administrativă deschizând un browser Web şi mergând la http://<host_name>:9060/ibm/console unde <host_name> este numele de gazdă sau adresa IP unde rulează managerul de implementare.
  2. Lansaţi consola administrativă deschizând un browser Web şi mergând la http://<host_name>:9060/ibm/console unde <host_name> este numele de gazdă sau adresa IP unde rulează managerul de implementare.
  3. Lansaţi consola administrativă deschizând un browser Web şi mergând la http://<host_name>:9080/admin unde <host_name> este numele de gazdă sau adresa IP unde rulează managerul de implementare.
  4. Lansaţi consola administrativă deschizând un browser Web şi mergând la http://<host_name>:9060/ibm/console unde <host_name> este numele de gazdă sau adresa IP unde rulează managerul de implementare.
  5. Faceţi clic pe Servere >Clustere.
  6. Selectţi toate clusterele.
  7. Faceţi clic pe Oprire.
  8. Faceţi clic pe Aplicaţii>Aplicaţii Enterprise.
  9. Selectaţi aplicaţia BeenThere.
  10. Faceţi clic pe Dezinstalare.
  11. Faceţi clic pe Salvare din partea de sus a panoului principal al consolei administrative.
  12. Faceţi clic pe Salvare.
  13. Efectuaţi paşii pentru Instalarea fişierului BeenThere.ear.

Fişierul BeenThere.ear reconstruit este acum implementat în serverul dumneavoastră de aplicaţii.