Exemplu de construire a extensiilor JTA



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

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>/samples/src/JTAExtensionsSamples.

Identificarea structurii de directoare a build-ului Exemple

Localizaţi Exemplele în următoarele directoare:

profile_root/samples/src/JTAExtensionsSamples Conţine codul sursă exemplu pentru exemplul Extensii JTA.
profile_root/samples/lib/JTAExtensionsSamples Conţine fişierele de arhivă Web (WAR) şi fişierul final JTAExtensionsSamples.ear pentru Exemple. Directorul este creat după ce exemplul este reconstruit.
profile_root/samples/javadoc/JTAExtensionsSamples Conţine documentaţia Javadoc pentru exemple. Directorul este creat după ce exemplul este reconstruit.
profile_root/samples/bld/JTAExtensionsSamples Conţine fişierele de clasă generate. Aceste fişiere de clasă sunt folosite pentru a genera fişierul final JTAExtensionsSamples.ear. Directorul este creat după ce exemplul este reconstruit.

Reconstruirea şi instalarea fişierului EAR

Exemplul Extensii JTA (Java Transaction API) 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, împreună cu informaţii suplimentare pentru modificarea lor.

Rularea scriptului de construire (build) a Exemplelor

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

Rularea scriptului de construire (build) a Exemplelor

Pentru a reconstrui exemplul Extensii JTA, verificaţi că profile_root/bin este în variabila de mediu PATH şi schimbaţi la directorul profile_root/samples/src/JTAExtensionsSamples :


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 profile_root/bin. Scripturile setează infomaţiile de cale clase corespunzătoare şi rulează utilitarul de build Ant. Ant citeşte fişierele build.xml, care descriu cum să se construiască Exemplele. Consultaţi situl web Ant pentru documentaţie suplimentară despre Ant.

Transferarea fişierului reconstruit JTAExtensionsSamples.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/JTAExtensionsSamples
  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/JTAExtensionsSamples
  4. del JTAExtensionsSamples.ear
  5. bin
  6. put JTAExtensionsSamples.ear
  7. quit

Înlăturarea şi reinstalarea fişierului EAR

Implicit exemplele Extensii JTA se instalează în directorul profile_root/installedApps/<cell_name>, unde <cell_name> este numele celulei unde este instalată aplicaţia dumneavoastră. Reinstalaţi Exemplele:

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

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

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

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JTAExtensionsSamples')" 
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JTAExtensionsSamples')" 
  3. Reinstalaţi Exemplul:
    1. Mergeţi în directorul profile_root/samples/lib/JTAExtensionsSamples.
    2. Găsiţi fişierul JTAExtensionsSamples.ear
    3. Introduceţi următoarea comandă:

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

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

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