TUTORIAL: Wirtualizacja Web Services na OSB 10gR3

TUTORIAL: Wirtualizacja Web Services na OSB 10gR3

Na początek, przedstawmy krótki wstęp teoretyczny dotyczący działania zwirtualizowanej usługi sieciowej na szynie Oracle Service Bus 10.3.

Po lewej stronie znajduje się klient (Service consumer) naszej zwirtualizowanej usługi sieciowej. Jego żądania są wysyłane do Proxy na szynie, która komunikuje się wewnątrz szyny z Business Service (ta z kolei komunikuje się z zewnętrzną usługą sieciową), definiującej całą logikę działania usługi sieciowej. Należy zapamiętać, że najważniejszymi pojęciami OSB są Proxy i Business Service.

Proces konfiguracji OSB można podzielić na 3 główne etapy:

1) Stworzenie projektu i import zasobów

2) Konfiguracja Business Service

3) Konfiguracja Proxy 

Usługa sieciowa, którą będziemy wirtualizować to przykładowa usługa z W3C zamieniająca temperaturę ze stopni Celsjusza na Fahrenheita i na odwrót, której opis WSDL znajduje się pod adresem: http://www.w3schools.com/webservices/tempconvert.asmx?WSDL.

Ważnym aspektem działania szyny OSB są sesje, dzięki którym możemy dokonywać zmian. Aby wprowadzić jakieś zmiany konfiguracyjne należy stworzyć nową sesję, a po wykonaniu wszystkich czynności aktywować ją. Istnieje również możliwość cofnięcia sesji, co bardzo ułatwia anulowanie wprowadzonych zmian.

PROJEKT I IMPORT ZASOBÓW

Na początku działań z OSB należy stworzyć dla każdego projektu pewną strukturę katalogów. W tym celu wybieramy zakładkę Project Explorer, aktywujemy nową sesję i dodajemy katalog. Głównym katalogiem będzie nazwa naszego projektu WebServiceTemp. 

Następnie przechodzimy do utworzonego katalogu i w nim tworzymy trzy inne: BusinessServices, ProxyServices i Resources. Aktywujemy sesję podając dodatkowo jej opis, aby łatwiej rozpoznać poszczególne etapy.

Drugim krokiem jest import URL pliku WSDL opisującego usługę przeznaczoną do wirtualizacji do katalogu Resources. W naszym wypadku jest to link http://www.w3schools.com/webservices/tempconvert.asmx?WSDL

Dalej przeprowadzamy krótką konfigurację.

Klikamy Next , a następnie Import i aktywujemy sesję.

KONFIGURACJA BUSINESS SERVICE

Business Service definiuje interfejs i informacje o połączeniu do endpoint’a czyli zdalnej usługi na serwerze. Pełną konfigurację przeprowadzamy z poziomu katalogu BusinessServices, gdzie ustalamy m. in. nazwę usługi oraz jej opis, ścieżkę do wcześniej zaimportowanego pliku WSDL, operacje usługi oraz inne opcje związane z protokołem SOAP, zabezpieczeniem i monitoringiem usługi. Na tym etapie istnieje również możliwość testowana usługi.

Konfiguracji Business Service:

Przechodzimy do katalogu Business Service i aktywujemy sesję. Z listy rozwijalnej Create Resource wybieramy Business Service i przeprowadzamy konfigurację: wpisujemy nazwę usługi, opcjonalnie opis i wybieramy WSDL z katalogu Resources.

W tym miejscu zakładam, że czytelnik posiada wiedzę dotyczącą WSDL i Web Service. Wybieramy Port TempConvertSoap i klikamy w Submit.

Następnie możemy kliknąć w Last aby przejść do ostatniej strony i zapisać Business Service lub klikać Next i przejrzeć/ustawić dodatkowe opcje dla Business Service. W naszym przypadku zostawiamy wszystkie opcje na poziomie domyślnym i zapisujemy usługę.

Aktywujemy sesję. 

W tym momencie mamy już skonfigurowany Business Service. OSB udostępnia możliwość przetestowania endpointa. W tym celu należy kliknąć w ikonkę przypominającą zielonego robaczka, która znajduje się po prawej stronie CovertTemperature_BusinessService. Test przeprowadzamy bez konieczności tworzenia sesji.

Jak widać OSB udostępnia mnóstwo opcji związanych z usługami sieciowymi. Możemy przetestować naszą usługę.

KONFIGURACJA PROXY

Przechodzimy do katalogu ProxyServices i aktywujemy sesję. Z listy rozwijalnej Create Resource wybieramy Proxy Service.

Przeprowadzamy konfigurację Proxy.

Pomijamy dodatkowe opcje konfiguracji i klikamy Last, a następnie Save.

Następnie klikamy w ikonkę Edit Message Flow.

Znajdujemy się w ekranie konfiguracji przepływu wiadomości, co tak naprawdę jest punktem centralnym naszej zwirtualizacji usługi sieciowej. Na tym etapie dokonamy podstawowej konfiguracji Proxy. 

Klikamy na ikonkę koperty ConvertTemperature i z listy wybieramy Add Route. Klikamy teraz w RouteNode1 i wybieramy Edit Name and Comments. Wpisujemy przyjazną nazwę np. RouteTo_ConvertTemperature_BusinessService – wiadomo o co chodzi.

Klikamy teraz w RouteTo_ConvertTemperature_BusinessService i wybieramy Edit Route.

Klikamy w Add an Action->Communication->Routing.

Klikamy w Service* i wybieramy CovertTemperature_BusinessService, a następnie w Submit. Zaznaczamy pole Use inbound operation for outbound, klikamy w Save All i aktywujemy sesję.

Stworzyliśmy kompletne Proxy, które rutuje wiadomości do Business Service i realizuje całą logikę przepływu informacji typu Request/Response. 

Nasza usługa jest od teraz dostępna pod nowym adresem: http://localhost:7021/WebServiceTemp/ProxyServices/ConvertTemperature?WSDL. 

Powyższy tutorial przedstawia podstawową konfigurację Proxy w OSB. Następny tutorial przybliży Czytelnikowi zaawansowane możliwości przepływu informacji jak np. walidacja i obsługa błędów.