TUTORIAL: Validate Action dla Web Services

TUTORIAL: Validate Action dla Web Services

Niniejszy tutorial jest pierwszym z serii planowanych tutoriali demonstrujących działanie Message Flow oraz zastosowania różnych komponentów i akcji w OSB. Kolejne tutoriale będą rozwinięciem podstawowej konfiguracji Message Flow przedstawionej w tutorialu Wirtualizacja Web Services na OSB 10gR3.

Jak już wiemy, Message Flow udostępnia grupę komponentów służących do zarządzania przepływem wiadomości pomiędzy Proxy Service, a Business Service. Na początek weźmiemy pod lupę prosty schemat przepływu oparty na komponentach Pipeline Pair Node i Stage. W tym celu zmodyfikujemy bazowy Message Flow, dodając na początek Pipeline Pair Node:

1) Klikamy na ConvertTemperature, a następnie wybieramy Add Pipeline Bar.

Otrzymujemy nowy komponent PipelinePairNode1, dzięki któremu od teraz mamy możliwość konfiguracji wiadomości wchodzących do i wychodzących z Business Service.

Następnym krokiem jest dodanie komponentu Stage dla Request Pipeline, ponieważ to właśnie dla tej części zademonstrujemy działanie akcji Validate, odpowiedzialnej (jak się można domyślić) za walidację wysyłanego żądania do Business Service.

1) Klikamy na Request Pipeline, a następnie z menu wybieramy Add Stage.
2) Otrzymujemy nowy komponent o nazwie stage1. 

3) Klikamy na stage1 w celu zmiany jego nazwy:

a) Wybieramy Edit Name and Comments i wpisujemy w polu Name, Validate Action. 
b) Klikamy Save.

W tym momencie mamy dodany komponent, w którym możemy definiować wszelkiego rodzaju akcje. W tym tutorialu zajmiemy się akcją walidacyjną wiadomości wysyłanej przez użytkownika.

1) Klikamy na Validate Action i wybieramy Edit Stage.
2) Klikamy na Add an Action.
3) Wybieramy Message Processing -> Validate.

Otrzymujemy edytor akcji Validate, który należy teraz skonfigurować.

1) Klikamy w XPath.

Zostajemy przekierowani do XPath Expression Editor, w którym możemy manipulować elementami zmiennych predefiniowanych. OSB automatycznie tworzy zmienne przechowujące konkretne elementy wiadomości. Aby zobaczyć strukturę zmiennych należy przejść do zakładki Variable Structures, a następnie z listy rozwijalnej wybrać odpowiednią strukturę. Na poniższym zdjęciu widać strukturę elementów zmiennej $body. 

a) W tutorialu zajmiemy się walidacją wszystkich elementów zmiennej $body dlatego też w pustym polu wpisujemy ./*

b) Klikamy na Validate. 
c) Klikamy na Save. 

2) Następnie w polu obok in variable wpisujemy body (bez znaku $). 
3) Klikamy w Resource.

a) Wybieramy WSDL ponieważ będziemy walidować naszą wiadomość w oparciu o WSDL. b) Wybieramy CovertTemperature_WSDL, a następnie CelsiusToFahrenheit i klikamy Submit.

W tym miejscu małe wyjaśnienie. Otóż wybraliśmy jeden element z WSDL o nazwie CelsiusToFahrenehit. Stąd walidacji będzie poddana tylko wiadomość wysłane przez operację CelsiusToFahrenheit. 

4) Zaznaczamy opcję Raise Error on validation failure. 

5) Klikamy Save. 

6) I raz jeszcze Save.
7) Aktywujemy sesję.

Konfiguracja najprostszej akcji Validate zakończona. Teraz możemy przetestować Proxy Service. Testując operację CelsiusToFahrenheit otrzymujemy poprawny wynik. Możemy również prześledzić w jaki sposób zostały wykonane poszczególne etapy Message Flow. Jeśli natomiast wywołamy operację FahrenheitToCelsius otrzymamy error - BEA-382505: OSB Validate action failed validation. 

Przyczyna jest prosta. Walidację należy przeprowadzić dla każdej operacji request lub zastosować komponent Branch Node – Operational Branch o czym w następnym tutorialu!