Ustawienia powiązań JMS dla kompozytów SCA.

Ta strona umożliwia wyświetlanie ustawień właściwości dla powiązania Java Message Service (JMS) łączącego odwołania lub usługi kompozytu Service Component Architecture (SCA). Za pomocą tej strony można również przeprowadzać edycję zasobów powiązania JMS. Ustawienia pokazywane na tej stronie służą do definiowania elementu binding.jms.

Aby można było wyświetlić tę stronę, dana jednostka kompozycji musi obsługiwać odwołanie albo usługę powiązania JMS. W Konsoli administracyjnej wykonaj następujące czynności:

Kliknij opcję Aplikacje > Typy aplikacji > Aplikacje na poziomie biznesowym > nazwa_aplikacji > nazwa_jednostki_kompozycji_wdrożonego_zasobu_aplikacyjnego.
Na stronie ustawień jednostki kompozycji dla kompozytów SCA wybierz opcję wyświetlenia odwołań lub usług:
- W przypadku odwołania komponentu SCA kliknij opcję Komponenty złożone SCA > nazwa_odwołania_komponentu_SCA > Odwołania komponentu SCA > nazwa_odwołania > Powiązania > Powiązanie JMS.
- W przypadku usługi komponentu SCA kliknij opcję Komponenty złożone SCA > nazwa_usługi_komponentu_SCA > Usługi komponentu SCA > nazwa_usługi > Powiązania > Powiązanie JMS.

Za pomocą powiązania JMS można identyfikować istniejące zasoby JMS przy użyciu nazw JNDI (Java Naming and Directory Interface).

(Właściwości ogólne (tylko do odczytu)
Zasoby
Zasoby odpowiedzi
Właściwości nagłówka żądania dla odwołania (tylko do odczytu)
Właściwości nagłówka odpowiedzi dla usługi (tylko do odczytu)

Właściwości ogólne

Służy do określania ustawień właściwości, które mają zastosowanie do wszystkich elementów binding.jms. Ustawienia dotyczą zarówno usług, jak i odwołań. Nie jest możliwa edycja ustawień.

Identyfikator URI powiązania JMS

Służy do określenia identyfikatora URI, który umożliwia identyfikowanie właściwości, takich jak miejsce docelowe, fabryka połączeń i specyfikacja aktywowania, używanych do wysyłania lub odbierania komunikatu JMS.

Identyfikator URI ma następujący format:

jms: miejsce_docelowe_jms?
connectionFactoryName=nazwa_fabryki_połączeń &
destinationType={queue|topic} &
deliveryMode=tryb_dostarczania &
timeToLive=czas_życia &
priority=priorytet &
właściwość_użytkownika=wartość_właściwości_użytkownika & ...

Schemat korelacji

Określa schemat korelacji używany podczas wysyłania odpowiedzi lub komunikatów zwrotnych.

Poprawne wartości to requestmsgidtocorrelid (wartość domyślna), requestcorrelidtocorrelid oraz none.

Fabryka kontekstów początkowych

Służy do określania nazwy fabryki kontekstów początkowych używanej do uzyskiwania kontekstu początkowego JNDI.

To ustawienie jest opcjonalne. Jeśli nie zostanie określona żadna fabryka, użyta zostaje początkowa fabryka kontekstu serwera WebSphere Application Server.

Adres URL JNDI

Służy do określania adresu URL (uniform resource locator) dla dostawcy JNDI.

Połączenie żądania

Służy do określania elementu binding.jms, który znajduje się w pliku definicji kompozytu.

Żądanie to komunikat wysyłany do usługi SCA lub wysyłany przez odwołanie SCA.

Połączenie odpowiedzi

Służy do określania elementu binding.jms, który znajduje się w pliku definicji kompozytu.

Odpowiedź to komunikat otrzymywany przez odwołanie (tzn. odpowiedź od wywołanej usługi) lub komunikat wysyłany przez usługę w odpowiedzi na wcześniejszy komunikat żądania. Odpowiedź w architekturze SCA zawsze jest odpowiedzią na wcześniejsze żądanie.

Format łącznika żądania

Służy do określania nazwy elementu definicji komponentu dla łącznika używanego do łączenia kompozytów SCA.

Na przykład: wireFormat.jmsObject.

Żądanie to komunikat wysyłany do usługi SCA lub wysyłany przez odwołanie SCA.

Format łącznika odpowiedzi

Służy do określania nazwy elementu definicji komponentu dla łącznika używanego do łączenia kompozytów SCA.

Na przykład: wireFormat.jmsObject.

Zasoby

Służy do określania zasobów dla powiązania JMS. Ustawienia zasobów Nazwa JNDI miejsca docelowego, Nazwa JNDI specyfikacji aktywowania i Nazwa JNDI fabryki połączeń można czytać i edytować. Wszystkie pozostałe ustawienia zasobów są tylko do odczytu.

Typ miejsca docelowego

Określa typ miejsca docelowego żądania. Dopuszczalne wartości: queue (wartość domyślna) i topic. W przypadku ustawienia topic wszystkie operacje w interfejsie, które odpowiadają powiązaniu, muszą być jednokierunkowe.

To ustawienie dotyczy zarówno usług, jak i odwołań, i jest tylko do odczytu.

@type to typ miejsca docelowego.

Nazwa JNDI miejsca docelowego

Służy do określania opcjonalnego parametru, który nadaje nazwę JNDI miejscu docelowemu, z którym jest połączone powiązanie. Na przykład: jms/InvokeService_Callback.

Nazwę miejsca docelowego można ustawić zarówno dla usług, jak i dla odwołań.

@name to nazwa JNDI miejsca docelowego.

Tworzenie miejsca docelowego

Określa, czy należy utworzyć miejsce docelowe dla powiązania.

Poprawne wartości to ifnotexist (wartość domyślna), always oraz never. W przypadku wartości ifnotexist produkt dynamicznie tworzy zasoby miejsca docelowego niezbędne dla kompozytu SCA, jeśli te wartości nie istnieją, oraz tworzy relację z domyślnym dostawcą przesyłania komunikatów. Produkt tworzy zasoby podczas dodawania kompozytu SCA do aplikacji na poziomie biznesowym.

Produkt sprawdza poprawność definicji kompozytu podczas dodawania zasobu SCA do aplikacji na poziomie biznesowym. Jeśli w wyniku sprawdzania poprawności zostanie wykryty błąd, produkt nie dodaje zasobu aplikacyjnego do aplikacji. Jeśli wartość to always i miejsce docelowe istnieje, wdrażanie jest przerywane ze względu na wystąpienie błędu.

Nazwa JNDI specyfikacji aktywowania

Służy do określania specyfikacji aktywowania, za pomocą której powiązanie łączy się z miejscem docelowym JMS w celu przetworzenia komunikatów żądań. Wartość musi być nazwą JNDI.

Specyfikację aktywowania można ustawić tylko dla usług.

Atrybuty tego elementu są zgodne z atrybutami zdefiniowanymi dla elementu miejsca docelowego.

Tworzenie specyfikacji aktywowania

Określa, czy dla powiązania należy utworzyć specyfikację aktywowania. Specyfikację aktywowania można utworzyć tylko dla usług.

Poprawne wartości to ifnotexist (wartość domyślna), always oraz never. W przypadku wartości ifnotexist produkt dynamicznie tworzy zasoby specyfikacji aktywowania niezbędne dla kompozytu SCA, jeśli te wartości nie istnieją, oraz tworzy relację z domyślnym dostawcą przesyłania komunikatów. Jeśli wartość to always i specyfikacja aktywowania istnieje podczas dodawania kompozytu SCA do aplikacji na poziomie biznesowym, wdrażanie jest przerywane ze względu na wystąpienie błędu.

Nazwa JNDI fabryki połączeń

Służy do określania fabryki połączeń, której powiązanie używa do przetwarzania komunikatów żądań. Wartość musi być nazwą JNDI.

Nazwę JNDI fabryki połączeń można ustawić tylko dla odwołań.

Atrybuty tej właściwości są zgodne z atrybutami zdefiniowanymi dla elementu miejsca docelowego. Ta właściwość i właściwość activationSpec wzajemnie się wykluczają.

Tworzenie fabryki połączeń

Określa, czy należy utworzyć fabrykę połączeń dla powiązania. Fabrykę połączeń można utworzyć tylko dla odwołań.

Poprawne wartości to ifnotexist (wartość domyślna), always oraz never. W przypadku wartości ifnotexist produkt dynamicznie tworzy zasoby fabryki połączeń niezbędne dla kompozytu SCA, jeśli te wartości nie istnieją, oraz tworzy relację z domyślnym dostawcą przesyłania komunikatów. Jeśli wartość to always i fabryka połączeń istnieje podczas dodawania kompozytu SCA do aplikacji na poziomie biznesowym, wdrażanie jest przerywane ze względu na wystąpienie błędu.

Zasoby odpowiedzi

Służy do określania zasobów odpowiedzi używanych do obsługiwania komunikatów odpowiedzi, odbierania odpowiedzi dla odwołania i wysyłania odpowiedzi z usługi. Element odpowiedzi służy do definiowania miejsca docelowego oraz elementu fabryki połączeń lub elementu specyfikacji aktywowania na potrzeby obsługiwania komunikatów odpowiedzi.

Zasoby odpowiedzi dotyczą zarówno usług, jak i odwołań. Ustawienia zasobów Nazwa JNDI miejsca docelowego odpowiedzi i Nazwa JNDI fabryki połączeń odpowiedzi można czytać i edytować. Wszystkie pozostałe ustawienia zasobów są tylko do odczytu.

Typ miejsca docelowego odpowiedzi

Służy do określania typu miejsca docelowego odpowiedzi. Dopuszczalne wartości: queue (wartość domyślna) i topic. W przypadku ustawienia topic wszystkie operacje w interfejsie, które odpowiadają powiązaniu, muszą być jednokierunkowe.

To ustawienie dotyczy zarówno usług, jak i odwołań, i jest tylko do odczytu.

Nazwa JNDI miejsca docelowego odpowiedzi

Służy do określania miejsca docelowego używanego do przetwarzania odpowiedzi przez to powiązanie. Atrybuty są takie same jak w przypadku nadrzędnego elementu miejsca docelowego. Na przykład: jms/InvokeService_Response.

Nazwę miejsca docelowego można ustawić zarówno dla usług, jak i dla odwołań.

Tworzenie miejsca docelowego odpowiedzi

Określa, czy należy utworzyć miejsce docelowe odpowiedzi dla powiązania.

Poprawne wartości to ifnotexist (wartość domyślna), always oraz never. W przypadku wartości ifnotexist produkt dynamicznie tworzy zasoby miejsca docelowego odpowiedzi niezbędne dla kompozytu SCA, jeśli te wartości nie istnieją, oraz tworzy relację z domyślnym dostawcą przesyłania komunikatów. Jeśli wartość to always i miejsce docelowe odpowiedzi istnieje podczas dodawania kompozytu SCA do aplikacji na poziomie biznesowym, wdrażanie jest przerywane ze względu na wystąpienie błędu.

Nazwa JNDI fabryki połączeń odpowiedzi

Służy do określania fabryki połączeń, której powiązanie używa do przetwarzania komunikatów odpowiedzi. Wartość musi być nazwą JNDI.

Fabrykę połączeń odpowiedzi można ustawić zarówno dla usług, jak i dla odwołań.

Atrybuty tego elementu są zgodne z atrybutami zdefiniowanymi dla elementu miejsca docelowego. Ten element oraz element activationSpec wzajemnie się wykluczają.

Tworzenie fabryki połączeń odpowiedzi

Określa, czy należy utworzyć fabrykę połączeń odpowiedzi, którą powiązanie może użyć do przetwarzania komunikatów odpowiedzi.

Poprawne wartości to ifnotexist (wartość domyślna), always oraz never. W przypadku wartości ifnotexist produkt dynamicznie tworzy zasoby fabryki połączeń odpowiedzi niezbędne dla kompozytu SCA, jeśli te wartości nie istnieją, oraz tworzy relację z domyślnym dostawcą przesyłania komunikatów. Jeśli wartość to always i fabryka połączeń odpowiedzi istnieje podczas dodawania kompozytu SCA do aplikacji na poziomie biznesowym, wdrażanie jest przerywane ze względu na wystąpienie błędu.

Właściwości nagłówka żądania

Służy do określania właściwości nagłówka JMS, które mają zastosowanie do żądań pochodzących z odwołania. Właściwości nagłówka nie można edytować.

Jeśli określono właściwość nagłówka JMS, właściwość nie może występować w identyfikatorze URI.

Typ JMS: Służy do określania typu JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSType.
Identyfikator korelacji JMS: Służy do określania identyfikatora korelacji JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSCorrelationID.
Tryb dostarczania JMS: Służy do określania trybu dostarczania JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSDeliveryMode.
Czas życia JMS: Służy do określania czasu życia JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSTimeToLive.
Priorytet JMS: Służy do określania priorytetu JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSPriority.
Właściwość nagłówka: Służy do określania wartości używanej dla wybranej właściwości użytkownika JMS.

Właściwości nagłówka odpowiedzi

Służy do określania właściwości nagłówka JMS, które mają zastosowanie do odpowiedzi pochodzących z usługi dla komunikatów wychodzących. Właściwości nagłówka nie można edytować.

Jeśli określono właściwość nagłówka JMS, właściwość nie może występować w identyfikatorze URI.

Typ JMS: Służy do określania typu JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSType.
Identyfikator korelacji JMS: Służy do określania identyfikatora korelacji JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSCorrelationID.
Tryb dostarczania JMS: Służy do określania trybu dostarczania JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSDeliveryMode.
Czas życia JMS: Służy do określania czasu życia JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSTimeToLive.
Priorytet JMS: Służy do określania priorytetu JMS używanego we właściwości nagłówka JMS za pomocą elementu @JMSPriority.
Właściwość nagłówka: Służy do określania wartości używanej dla wybranej właściwości użytkownika JMS.

Nazwa pliku: usca_jms_bindings.html