Specyfikacja aktywowania JMS jest powiązana z jednym lub większą liczbą komponentów bean sterowanych przez komunikaty i udostępnia konfigurację niezbędną do odbierania komunikatów.
Specyfikacja aktywowania JMS jest tworzona, jeśli komponent bean sterowany komunikatami ma komunikować się z domyślnym dostawcą przesyłania komunikatów przy użyciu architektury Java EE Connector Architecture (JCA) 1.5. Architektura JCA pozwala nawiązywać połączenia Java między serwerami aplikacji, takimi jak produkt WebSphere Application Server, a systemami informacyjnymi przedsiębiorstwa. Udostępnia to standaryzowaną metodę integrowania dostawców JMS z serwerami aplikacji Java EE i środowisko do wymiany danych z systemami korporacyjnymi, w których dane są przesyłane w formie komunikatów.
Poza właściwościami Nazwa, Nazwa JNDI, Nazwa JNDI miejsca docelowego i Alias uwierzytelniania, wszystkie właściwości konfiguracji specyfikacji aktywowania są przesłaniane przez odpowiednio nazwane właściwości konfiguracji aktywowania w deskryptorze wdrażania powiązanego komponentu bean sterowanego komunikatami EJB 2.1 lub nowszego. W przypadku komponentu bean sterowanego komunikatami EJB 2.0 właściwości Typ miejsca docelowego, Trwałość subskrypcji, Tryb potwierdzania i Selektor komunikatów są przesłaniane przez odpowiednie elementy podane w deskryptorze wdrażania. W przypadku każdego typu komponentu bean właściwość Nazwa JNDI miejsca docelowego może zostać przesłonięta przez wartość określoną w powiązaniach komponentu bean sterowanego komunikatami.
Właściwości specyfikacji aktywowania wpływają na to, w jaki sposób domyślny dostawca funkcji przesyłania komunikatów wybiera mechanizm przesyłania komunikatów, z którym łączy się aplikacja komponentu bean sterowanego komunikatami. Domyślnie środowisko automatycznie nawiązuje połączenie między aplikacjami i mechanizmem przesyłania komunikatów dostępnym na magistrali. Istnieje jednak możliwość określenia dodatkowych szczegółów konfiguracji, które mają wpływ na proces połączenia, na przykład w celu zidentyfikowania specjalnych serwerów startowych, ograniczenia połączenia tylko do podgrupy dostępnych mechanizmów przesyłania komunikatów, zwiększenia dostępności lub wydajności albo zapewnienia sekwencyjnego przetwarzania odbieranych komunikatów. Aby dowiedzieć się dlaczego i w jaki sposób te operacje są wykonywane, należy zapoznać się z tematem W jaki sposób aplikacje JMS łączą się z mechanizmem przesyłania komunikatów na magistrali (tryb z połączeniem).
Odsyłacze oznaczone tekstem (tryb z połączeniem) wymagają dostępu do Internetu. Każdy odsyłacz uruchamia wyszukiwanie tematu w elektronicznym Centrum informacyjnym. Po wyświetleniu wyników wyszukiwania należy wybrać temat najbardziej odpowiadający konfiguracji użytkownika.
Sprawdź, czy istnieją aktualizacje dla tego tematu (tryb z połączeniem)
Na karcie Konfiguracja wyświetlane są właściwości konfiguracyjne dla tego obiektu. Wartości tych właściwości są zachowywane nawet wtedy, gdy środowisko wykonawcze zostanie zatrzymane i zrestartowane. Informacje na temat stosowania zmian konfiguracyjnych do środowiska wykonawczego można znaleźć w opisach czynności Centrum informacyjnego.
Określa najwyższy poziom w topologii, na którym serwery aplikacji mogą używać tego obiektu zasobu.
Wymagane | Nie |
Typ danych | Tekst |
Określa dostawcę JMS, który umożliwia asynchroniczne przesyłanie komunikatów oparte na usłudze JMS (Java Message Service). Udostępnia fabryki połączeń J2EE na potrzeby tworzenia połączeń dla konkretnych miejsc docelowych kolejki lub tematu JMS. Obiekty administracyjne dostawcy JMS są używane do zarządzania zasobami JMS dla powiązanego dostawcy JMS.
Wymagane | Nie |
Typ danych | Tekst |
Nazwa JNDI zasobu
Wymagane | Tak |
Typ danych | Tekst |
Określa, czy dany komponent bean sterowany komunikatami używa miejsca docelowego tematu lub kolejki.
Wymagane | Tak |
Typ danych | lista rozwijana |
Zakres |
|
Nazwa JNDI miejsca docelowego.
Wybierz typ miejsca docelowego we właściwości Typ miejsca docelowego.
Wymagane | Tak |
Typ danych | Tekst |
Selektor komunikatów JMS używany do określania, które komunikaty są odbierane przez komponent bean sterowany komunikatami. Wartość ta jest łańcuchem używanym w celu wybrania podzbioru dostępnych komunikatów. Składnia jest oparta na podzbiorze składni wyrażenia warunkowego języka SQL 92 zgodnie z opisem w specyfikacji usługi JMS. Więcej informacji można znaleźć w Centrum informacyjnym.
TypJMS='samochód' AND kolor='niebieski' AND waga>2500
Łańcuch selektora może odwoływać się do pól w nagłówku komunikatu JMS i pól we właściwościach komunikatu. Selektory komunikatów nie mogą odwoływać się do wartości treści komunikatu.
Wartość NULL (pusty łańcuch) oznacza, że dla konsumenta komunikatów nie ma żadnego selektora komunikatów.
Wymagane | Nie |
Typ danych | Tekst |
Nazwa magistrali, z którą ma zostać nawiązane połączenie.
Wymagane | Nie |
Typ danych | Niestandardowe |
Sposób potwierdzania odbieranych komunikatów przez sesję.
Potwierdzenie jest wysyłane po usunięciu komunikatu.
Komunikat zostanie usunięty po uruchomieniu komponentu bean, jeśli jakość usługi jest ustawiona na wartość Możliwie optymalny nietrwały. W przypadku wszystkich innych wartości jakości usługi komunikat zostaje usunięty po zakończeniu działania przez komponent bean.
Wymagane | Nie |
Typ danych | lista rozwijana |
Zakres |
|
Nazwa elementu docelowego, która identyfikuje grupę mechanizmów przesyłania komunikatów. Określ typ elementu docelowego przy użyciu właściwości Typ elementu docelowego.
Wymagane | Nie |
Typ danych | Tekst |
Typ elementu docelowego, który określono we właściwości Element docelowy.
Wymagane | Nie |
Typ danych | lista rozwijana |
Zakres |
|
Ta właściwość określa znaczenie grupy docelowej.
Wymagane | Nie |
Typ danych | lista rozwijana |
Zakres |
|
Nazwa łańcucha transportowego danych przychodzących, który ma być używany przez aplikację jako docelowy podczas nawiązywania połączenia z mechanizmem przesyłania komunikatów znajdującym się w innym procesie niż aplikacja. W przypadku wybrania mechanizmu przesyłania komunikatów w innym procesie połączenie można nawiązać tylko wtedy, gdy mechanizm przesyłania komunikatów znajduje się na serwerze, na którym działa określony łańcuch transportowy danych przychodzących. Więcej informacji można znaleźć w Centrum informacyjnym.
Jeśli wybrany mechanizm przesyłania komunikatów znajduje się na tym samym serwerze co aplikacja, tworzone jest bezpośrednie połączenie wewnątrzprocesowe, a ta właściwość łańcucha transportowego jest ignorowana.
Wymagane | Nie |
Typ danych | Tekst |
Wprowadź listę rozdzielonych przecinkami punktów końcowych w postaci trójek o składni hostName:portNumber:chainName, które służą do łączenia się z serwerem startowym. Na przykład: Merlin:7276:BootstrapBasicMessaging,Gandalf:5557:BootstrapSecureMessaging.
Jeśli nazwa hosta nie zostanie określona, przyjmowana jest wartość domyślna localhost.
Jeśli numer portu nie zostanie określony, przyjmowana jest wartość domyślna 7276.
Jeśli protokół nie zostanie określony, jako wartość domyślna przyjmowany jest predefiniowany łańcuch, taki jak BootstrapBasicMessaging.
Wymagane | Nie |
Typ danych | Obszar tekstowy |
Maksymalna liczba komunikatów otrzymywanych z mechanizmu przesyłania komunikatów w pojedynczej partii.
Wymagane | Nie |
Typ danych | Integer |
Zakres | Od 1 do 2147483647 |
Maksymalna liczba punktów końcowych, do których komunikaty są dostarczane współbieżnie.
Wymagane | Nie |
Typ danych | Integer |
Zakres | Od 1 do 2147483647 |
Te parametry umożliwiają automatyczne zatrzymanie punktu końcowego po osiągnięciu określonego limitu przez liczbę kolejnych komunikatów, których przetworzenie zakończyło się niepowodzeniem. Pozwala to odróżnić komunikaty, których przesłanie zakończyło się niepowodzeniem z powodu problemów związanych z samymi komunikatami, od problemów z zasobami systemu powodującymi wiele sekwencyjnych niepowodzeń przetwarzania komunikatów.
Po automatycznym zatrzymaniu punktu końcowego jego status na panelu Konsoli administracyjnej zmieni się na czerwony. Należy go zrestartować ręcznie, klikając przycisk Wznów.
Po zrestartowaniu punktu końcowego podejmowana jest próba przetworzenia wszystkich komunikatów, których przetworzenie nie powiodło się, co spowodowało zatrzymanie punktu końcowego. Jeśli ich przetworzenie nadal kończy się niepowodzeniem, przenoszone są do miejsca docelowego wyjątków, jeśli jest skonfigurowane.
Włącz automatyczne zatrzymywanie punktu końcowego w oparciu o poniższe parametry.
Wymagane | Nie |
Typ danych | Pole wyboru |
Punkt końcowy zostanie zatrzymywany, gdy liczba sekwencyjnych awarii komunikatów osiągnie skonfigurowany limit. Ze względu na współbieżność komponentów MDB faktyczna liczba przetworzonych komunikatów może przekraczać tę wartość.
Ta właściwość nie jest włączona, jeśli nie włączono właściwości Automatycznie zatrzymuj punkty końcowe w razie powtarzających się awarii komunikatów.
Wymagane | Nie |
Typ danych | Integer |
Każdy komunikat, który nie został przetworzony przez komponent MDB, ale który nie osiągnął jeszcze maksymalnego limitu niepowodzeń dostarczania, będzie ponawiany dopiero po upływie tego czasu. W tym czasie mogą być podejmowane próby dostarczenia innych komunikatów, o ile próg maksymalnej liczby sekwencyjnych awarii oraz poziom maksymalnej współbieżności nie zostały ustawione na 1.
Ustawienie opóźnienia dla prób ponowienia komunikatów zakończonych niepowodzeniem zmniejsza liczbę komunikatów przenoszonych niepotrzebnie do miejsca docelowego wyjątków przed zatrzymaniem komponentu bean sterowanego komunikatami. Aby zminimalizować liczbę przenoszonych komunikatów, opóźnienie powinno być większe niż oczekiwany odstęp czasu między komunikatami odbieranymi w miejscu docelowym.
Ta właściwość nie jest włączona, jeśli nie włączono właściwości Automatycznie zatrzymuj punkty końcowe w razie powtarzających się awarii komunikatów.
Wymagane | Nie |
Typ danych | Integer |
Zakres | Czas w milisekundach. Wartość 0 oznacza brak opóźnienia między ponownymi próbami. |
Określa, czy subskrypcja tematu JMS jest trwała czy nietrwała.
Wymagane | Nie |
Typ danych | lista rozwijana |
Zakres |
|
Nazwa subskrypcji wymagana w przypadku trwałych subskrypcji tematów. To pole jest wymagane w przypadku używania trwałej subskrypcji tematu.
Nazwa tej subskrypcji musi być unikalna dla określonego identyfikatora klienta.
Wymagane | Nie |
Typ danych | Tekst |
Identyfikator klienta JMS wymagany w przypadku trwałych subskrypcji tematów dla wszystkich połączeń utworzonych przy użyciu tej specyfikacji aktywowania.
Wymagane | Nie |
Typ danych | Tekst |
Nazwa mechanizmu przesyłania komunikatów używanego w celu przechowywania komunikatów dostarczanych do trwałych subskrypcji na potrzeby obiektów utworzonych z poziomu tej specyfikacji aktywowania JMS. To pole jest wymagane w przypadku używania trwałej subskrypcji tematu.
Wymagane | Nie |
Typ danych | Tekst |
Gdy opcja ta jest włączona, dane komunikatów obiektowych otrzymywanych za pośrednictwem tej specyfikacji aktywacji będą przez system przekształcane do postaci szeregowej tylko wtedy, gdy będzie to absolutnie konieczne. Aplikacje muszą traktować dane pobrane z tych komunikatów jako dostępne tylko do odczytu.
Wymagane | Nie |
Typ danych | Pole wyboru |
Gdy opcja ta jest włączona, dane komunikatów obiektowych/bajtowych przekazywanych za pośrednictwem tej specyfikacji aktywacji, których ładunki zostaną zmodyfikowane, nie będą kopiowane po ustawieniu w komunikacie, a system będzie je przekształcać do postaci szeregowej tylko wtedy, gdy będzie to absolutnie konieczne. Aplikacjom wysyłającym takie komunikaty nie wolno modyfikować danych po ich ustawieniu w komunikacie.
Wymagane | Nie |
Typ danych | Pole wyboru |
Odczyt z wyprzedzeniem to mechanizm optymalizacji, który pozwala przypisywać komunikaty do konsumentów z odpowiednim wyprzedzeniem. Dzięki temu czas realizacji żądań konsumenta jest krótszy.
Komunikaty przypisywane do konsumenta są blokowane na serwerze i nie mogą być używane przez innych konsumentów w ramach danego miejsca docelowego. Przypisane do konsumenta komunikaty, które nie zostały użyte przed jego zamknięciem, są kolejno odblokowywane na serwerze i udostępniane do odbioru przez innych konsumentów.
Tę właściwość można nadpisać w wybranych miejscach docelowych JMS, ustawiając właściwość Odczyt z wyprzedzeniem poszczególnych miejsc docelowych JMS.
Wymagane | Nie |
Typ danych | lista rozwijana |
Zakres |
|
Tej właściwości używa się tylko wtedy, gdy aplikacja MDB działa na serwerze, który jest elementem magistrali będącej miejscem docelowym dla aplikacji. Nie występują żadne działania, jeśli aplikacja MDB działa na serwerze, który nie jest elementem docelowej magistrali.
Jeśli aplikacja MDB działa na serwerze, który jest elementem docelowej magistrali, włączenie tej opcji pozwala aplikacji MDB na przetwarzanie komunikatów bez względu na to, czy serwer udostępnia również działający mechanizm przesyłania komunikatów. Jeśli ta opcja nie jest włączona, wówczas komunikaty nie są przetwarzane przez aplikacje MDB działające na serwerach, które nie mają uruchomionego lokalnego mechanizmu przesyłania komunikatów.
Więcej
informacji znajduje się w temacie
W
jaki sposób komponent bean sterowany komunikatami łączy się w klastrze (tryb z połączeniem).
Wymagane | Nie |
Typ danych | Pole wyboru |
Alias uwierzytelniania J2C używany w celu zarządzanego na poziomie komponentu uwierzytelniania połączeń z magistralą integracji usług.
Alias uwierzytelniania architektury konektora JCA (Java Platform, Enterprise Edition - Java EE - Connector Architecture, JCA) określa identyfikator użytkownika i hasło używane do uwierzytelniania tworzenia nowego połączenia z dostawcą JMS.
Wymagane | Nie |
Typ danych | lista rozwijana |