Construirea exemplelor Technology cu Ant


Portabilitatea J2EE
Reconstruirea exemplelor livrate în această galerie
Iniţiere
Identificarea structurii de directoare
Reconstruirea şi instalarea fişierului 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 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ă 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 profile_root/samples. Creaţi un fişier zip al directorului samples. Puteţi restaura directorul samples la starea lui originală prin extragerea fişierului zip.

Înainte de a rula comenzile din secţiunile următoare, asiguraţi-vă că rădăcină_instalare/bin se află în PATH.

Identificarea structurii de directoare a build-ului exemplelor

Localizaţi exemplele în următoarele directoare:


rădăcină_profil/samples/src/TechSamp Conţine codul sursă exemplu pentru exemplele Technology.
rădăcină_profil/samples/lib/TechSamp Conţine fişierele de arhivă Web (WAR), fişierele de arhivă Java (JAR) şi fişierul final TechnologySamples.ear pentru exemplele Technology. Directorul lib este creat după ce sunt construite exemplele Technology.
rădăcină_profil/samples/javadoc/TechSamp Conţine documentaţia Javadoc generată la construirea exemplelor Technology.
rădăcină_profil/samples/bld/TechSamp Conţine fişierele de clasă generate. Aceste fişiere de clasă sunt folosite pentru a genera fişierul final TechnologySamples.ear. Directorul bld este creat după ce sunt construite exemplele Technology.

Reconstruirea şi instalarea fişierului TechnologySamples.ear

Exemplele se instalează automat cu WebSphere Application Server. Nu trebuie să construiţi exemplele înainte de a le folosi. Indicaţiile care urmează descriu paşii pentru reconstruirea exemplelor şi oferă informaţii suplimentare pentru modificarea lor.


Executarea scriptului de construire a exemplelor
Transferarea fişierului TechnologySamples.ear reconstruit
Înlăturarea şi reinstalarea fişierului TechnologySamples.ear

Executarea scriptului de construire a exemplelor

Pentru a reconstrui exemplele Technology, verificaţi că rădăcină_profil/bin se află în variabila de mediu PATH şi schimbaţi la directorul rădăcină_profil/samples/src/TechSamp:

Introduceţi în linia de comandă buildsamples.bat.
Introduceţi în linia de comandă buildsamples.
Introduceţi în linia de comandă buildsamples.

Găsiţi buildsamples.bat sau scriptul buildsamples în directorul rădăcină_profil/bin. Scripturile setează infomaţiile corespunzătoare privind calea claselor ş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, vor fi 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 TechnologySamples.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/TechSamp
  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/TechSamp
  4. del TechnologySamples.ear
  5. bin
  6. put TechnologySamples.ear
  7. quit

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

Implicit, exemplele Technology se instalează în directorul rădăcină_profil/installedApps/<nume celulă>, unde <nume celulă> este numele celulei. Reinstalaţi exemplele aşa cum se arată în continuare:

  1. Opriţi serverul de aplicaţii.
  2. Înlăturaţi fişierul EAR al exemplului:
    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ă_instalare/bin trebuie să fie în PATH):

      wsadmin -conntype none -c "$AdminApp uninstall TechnologySamples" 

      wsadmin.sh -conntype none -c "\$AdminApp uninstall TechnologySamples" 

      wsadmin.sh -conntype none -c "\$AdminApp uninstall TechnologySamples" 
      rădăcină_instalare/bin/wsadmin -conntype none -c "\$AdminApp uninstall TechnologySamples" 

  3. Reinstalaţi exemplul:
    • Mergeţi în directorul rădăcină_profil/samples/lib/TechSamp
    • Localizaţi fişierul TechnologySamples.ear
    • Introduceţi următoarea comandă pentru a dezinstala aplicaţia (rădăcină_instalare/bin trebuie să fie în PATH):

      wsadmin -conntype none -c "$AdminApp install TechnologySamples.ear 
        {-appname TechnologySamples -installdir $(APP_INSTALL_ROOT)/$(CELL) -usedefaultbindings -node <nod> -deployejb
        -deployejb.dbtype DERBY_V10}"
              
      unde <nod> este numele nodului unde aţi instalat exemplul.

      wsadmin.sh -conntype none -c "\$AdminApp install TechnologySamples.ear 
        {-appname TechnologySamples -installdir \$(APP_INSTALL_ROOT)/\$(CELL) -usedefaultbindings -node <nod> -deployejb
        -deployejb.dbtype DERBY_V10}"
              
      unde <nod> este numele nodului unde aţi instalat exemplul.

      wsadmin.sh -conntype none -c "\$AdminApp install TechnologySamples.ear 
        {-appname TechnologySamples -installdir \$(APP_INSTALL_ROOT)/\$(CELL) -usedefaultbindings -node <nod> -deployejb
        -deployejb.dbtype DERBY_V10}"
              
      unde <nod> este numele nodului unde aţi instalat exemplul.
      wsadmin -conntype none -c "\$AdminApp install TechnologySamples.ear {-usedefaultbindings -deployejb -appname TechnologySamples -deployejb.dbtype DERBY_V10 -installdir $USER_INSTALL_ROOT/$WAS_CELL}" 
  4. Porniţi serverul de aplicaţii.