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:
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. Az automatikus javítás a cél JNDI nevet a weblogic-ejb-jar.xml fájlból a WebSphere(R ) alkalmazáskiszolgálóra kötési fájlba. Az automatikus javítás azonban nem állítja be a ActivationSpec JNDI nevet, és nem migrálja az aktiválási konfigurációs tulajdonságokat a ejb-jar.xml oldalon.
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.
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: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.
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.
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.