Použít vazby WebSphere k definování názvů rozhraní JNDI objektů typu message-driven bean

Objekt message-driven-descriptor konfiguruje cíl pro modul listener pro zprávy. Odkaz na místo určení zpráv je logický název používaný k vyhledání objektu enterprise bean v modulu EJB, který slouží jako místo určení zpráv. Odkazy na místo určení zprávy se vyskytují pouze v artefaktech J2EE 1.4 a novějších, například:

• Aplikační klienti J2EE 1.4.
• projekty EJB 2.1,
• Webové aplikace 2.4.

Pokud je k jednomu propojení s místem určení zpráv přiřazeno více odkazů na místa určení zpráv, jsou během zavádění shromážděny údaje o jednom názvu JNDI objektu enterprise bean, který je mapován na propojení s místem určení zpráv a na všechny propojené odkazy na místa určení zpráv. Za běhu jsou odkazy na místa určení zpráv svázány se spravovanými místy určení zprávy v cílovém provozním prostředí. Pokud je odkaz na místo určení zprávy a objekt typu message-driven bean propojeni stejným místem určení zprávy, musí mít odkaz i objekt typu bean stejný název rozhraní JNDI místa určení. Mají-li oba stejný název, bude pro objekt typu message-driven bean odebrán pouze název rozhraní JNDI cíle a použije se pro odpovídající odkaz na místo určení zprávy. Pokud se implementátor při instalaci aplikace rozhodne pro generování výchozích vazeb, průvodce instalací přiřadí názvy JNDI k následujícím neúplným odkazům na místo určení zprávy:

Má-li odkaz na místo určení zprávy <message-destination-link>, pak je název rozhraní JNDI nastaven na ejs/message-destination-linkName. Jinak je název rozhraní JNDI nastaven na eis/message-destination-refName.

Toto pravidlo zjistí názvy rozhraní JNDI cíle pro objekty typu message-driven bean. Rychlá oprava poskytnutá zdrojovým skenerem zkopíruje název rozhraní JNDI cíle ze souboru jboss.xml na vázací soubor serveru WebSphere traditional nebo Liberty. Rychlá oprava však nenastaví název rozhraní JNDI specifikace aktivace nebo migruje vlastnosti konfigurace aktivace v souboru ejb-jar.xml.

• Definovat vazby v migraci na server Liberty
  

Při migraci objektů typu message-driven bean na server Liberty jsou k dispozici tři volby připojení, IBM MQ, adaptér prostředků JCA a vestavěný server systému zpráv. Další informace o těchto volbách viz dokumentace .

• Definovat vazby během vývoje aplikací
  

Vývojář aplikací může vytvořit definice vazby v souborech ibm-xxx-bnd.xml pro moduly EJB 3.0 a Web 2.5 a v souborech ibm-xxx-bnd.xmi pro moduly, které existovaly před platformou Java(R) Platform, Enterprise Edition (Java EE) 5. Vývojář aplikací může vytvořit soubory pomocí nástroje, jako jsou např. vývojový nástroj IBM(R) Rational(R) nebo v případě modulů EJB 3.0 nebo Web 2.5 editor XML nebo textového editoru. Vývojář pak předá podnikovou aplikaci (soubor .ear), která je dokončena s vazbami, specialistovi sestavující aplikaci nebo specialistovi na implementaci. Při sestavování aplikace specialista sestavující aplikaci neupravuje vazby. Podobně při instalaci aplikace na server podporovaný aplikačním serverem WebSphere Application Server specialista na implementaci neupraví ani nepřepíše vazby nebo nevygeneruje výchozí vazby, pokud nejsou změny vazeb nezbytné pro úspěšnou implementaci aplikace.

Chcete-li provést požadované změny v produktu Rational Application Developer pro objekty EJB 2.1 bean, proveďte následující akce:


1. Spusťte nástroj pro sestavení, Rational Application Developer.
2. Otevřete správný projekt EJB.
3. Poklepejte na deskriptor implementace.
4. Klepněte na správný objekt typu message-driven bean.
5. Posuňte se dolů na sekci Vazby WebSphere.
6. Zaškrtněte políčko Adaptér JCA a zadejte název rozhraní JNDI specifikace aktivace.


Chcete-li provést požadované změny v administrativní konzole pro objekty typu EJB 2.0 bean, proveďte následující akce: Rational Application Developer verze 7.0 nepodporuje nastavení specifikací aktivace EJB 2.1 pro objekty typu EJB 2.0 bean. Specifikace aktivace EJB 2.1 lze nastavit pouze pro objekty typu EJB 2.1 bean.


1. Nastavte specifikaci aktivace pro objekt typu message-driven bean pomocí administrativní konzoly, když implementujete aplikaci na server WebSphere Application Server.
2. Exportujte soubor EAR pro aplikaci z administrativní konzoly.
3. Zkopírujte deskriptor implementace ze souboru EAR do projektu tak, aby měl správnou specifikaci aktivace.



• Definovat vazby během sestavení aplikace
  

Specialista sestavující aplikaci může definovat vazby v anotacích nebo deskriptorech implementace aplikace. Moduly Java EE 5 obsahují anotace ve zdrojovém kódu. Chcete-li deklarovat anotaci, specialista sestavující aplikaci předchází klíčovému slovu pomocí znaku @. Vazby pro moduly před verzí Java EE 5 jsou určeny v části Vazby WebSphere v editoru deskriptoru implementace. Úprava deskriptorů implementace může změnit definice vazeb ve vázacích souborech, které jsou vytvořeny při vývoji aplikace. Po definování vazeb specialista sestavující aplikaci předá aplikaci specialistovi na implementaci. Při instalaci aplikace na server podporovaný aplikačním serverem WebSphere Application Server specialista na implementaci neupraví a nepřepíše vazby ani nevygeneruje výchozí vazby, pokud nejsou změny vazeb nezbytné pro implementaci aplikace.




• Definovat vazby během instalace aplikace
  

Implementátor aplikace nebo administrátor serveru může upravit vazby při instalaci aplikace na server podporovaný aplikačním serverem WebSphere Application Server pomocí administrativní konzoly. Nové definice vazby lze zadat na stránkách průvodce instalací.

Generování výchozích vazeb při instalaci aplikace může vybrat také vývojář nebo administrátor. Výběrem generování výchozích vazeb při instalaci aplikace instruujete produkt, aby se vazby v aplikaci dokončily s výchozími hodnotami. Existující vazby se nezmění.

Omezení: Vazby nemůžete definovat ani přepisovat v průběhu instalace aplikace pro aplikační klienty. Při sestavení a uložení vazeb ve vázacím souboru je nutné definovat vazby pro moduly aplikačního klienta.




• Definovat vazby během konfigurace nainstalované aplikace
  
  

Po instalaci aplikace na server podporovaný aplikačním serverem WebSphere Application Server může implementátor aplikace nebo administrátor serveru upravit vazby změnou hodnot na stránkách administrativní konzoly, jako jsou ty, které jsou přístupné ze stránky nastavení pro podnikovou aplikaci.