J2C Java komponensek összeépítése a Kötegelt importáló segítségével

A J2C adatkötés varázsló használata helyett J2C kötés osztályok parancssori felület, a Kötegelt importáló segítségével is létrehozhatók és elérhetők. A Kötegelt importáló a munkaterületről is futtatható.

A Kötegelt importáló segítségével J2C kötés osztályok állíthatók elő a CICS ECI és IMS erőforrás illesztőkhöz. A J2C adatkötés varázsló használata helyett J2C kötés osztályok parancssori felület, a Kötegelt importáló segítségével is létrehozhatók és elérhetők. A Kötegelt importáló a munkaterületről is futtatható.
Áttérés V6 Ant parancsfájlokról az új J2C V7 Ant parancsfájlokra: A Rational alkalmazásfejlesztési termékek V7.0 verziója új munkamenet rögzítési szolgáltatást tartalmaz, amely Ant parancsfájlokat állít elő. A V6 verziójú Ant parancsfájlok konvertáláshoz az új, V7 J2C Ant parancsfájl formátumba áttérési eszköz áll rendelkezésre. Az új Ant parancsfájlok rugalmasabbak és könnyeben használhatóak, ezért használatuk ajánlott.

Az áttérési eszköz futtatása

  1. A forrást cserélje le a régi V6 Ant parancsfájlra, amelyet át kíván venni.
  2. Hajtsa végre a migration.xml fájlt a munkaterületen belül, vagy megjelenítés nélküli módot használva futtassa a parancssorból.
    <?xml version="1.0" encoding="UTF-8"?>
    <project name="Migration" default="default" xmlns:j2c="http://com.ibm.adapter.j2c">
    		 <-- 
    		 		 A forrásfájl útvonalának a munkaterületből kiindulónak vagy teljes rendszerútvonalnak kell lennie.
    		 		 Az eredeti fájl (forrás) .bak kiterjesztésűre lesz átnevezve.
    		  -->
     		 <target name="default">
    		 		 <j2c:migrate source="/Script/batchImport_deprecated.xml"/>
    		 </target>
    </project>

Kötegelt importáló parancsfájlok kezelése

  1. Öt fájlban található paramétereket kell módosítania, hogy adott környezete igényeit kielégítse. Ezek a fájlok az <installdir>\IBM\SDP70Shared\plugins/com.ibm.adapter/j2c.commad_6.1.0*/runtime és az <installdir>\IBM\SDP70Shared\plugins/com.ibm.adapter/j2c.commad_6.1.0*/sample/batch_import helyekről szerezhetők be. A következő fájlokra van szüksége:
    1. CICSECI_PlatformProperties.xml: Ez a fájl az alapértelmezésben meghívandó C vagy COBOL forrásfájl paramétereket határozza meg, a Kötegelt importáló futtatásához használt platformtól függetlenül (NT, AIX vagy MVS).
    2. CICSECI_cobolSample.xml: Ez a fájl a Kötegelt importáló által használandó szolgáltatás tulajdonságokokat határozza meg.
      • EISProject
        • név: A szolgáltatás projekt neve, amely az új vállalati szolgáltatást tartalmazni fogja. Ha a szolgáltatás projekt nem létezik, akkor automatikusan létrehozásra kerül.
          Megjegyzés: A mintafájl az EISProject elemen belül ImportPropertyArray elemet tartalmaz. Az itt található importálási tulajdonságok a PlatformProperties.xml fájlban lévő értékeket újradefiniálják. Ha a PlatformProperties.xml fájlban a szolgáltatáshoz beállított alapértelmezések helyesek, akkor az ImportPropertyArray elem eltávolítható.
      • EISService (vegye figyelembe, hogy minden egyes EISProject elemhez több EISService elem is definiálható):
        • név: A vállalati szolgáltatás neve. A C vagy COBOL fájlok importálása után minden szolgáltatáshoz három WSDL fájl kerül létrehozásra (felület, kötés, és szolgáltatás fájlok).
        • típus: A szolgáltatáshoz használt erőforrás illesztő neve. Ez annak a kapcsolat projektnek a neve, amelyik a RAR fájlt tartalmazza.
        • targetNameSpace: A cél névtér URL címe (http://...). Ezenkívül a szolgáltatás projektben az előállított fájlokat tartalmazó csomag kerül előállításra a targetNameSpace alapján.
        • generateHelpers: Ha az importált natív adatok összetett adattípusokból állnak (például C szerkezetek), akkor a szolgáltatás futtatásakor szükség lesz segédosztályokra. Ha a beállítás értéke "igaz", akkor a kötegelt importáló program ezeket a segédosztályokat automatikusan előállítja és lefordítja.
      • Művelet (vegye figyelembe, hogy minden egyes EISService elemhez több Művelet elem is definiálható):
        • név: A művelet neve.
        • típus: A művelet típusa. Ez REQUEST_RESPONSE vagy ONE_WAY lehet.
          Megjegyzés: A Művelet típusától függően, ONE_WAY műveletnek InputMessage meghatározást kell tartalmaznia, míg a REQUEST_RESPONSE műveletnek InputMessage és OutputMessage meghatározást is tartalmaznia kell. Ha az InputMessage és az OutputMessage ugyanazon a típusdefiníción osztozik, akkor egyetlen InputOutputMessage meghatározás kerül felhasználásra.
      • ...Üzenet
        • importFile: A vállalati szolgáltatás művelet létrehozásához használandó meghatározást tartalmazó fájl neve. Ez a fájl C vagy COBOL forrásfájl lehet.
        • importDirectory: Az importFile elemet tartalmazó útvonal. Ha az importDirectory attribútum nincs megadva, akkor az importFile keresése az inputdir és az aktuális könyvtárakban történik.
        • nativeTypeName : Az importFile elemben megadott fájlból importálandó adattípus neve. COBOL esetében például a nativeTypeName értéke valószínűleg DFHCOMMAREA. Ha az importFile értelmezése után a nativeTypeName érvényes adattípusként nem kerül azonosításra, akkor a rendszer hibát ad vissza.
        • név: Az importált típushoz használandó név. Ha a DFHCOMMAREA például vásárlói adatokat képvisel, akkor a nevet beállíthatja Ügyfél értékre.
        • generationPackage: Elhagyható attribútum, amely az előállított segédosztályok ( azaz a komponensek és formátumkezelők) számára eltérő csomagnév megadását teszi lehetővé. Így a felület WSDL fáljban előállított séma számára eltérő névteret biztosít.
    3. sampleContainer.xml : Ez a fájl a Kötegelt importálónak argumentumként lesz átadva és a feldolgozandó fájlok (ImportDefinitions) listáját tartalmazza. Az ImportDefinitionArray elem a következő attribútumokkal rendelkezik:
      • platform: A hosztrendszeren lévő operációs rendszert nevezi meg. Értéke NT, AIX vagy OS390 lehet.
      • platformProperties: A platform tulajdonságfájl nevét adja meg.
    4. importBatch.bat (win) vagy importBatch.sh (linux): Ez maga a Kötegelt importáló programfájl a következő paraméterekkel:
      • containerFile: a c lépésben meghatározott fájl.
      • Választható paraméterek
        • generationStyle
          • 0: az alapértelmezett érték, ami a WebSphere Studio V5.0 stílusnak felel meg.
          • 1: a VisualAge® for Java™ előállítási beállításoknak felel meg: közvetlen, nincs értesítés, nincs belső osztály, nincs névrövidítés, primitív típusú tömbökkel.
          • 2: a VisualAge for Java előállítási beállításoknak felel meg: közvetlen, nincs értesítés, nincs belső osztály, névrövidítés, primitív típusú tömbökkel.
        • munkaterület: az importáláshoz használandó munkaterület teljes képzésű elérési útja
        • RAD_installdir: a Rational Application Developer telepítési könyvtára.
    5. C vagy COBOL forrásfájl: Ezt a COBOL (TADERC99.ccp) vagy C forrásfájlt fogja használni az adatkötés és felület fájok előállításához a Kötegelt importáló segítségével
  2. A Kötegelt importáló futtatása a parancssorból: A Kötegelt importáló indításához a parancssorból tegye a következőket:
    1. Győződjön meg róla, hogy a használni kívánt erőforrás illesztő importálva lett a munkaterületre.
    2. Az 1. lépésben említett fájok tárolására hozzon létre könyvtárat. A hátralévő lépések erre a könyvtárra inputdir könyvtárként fognak hivatkozni.
    3. Állítsa be a hosztrendszer nyelvi és kapcsolati beállításait a platform tulajdonságfájlban. Másolja a megfelelő platform tulajdonságfájlt (CICSECI_PlatformProperties.xml vagy IMS_PlatformProperties.xml) a %PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.j2c.command_6.1.0/sample/batch_import könyvtárból (ahol az x a Rational fejlesztő szoftver telepítési könyvtárára utal) az inputdir könyvtárba és szövegszerkesztő segítségével nyissa meg. A célkörnyezetet tükröző alapértelmezett tulajdonságokat ebben a fájlban kell beállítani. Az ebben a fájlban beállított bármely tulajdonság a következő lépésben leírt szolgáltatás definíciós fájlban újradefiniálható. A nem használt platform definíciókat nem kell törölnie.
    4. Másolja a megfelelő minta szolgáltatás definíciós fájlt (CICSECI_cSample.xml, CICSECI_cobolSample.xml vagy IMS_cobolSample.xml) az inputdir könyvtárba a fájlt igény szerint átnevezve.
    5. Másolja a sampleContainer.xml tárolófájlt az inputdir könyvtárba a fájlt igény szerint átnevezve. Nyissa meg az eredményül kapott fájlt szövegszerkesztő segítségével és állítsa be a megfelelő platformot, majd a d. lépésben létrehozott minden egyes szolgáltatás definíciós fájlhoz adjon hozzá ImportDefinition elemet, amely a létrehozott szolgáltatás definíciós fájlra utal.
    6. Ha a Rational Application Developer cél munkaterületet használó példánya fut, akkor zárja azt be.
    7. A parancssorból indítsa az importBatch parancsot a következő beállításokkal: importBatch -file=containerFile [-style=generationStyle] [-d workspace] [-e RAD_installdir]
      Megjegyzés: A -file paraméterben a containerFile teljes fájlrendszer útvonalát meg kell adni
  3. A Kötegelt importáló futtatása a munkaterületről: A Kötegelt importáló indításához a munkaterületről tegye a következőket:
    1. Győződjön meg róla, hogy a használni kívánt erőforrás illesztő importálva lett a munkaterületre.
    2. Hozzon létre egyszerű projektet (nevezze el Temp-nek) az 1. lépésben említett fájlok tárolására. A hátralévő lépések erre a könyvtárra inputdir könyvtárként fognak hivatkozni.
    3. Hajtsa végre a c. lépést, a d. lépést és az e. lépést a Kötegelt importáló futtatása a parancssorból című részből.
    4. Másolja a batchImport.xml fájlt a %PROGRAMFILES%/IBM/SDP70Shared/plugins/com.ibm.adapter.command_6.0.0/script könyvtárból az inputdir könyvtárba. A sampleContainer.xml fájlt módosítsa saját tárolófájljának nevére.
    5. Kattintson a jobb egérgombbal a batchImport.xml fájlra, majd válassza az előugró menü Futtatás > 2 Ant összeépítés menüpontját. A megnyíló ablakban válassza ki a JRE, majd a Futtatás a munkaterületével megegyező JRE környezetben lehetőséget. Kattintson az Alkalmaz majd a Bezárás elemre. Ezt a lépést csak egyszer kell végrehajtani.
    6. Kattintson a jobb egérgombbal a batchImport.xml fájlra, majd válassza az előugró menü Futtatás > 1 Ant összeépítés menüpontját.

      A Kötegelt importáló a COBOL és C fájlokat importálja, majd a projektben (EISProject) előállítja a kötésfájlokat és az XML fájlban meghatározott (a targetNameSpace elemből származtatott) csomagot .

      Megjegyzés: A parancssorból indított Kötegelt importáló végrehajtási folyamata hasonló, mint a munkaterületről futtatott importáló esetében. Ennek szemléltetésére nyissa meg a munkaterületet, amelyben a fájlok az 1. lépésben előállításra kerültek. Megfigyelheti, hogy ugyanezen fájlokat tartalmazó Temp nevű projekt került kézi úton importálásra a 3. lépésben.

Visszajelzés