Használjon WebSphere kötéseket az üzenetvezérelt komponenshez tartozó JNDI nevek meghatározásához

A message-driven-descriptor elem az üzenetfigyelő célját állítja be. Az üzenetcél-hivatkozás olyan logikai név, mely egy EJB-komponens keresésére szolgál az üzenetcélként viselkedő EJB modulban. Az üzenetcél-hivatkozások csak J2EE 1.4 és újabb változatú műtermékekben léteznek, például:

• J2EE 1.4 alkalmazásügyfelekben
• EJB 2.1 törekvésekben
• 2.4 világhálós alkalmazásokban

Ha több üzenetcél-hivatkozás kerül egyetlen üzenetcél-összeköttetéshez társításra, akkor egyetlen, üzenetcél-összeköttetésre leképezhető EJB-komponens JNDI neve, és ezáltal az összes csatolt üzenetcél-hivatkozás kerül a telepítés során összegyűjtésre. Futás közben az üzenetcél-hivatkozások kötésre kerülnek a cél működési környezetben található felügyelt üzenetcélokhoz. Ha egy üzenetcél-hivatkozás és egy üzenetvezérelt komponens komponens ugyanazon üzenetcél által kerül összeköttetésre, akkor a hivatkozásnak és a komponensnek egyaránt azonos cél JNDI névvel kell rendelkeznie. Ha e kettő neve megegyezik, akkor csak az üzenetvezérelt komponens cél JNDI neve vesz részt az adatgyűjtésben és kerül alkalmazásra a megfelelő üzenetcél-hivatkozásra. Ha a telepítő úgy dönt, hogy az alkalmazás telepítése során alapértelmezett kötéseket állít elő, akkor a telepítővarázsló a következő hiányos üzenetcél-hivatkozásokhoz rendel JNDI neveket:

Ha egy üzenetcél hivatkozás tartalmaz egy üzenetet-cél-link>, akkor a JNDI név beállítása ejs/message-destination-linkName Ellenkező esetben a JNDI név beállítása eis/message-destination-refName .

Ez a szabály az üzenetvezérelt komponensek cél JNDI nevét ismeri fel. Automatikus javítást kapunk a cél JNDI név másolására a jboss.xml fájlból a WebSphere hagyományos vagy Liberty kötési fájlba. Be kell állítania a ActivationSpec JNDI nevet és a az aktiválási konfigurációs tulajdonságok áttelepítése a ejb-jar.xml.

• Kötések meghatározása Liberty kiszolgálóra való áttérésben
  

Amikor üzenetvezérlet komponenseket állít át Liberty kiszolgálóra, három csatlakozáskapcsolat lehetőség áll: IBM MQ , JCA erőforrás-illesztő és beágyazott üzenetkezelési kiszolgáló. A beállításokkal kapcsolatos további információkért nézze meg a dokumentációt.

• Kötések meghatározása az alkalmazásfejlesztés során
  

Az alkalmazásfejlesztők az ibm-xxx-bnd.xml fájlokban hozhatják létre a kötésmeghatározásokat az EJB 3.0 és Web 2.5 modulok, valamint az ibm-xxx-bnd.xmi fájlokban a Java(R) Platform, Enterprise Edition (Java EE) 5-ös változata előtt létező modulok esetén. Az alkalmazásfejlesztők egy alkalmas fejlesztőeszköz, így például az IBM(R) Rational(R) rendszer, illetve az EJB 3.0 vagy Web 2.5 modulok esetén egy XML vagy szövegszerkesztő segítségével készíthetik el a fájlokat. A fejlesztők ezután átadják a kötésekkel együtt elkészült vállalati alkalmazást (.ear fájlt) egy alkalmazásszerkesztőnek vagy -telepítőnek. Az alkalmazás összeállítása során az alkalmazásszerkesztő nem módosítja a kötéseket. Hasonlóképpen az alkalmazás WebSphere Application Server által támogatott kiszolgálóra való telepítésekor a telepítést végző szakember sem változtatja meg vagy definiálja újra a kötéseket, illetve nem állít elő alapértelmezett kötéseket, hacsak nem az alkalmazás sikeres telepítése érdekében van szükség a kötések módosítására.

Az EJB 2.1 komponensek számára szükséges módosítások Rational Application Developer rendszerben való végrehajtásához tegye a következőket:


1. Indítsa el az összeállításhoz használandó eszközt, a Rational Application Developer rendszert.
2. Nyissa meg a megfelelő EJB törekvést.
3. Kattintson duplán a Telepítési leíró
4. Kattintson a megfelelő üzenetvezérelt komponensre.
5. Görgesse le az oldalt a WebSphere kötések szakaszhoz.
6. Jelölje be a JCA adaptáló jelölőnégyzetet, majd adja meg az ActivationSpec JNDI nevet.


EJB 2.0 komponensek esetén a szükséges módosítások végrehajtásához az adminisztrációs konzolon tegye a következőket: A Rational Application Developer 7.0 változata EJB 2.0 komponensek esetén nem támogatja at EJB 2.1 aktiválási előírások beállítását. Az EJB 2.1 aktiválási előírásokat csak EJB 2.1 komponensek esetén állíthatja be.


1. Az adminisztrációs konzol segítségével állítsa be az MDB aktiválási előírását az alkalmazás WebSphere alkalmazáskiszolgálón való telepítésekor.
2. Végezze el az adminisztrációs konzolon az alkalmazáshoz tartozó EAR fájl exportálását.
3. Másolja át a telepítésleírót az EAR fájlból a törekvésbe, hogy az a megfelelő aktiválási előírással rendelkezzen.



• Kötések meghatározása az alkalmazás összeállítása során
  

Az alkalmazásszerkesztő az alkalmazás feljegyzéseiben vagy telepítésleíróiban határozhatja meg a kötéseket. A Java EE 5 modulok feljegyzéseket tartalmaznak a forráskódban. A feljegyzés deklarálása érdekében az alkalmazásszerkesztő @ karaktert fűz egy kulcsszó elé. A Java EE 5 modulok előtti kötések a Telepítésleíró-szerkesztő WebSphere kötések szakaszában kerülnek megadásra. Előfordulhat, hogy a telepítésleírók módosítása megváltoztatja a kötésfájlokban szereplő kötésmeghatározásokat, melyek az alkalmazás fejlesztésekor kerülnek létrehozásra. A kötések meghatározása után az alkalmazásszerkesztő átadja az alkalmazást a telepítőnek. Az alkalmazás WebSphere Application Server által támogatott kiszolgálóra való telepítésekor a telepítést végző szakember nem változtatja meg vagy definiálja újra a kötéseket, illetve nem állít elő alapértelmezett kötéseket, hacsak nem az alkalmazás telepítése érdekében van szükség a kötések módosítására.




• Kötések meghatározása az alkalmazástelepítés során
  

Az alkalmazás WebSphere alkalmazáskiszolgáló által támogatott kiszolgálóra való telepítése során az alkalmazástelepítő vagy kiszolgálóadminisztrátor az adminisztrációs konzol segítségével módosíthatja a kötéseket. Az új kötésmeghatározásokat a telepítővarázsló oldalain lehet megadni.

A telepítő vagy adminisztrátor választhatja azt a lehetőséget is, hogy alapértelmezett kötéseket állít elő az alkalmazás telepítése során. Az alapértelmezett kötések alkalmazástelepítés során való előállítási lehetőségének választása arra utasítja a terméket, hogy az alkalmazásban szereplő kötéseket alapértelmezett értékekkel egészítse ki. A meglévő kötések nem módosulnak.

Korlátozás: Alkalmazásügyfelek esetén nem határozhat meg vagy definiálhat újra kötéseket alkalmazástelepítés közben. Az alkalmazásügyfél-modulok kötéseit az összeállítás során kell meghatároznia, valamint a kötések tárolását is ekkor kell végrehajtania a kötésfájlban.




• Kötések meghatározása a telepített alkalmazás konfigurálása során
  
  

Az alkalmazás WebSphere alkalmazáskiszolgáló által támogatott kiszolgálón való telepítését követően az alkalmazástelepítő vagy kiszolgálóadminisztrátor az értékek adminisztrációskonzol-oldalakon való módosítása révén változtathatja meg a kötéseket, így például a vállalati alkalmazás beállítási oldaláról elérhető értékek esetében is így kell eljárnia.