Construirea exemplului Plants by WebSphere folosind 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 şi iSeries 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 şi iSeries.

Reconstruirea Exemplelor care se livrează în această galerie

Fiecare WebSphere Application Server (Application Server) pentru un beneficiar z/OS şi iSeries 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 şi iSeries 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>/samples . 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

Exemplele sunt instalate în următoarele directoare:


<profile_root>/samples/src/PlantsByWebSphere Conţine codul sursă exemplu pentru exemplul Plants by WebSphere.
<profile_root>/samples/lib/PlantsByWebSphere Conţine fişierele de arhivă Web (WAR), fişierele de arhivă (JAR) şi fişierul final PlantsByWebSphere.ear pentru exemplu Plants by WebSphere. Directorul este creat după ce exemplul Plants by WebSphere este reconstruit.
<profile_root>/samples/javadoc/PlantsByWebSphere Conţine documentaţia Javadoc. Directorul este creat după ce exemplul Plants by WebSphere este reconstruit.
<profile_root>/samples/bld/PlantsByWebSphere Conţine fişierele de clasă generate. Folosiţi aceste fişiere clasă pentru a genera fişierul final PlantsByWebSphere.ear. Directorul este creat după ce exemplul Plants by WebSphere este reconstruit.

Reconstruirea şi instalarea Exemplului

Exemplul Plants by WebSphere se instalează automat cu WebSphere Application Server. Nu trebuie să construiţi exemplul Plants by WebSphere înainte de a-l folosi. Indicaţiile care urmează descriu paşii pentru reconstruirea Exemplului, împreună cu informaţii suplimentare pentru modificare.


Rularea scriptului de construire (build) a exemplului
Transferarea fişierului reconstruit PlantsByWebSphere.ear
Înlăturarea şi reinstalarea fişierului PlantsByWebSphere.ear

Rularea scriptului de construire (build) a exemplului

Pentru a reconstrui acest Exemplu, verificaţi că profile_root/bin este în variabila de mediu PATH. Urmaţi aceşti paşi pentru a executa 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/PlantsByWebSphere.
  3. Rulaţi scriptul de construire a exemplului:

  4. Introduceţi următoarea comandă:


    <profile_root>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      <profile_root>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      . <profile_root>/samples/bin/PlantsByWebSphere/buildplantsby.sh

Exemplul este acum construit.

buildplantsby.bat şi scriptul buildplantsby din directorul profile_root/samples/bin/PlantsByWebSphere setează informaţii de cale de clase corespunzătoare şi rulează utilitarul de build Ant. Ant citeşte fişierele build.xml, care descriu cum să se construiască Exemplul. Consultaţi situl web Jakarta pentru documentaţie suplimentară despre 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 PlantsByWebSphere.ear

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

  1. Găsiţi fişierul reconstruit EAR în directorul <profile_root>/samples/lib/PlantsByWebSphere
  2. Deschideţi o sesiune FTP pe un WebSphere Application Server pentru z/OS sau iSeries de pe platforma de dezvoltare
  3. Schimbaţi directorul la <profile_root>/samples/lib/PlantsByWebSphere
    S-ar putea să aveţi nevoie să creaţi directorul dacă nu există.
  4. Dacă fişierul PlantsByWebSphere.ear există, ştergeţi-l în aşa fel încât fişierul actualizat să poată fi scris.
    del PlantsByWebSphere.ear
  5. bin
  6. put PlantsByWebSphere.ear
  7. quit

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

Implicit exemplul Plants by WebSphere 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 Plants by WebSphere:
    1. Introduceţi următoarele comenzi:

      cd <profile_root>\bin
      setupCmdLine

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

      Pe platformele z/OS:
      cd <profile_root>/bin
      . ./setupCmdLine.sh

      Pe platformele iSeries:
      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('PlantsByWebSphere')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      Pe platformele z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      Pe platformele iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Reinstalaţi exemplul Plants by WebSphere:
    • Mergeţi în directorul profile_root/samples/lib/PlantsByWebSphere.
    • Găsiţi fişierul PlantsByWebSphere.ear
    • Introduceţi următoarea comandă:

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

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

      Pe platformele z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<node>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    

      Pe platformele iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<node>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      unde <node> este numele nodului şi <server> este numele serverului unde să instalaţi Exemplul.
  4. Porniţi serverul de aplicaţii.

 

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