Komendy Ping i Echo - noty techniczne

Pierwsze kroki
Znajdowanie kodu źródłowego
Przeglądanie uwag dotyczących kodu

Pierwsze kroki

Więcej informacji o usługach WWW interfejsu Java API opartych na języku XML (JAX-WS) zawiera dokumentacja usług WWW w bibliotece Centrum informacyjnego serwera WebSphere Application Server.

Przykład usług WWW JAX-WS Ping i Echo przedstawia proste wzorce wymiany komunikatów (MEP, message exchange pattern), używające synchronicznego i asynchronicznego modelu programowania. Przykład obsługuje protokoły SOAP 1.1 i SOAP 1.2 oraz obejmuje takie standardy usług WWW jak adresowanie (WS-Addressing, WS-A), niezawodne przesyłanie komunikatów (WS-Reliable Messaging, WS-RM) oraz zabezpieczona konwersacja (WS-Secure Conversation, WS-SC). Posiłkując się tym przykładem usługi WWW, można wykonać wiele różnorodnych testów współdziałania. Przykład ilustruje sposób użycia statycznych punktów końcowych usługi JAX-WS, a także klientów opartych na modelu rozsyłania i na modelu proxy.

Znajdowanie kodu źródłowego

Kod źródłowy klientów usług Ping i Echo znajduje się w podkatalogach katalogu katalog_główny_profilu/samples/src/JaxWSServicesSamples. Podkatalog SampleClientSei/src zawiera kod źródłowy następujących przykładowych klientów:

W systemach operacyjnych z/OS: Drzewo kodu źródłowego przykładów usług JAX-WS nie jest udostępniane w systemie operacyjnym z/OS, ponieważ przykładowe aplikacje nie są budowane w systemie operacyjnym z/OS.

Przeglądanie uwag dotyczących kodu

Jednokierunkowe wywołanie usługi Ping
Dwukierunkowe synchroniczne wywołanie usługi Echo
Dwukierunkowe asynchroniczne wywołanie usługi Echo

W poniższej sekcji przedstawiono wzorce wymiany komunikatów w przykładowych aplikacjach.

Żądanie jednokierunkowe: Ping

Scenariusz żądania jednokierunkowego przedstawia wzorzec jednokierunkowej wymiany komunikatów polegający na wysłaniu komunikatu aplikacji ping z klienta do usługi.

Dwukierunkowe żądanie i odpowiedź: wywołanie synchroniczne Echo

Scenariusz dwukierunkowego żądania i odpowiedzi przedstawia wzorzec dwukierunkowej wymiany komunikatów, w którym komunikat aplikacji jest wysyłany z klienta do usługi, a w odpowiedzi usługa zwraca z serwera do klienta łańcuch echo w tym samym kanale żądania i odpowiedzi.

Dwukierunkowe żądanie i odpowiedź: wywołanie asynchroniczne Echo z komunikacją synchroniczną

Scenariusz dwukierunkowego asynchronicznego żądania i odpowiedzi przedstawia wzorzec dwukierunkowej wymiany komunikatów, w którym klient wysyła do usługi komunikat w postaci łańcucha echo i oczekuje w odpowiedzi łańcucha echo wysłanego z serwera w tym samym kanale żądania i odpowiedzi. Ten wzorzec wymiany komunikatów jest podobny do przykładu synchronicznego wywołania usługi Echo, ale używa asynchronicznego modelu programowania usług JAX-WS. W tym scenariuszu po wysłaniu żądania aplikacja może kontynuować wykonywanie innych operacji. Odebranie odpowiedzi powoduje przejście do procedury obsługi wywołania zwrotnego, która przetwarza odpowiedź. Na poziomie nośnika ten przykład nie różni się niczym od przykładu synchronicznego wywołania usługi Echo.

Dwukierunkowe żądanie i odpowiedź: wywołanie asynchroniczne Echo z komunikacją asynchroniczną

Scenariusz dwukierunkowego asynchronicznego żądania i odpowiedzi z komunikacją asynchroniczną przedstawia wzorzec dwukierunkowej wymiany komunikatów, w którym komunikat w postaci łańcucha echo jest wysyłany z klienta do usługi. Klient oczekuje w odpowiedzi łańcucha echo z serwera, wysłanego w innym kanale żądania i odpowiedzi. Ten przykład implementuje asynchroniczny model programowania usług JAX-WS. W tym scenariuszu po wysłaniu żądania aplikacja kliencka może kontynuować wykonywanie innych operacji. Odebranie odpowiedzi powoduje przejście do procedury obsługi wywołania zwrotnego, która przetwarza odpowiedź. Klient nasłuchuje komunikatów odpowiedzi z serwera na innym kanale niż ten, na którym serwer zainicjował komunikację.