O specificaţie de activare JMS este asociată cu unul sau mai multe bean-uri de mesaje conduse şi asigură configuraţia necesară pentru ca acestea să primească mesaje.
Creaţi o specificare de activare JMS dacă vreţi să utilizaţi un message-driven bean pentru a comunica cu furnizorul de mesagerie impliciti prin Java EE Connector Architecture (JCA) 1.5. JCA furnizează conectivitate Java între servere de aplicaţii precum WebSphere Application Server şi sisteme de informaţii întreprindere. Furnizează o cale standardizată de integrare a furnizorilot JMS cu servere de aplicaţii Java EE şi furnizează un cadru de lucru pentru schimbare date cu sisteme întreprindere, unde datele sunt transferate sub formă de mesaje.
Toate proprietăţile de configurare a specificaţiei de activare în afară deNume, Nume JNDI, Nume JNDI destinaţie şi Alias autentificare sunt suprascrise de către proprietăţile de configurare a activării numite corespuntător în descriptorul de implementare al unui EJB 2.1 asociat message-driven bean ulterior. Pentru un bean condus de mesaj EJB 2.0, proprietăţile Tip destinaţie, Durată abonament, Mod confirmare şi Selector mesaj sunt înlocuite de elementele corespunzătoare din descriptorul de implementare. Pentru oricare tip de bean proprietatea Nume JNDI destinaţie poate fi înlocuită de o valoare specificată în legăturile de bean condus de mesaj.
Proprietăţile specificaţiei de activare influenţează modul cum furnizorul de mesaje implicit alege motorul de mesagerie pe care se conectează aplicaţia bean mesaj-condus. Implicit, mediul conectează automat aplicaţiile la un motor de mesagerie disponibil de pe magistrală. Însă puteţi specifica detalii de configurare suplimentare pentru a influenţa procesul de conexiune; de exemplu pentru a identifica servere de bootstrap special sau pentru a limita conexiunea la un subgrup al motorelor de mesagerie disponibile sau pentru a îmbunătăţi disponibilitatea sau performanţa sau pentru a asigura procesarea secvenţială a mesajelor primite. Pentru informaţii despre de ce şi sum să faceţi asta, vedeţi subiectul Cum se conectează aplicaţiile JMS la un motor de mesagerie pe o magistrală.
Fila de configuraţie arată proprietăţile de configurare pentru acest obiect. Aceste valori de proprietăţisunt păstrate chiar dacă mediul runtime este oprit şi apoi repornit. Vedeţi descrierile taskurilor din centrul de informaţii pentru informaţii despre cum să aplicaţi modificări de configuraţie mediului runtime.
Specifică nivelul topologic cel mai înalt la care serverele de aplicaţie pot utiliza acest obiect resursă.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Şir |
Specifică furnizor JMS care permite transferul de mesaje asincron bazat pe Java Message Service (JMS). Furnizează fabricile de conexiuni J2EE pentru a crea conexiuni pentru anumite destinaţii coadă JMS sau subiect. Obiectele administrative furnizor JMS sunt utilizate pentru gestionarea resurselor JMS pentru furnizorul JMS asociat.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Şir |
Nume de afişare cerut pentru resursă.
| Informaţii | Valoare |
|---|---|
| Necesare | Da |
| Tipul datelor | Şir |
Nume JNDI pentru resursă.
| Informaţii | Valoare |
|---|---|
| Necesare | Da |
| Tipul datelor | Şir |
O descriere opţională pentru resursă.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Zonă text |
Dacă bean-ul controlat de mesaj foloseşte o coadă sau o destinaţie subiect.
| Informaţii | Valoare |
|---|---|
| Necesare | Da |
| Tipul datelor | listă derulantă |
| Interval |
|
Numele JNDI al destinaţiei
Selectaţi tipul destinaţiei pe proprietatea Tip de destinaţie.
Pentru adaptoare de resurse care suportă JMS, trebuie să asociaţi javax.jms.Destinations cu o specificaţie activă, pentru ca adaptorul de resurse să poată servi mesaje de la destinaţia JMS. În acest caz, administratorul configurează un obiect administrat J2C care implementează interfaţa javax.jms.Destination şi o leagă în JNDI.
Puteţi configura un obiect administrat J2C să folosească o clasă ActivationSpec care implementează o metodă setDestination(javax.jms.Destination). În acest caz, puteţi specifica numele JNDI al destinaţiei (care este numele JNDI al obiectului administrat J2C care implementează javax.jms.Destination).
În timpul pornirii aplicaţiei, când specificaţia de activare este iniţializată ca parte a iniţializării punctului final, serverul foloseşte numele JNDI de destinaţie pentru a căuta obiectul administrat destinaţie, apoi îl setează pe instanţa specificaţiei de activare.
| Informaţii | Valoare |
|---|---|
| Necesare | Da |
| Tipul datelor | Şir |
Selectorul de mesaje JMS folosit pentru a determina ce mesaje receptioneză bean-ul mesaj-acţionat. Valoarea este un şir folosit la selectarea unui subset al mesajelor disponibile. Sintaxa se bazează pe un subset a sintaxei expresiei condiţionale SQL 92, cum este descris în specificatia JMS. Consultaţi centrul de informare pentru mai multe informaţii.
JMSType='car' AND color='blue' AND weight>2500
Şirul selectorului se paote referi la câmpuri din antetul mesajului JMS message header şi la câmpuri în proprietăţile mesajului. Selectoarele de mesaje nu pot referi valorile corpului mesajului.
O valoare nulă (un şir gol) indică faptul că nu există un selector de mesaje pentru consumatorul de mesaje.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Şir |
Numele magistralei de integrare a serviciului la care se va face conectarea.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Personalizare |
Cum confirmă sesiunea toate mesaje recepţionate.
Recunoaşterea este trimisă când este şters mesajul.
Mesajul este şters când porneşte bean-ul dacă calitatea serviciului este setată la Nepersistent cu cel mai mare efort. Pentru toate celelalte calităţi ale serviciului, mesajul este şters când se finalizează bean-ul.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | listă derulantă |
| Interval |
|
Numele destinaţiei ce identifică un grup de motoare de mesagerie. Specificaţi tipul ţintei folosind proprietatea Tip ţintă.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Şir |
Tipul ţintei numite în proprietatea Tip ţintă.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | listă derulantă |
| Interval |
|
Această proprietate specifică semnificaţia grupului ţintă.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | listă derulantă |
| Interval |
|
Numele lanţului de transport de intrare pe care aplicaţia trebuie să îl vizeze când se conectează la un motor de mesagerie intr-un proces separat de aplicaţie. Dacă motorul de mesagerie este ales în alt proces,conexiunea pote fi făcută doar dacă motorul de mesagerie este intr-un server ce rulează lanţuri de transport de intrare specificate. Consultaţi centrul de informare pentru mai multe informaţii.
Dacă motorul de mesagerie selectat este în acelaşi server ca aplicaţia, o conexiune directă în-proces este realizată şi acest lanţ proprietate de transport este ignorat.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Şir |
O lista de tripleti puncte finale cu separator virgula cu sintaxa hostName:portNumber:chainName, folosită la conectarea la serverul de bootstrap. De exemplu Merlin: 7276: BootstrapBasicMessaging,Gandalf: 5557: BootstrapSecureMessaging.
Dacă nume gazdă nu este specificat, localhost este folosit ca valoare implicită.
Dacă numărul portului nu este specificat, 7276 este folosit ca valoare implicită.
Dacă protocolul nu este specificat un lanţ predefinit ca BootstrapBasicMessaging este folosit ca valoare implicită.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Zonă text |
Numărul maxim de mesaje primite de la motorul de mesagerie într-un singur batch.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Număr întreg |
| Interval | 1 prin 2147483647 |
Numărul maxim de puncte finale către care mesajele sunt transmise concomitent.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Număr întreg |
| Interval | 1 prin 2147483647 |
Aceşti parametri activează un punct final pentru a-l opri automat când un număr de mesaje eşuate secvenţial atinge o limită pe care i-o specificaţi. Aceasta vă ajută să distingeţi între unul sau două mesaje care eşuează datorită problemelor cu ele însele, şi o problemă resursă a sistemului care rezultă în mai multe mesaje eşuate secvenţial.
Când un punct final este stopat automat, Starea sa pe panoul consolei administrative este roşu. El trebuie repornit manual prin apăsarea Continuă.
După ce punctul final este repornit, orice mesaj eşuat care a cauzat oprirea punctului final este reîncercat. Dacă ele continuă să eşueze vor fi mutate către o destinaţie de excepţie, dacă este configurată.
Oprirea automată activată a unui punct final bazat pe parametrii de mai jos.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Boolean |
Punctul final va fi oprit când numărul mesajelor secvenţiale eşuate ajunge la limita configurată. Datorită dependenţelor de procesare în MDB, numărul real de mesaje procesate poate depăşi această valoare.
Această proprietate nu este activată doar dacă proprietatea Opreşte automat punctele finale la eşuari repetate ale mesajelor este activată.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Număr întreg |
Orice mesaj a cărui procesare de către MDB eşuează dar care nu a atins limita maximă de livrare de eşuare va fi reîncercată doar după ce această perioadă de timp a expirat (în milisecunde). Alte mesaje pot fi încercate în această perioadă, doar dacă pragul secvenţial de eşec şi concurenţa maximă este setată la 1.
Setând o întârziere între reîncercările mesajelor eşuate reduceţi numărul de mesaje inutil mutate către destinaţia de excepţie înainte ca MDB să se oprească. Pentru minimizarea numărului de mesaje care sunt mutate faceţi această întârziere mai mare decât intervalul de timp aşteptat între mesaje de a ajunge la destinaţie.
Această proprietate nu este activată doar dacă proprietatea Opreşte automat punctele finale la eşuari repetate ale mesajelor este activată.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Număr întreg |
| Interval | Timpul în milisecunde. O valoare a 0 indică nicio întârziere între reîncercări. |
Dacă un subiect abonament JMS este durabil sau nedurabil.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | listă derulantă |
| Interval |
|
Numele abonamentului necesar pentru abonamentele subiecte durabile. Acesta este un câmp cerut atunci cănd se foloseşte un abonament de subiect durabil.
Numele abonamentului trebuie să fie unic într-un identificator client dat.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Şir |
Identificatorul de client JMS necesar pentru abonamentele de subiect durabile în toate conexiunile create folosind această specificaţie activată.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Şir |
Numele motorului de mesagerie folosit să memoreze mesajele livrate către abonamentele durabile pentru obiecte create din această specificaţie activată JMS. Acesta este un câmp cerut atunci cănd se foloseşte un abonament de subiect durabil.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Şir |
Când este activat, Object Messages primit de aplicaţia consumatoare mesaje ce este conectată la această fabrică de conexiuni va avea datele mesajelor serializate de sistem când va fi absolut necesar. Datele obţinute din aceste mesaje trebuie tratate ca şi aplicaţie readOnly.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Boolean |
Când este activat, Object/Bytes Messages trimis de aplicaţia producere mesaje ce va avea sarcina utilă modificată, nu va avea datele sale copiate cănd setează, iar sistemul doar va serializa datele mesajelor când va fi absolut necesar. Aplicaţiile ce trimit aceste mesaje tebuie să nu modifice datele odată ce au fost setate în mesaj.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Boolean |
Citirea în avans este o optimizare care asignează preventiv mesajele la consumatori. Aceasta îmbunătaţeşte timpul necesar de satisfacere a cerinţelor consumatorilor.
Mesajele ce sunt atribuite unui consumator sunt blocate pe server şi nu pot fi consumate de alţi consumatori pentru acea destinaţie. Mesajele ce sunt atribuite unui consumaotr, dar nu sunt consumate până când consumatorul este închis, sunt deblocate ulterior pe server şi apoi făcute disponibile pentru recepţia altor consumatori.
Puteţi înlocui această proprietate pentru destinaţii JMS individuale prin setarea proprietăţii Citiţi înainte pe destinaţia JMS.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | listă derulantă |
| Interval |
|
Această proprietate este folosită doar atunci când aplicaţia MDB rulează pe un server care este membru al magistralei către care ţinteşte aplicaţia. Nu are niciun efect când MDB rulează pe un server care nu este mebru a magistralei destinaţie.
Dacă aplicaţia MDB rulează pe un server care este membru al magistralei destinaţie, activând aveastă opţiune permiteţi aplicaţiei MDB să proceseze mesajele chiar dacă serverul găzduieşte sau nu motorul de mesagerie rulabile. Dacă această opţiune este activată, atunci aplicaţiile MDB pe servere care nu au un rulator local ME nu vor procesa mesaje.
Pentru mai multe informaţii, consultaţi subiectulCum se conectează un bean message-driven într-un cluster.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Boolean |
Întîrzierea (în secunde) între încercarea de conexiune la motorul de mesagerie şi oricare altă încercare de a stabili o conexiune mai bună, ambele pentru conexiunea iniţială.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | Număr întreg |
| Interval | 1 prin 2147483647 |
Numele aliasului de autentificare J2C folosit pentru autentificarea conexiunilor gestionate de componentă la magistrala de integrare servicii.
Un alias de autentificareJava Platform, Enterprise Edition (Java EE) Connector Architecture (JCA) specifică ID-ul utilizator şi parola utilizate pentru autentificarea creării unei noi conexiuni la furnizorul JMS.
Câmpurile proprietăţilor personalizate nume utilizator şi parolă trebuie lăsate nespecificate, dacă este folosit câmpul de alias autentificare. Proprietăţile alias de autentificare setate ca parte din implementarea aplicaţiei preced proprietăţile setate pe un obiect administrativ de specificaţie activare.
Numai aliasul de autentificare este scris într-un fişier într-o formă necriptată, chiar şi în scopul înregistrării în istoric a recuperării tranzacţiilor. Serviciul de securitate este folosit pentru a proteja numele de utilizator şi parola adevărate.
În timpul pornirii aplicaţiei, când specificaţia de activare este iniţializată ca parte a iniţializării punctului final, serverul foloseşte aliasul de autentificare pentru a extrage numele de utilizator şi parola reale de la securitate, apoi le setează pe instanţa specificaţiei de activare.
| Informaţii | Valoare |
|---|---|
| Necesare | Nu |
| Tipul datelor | listă derulantă |