03/2014

         Przyklad wykorzystania uslug sieciowych SOA pakietu Trawers
         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 1. Uruchomienie serwera SOA
 2. Sprawdzenie funkcjonowania serwera SOA
 3. Przykladowe pytanie do serwera i odpowiedz
 4. Opis komunikacji

                              * * *

 1. Uruchomienie serwera SOA
 ---------------------------

    W AD/Trawers/Uslugi SOA/SOA Serwer internetowy
    Prosze wybrac port 7000, gdyz port 80 moze byc zajety przez dzialajacy
    na komputerze serwer www.
    Pole Adres IP mozna pozostawic puste.


 2. Sprawdzenie funkcjonowania serwera
 -------------------------------------

    Uruchomic przegladarke internetowa i wpisac adres komputera, na ktorym 
    uruchomiony jest Trawers.

    W wersji -W najczesciej jest to komputer przy ktorym pracuje uzytkownik.
    Mozna wiec posluzyc sie adresem localhost (127.0.0.1)
       http://127.0.0.1:7000/

   Poprawnym wynikiem jest wyswietlenie strony powitalnej serwera SOA Trawers.


 3. Przykladowe pytanie do serwera i odpowiedz
 ---------------------------------------------

    W katalogu \soa\ na plycie demo umieszczony jest przykladowy 
    skrypt dla Windows wysylajacy pytanie do serwera i prezentujacy odpowiedz
    w postaci strony w przegladarce internetowej.

    Skrypt:                tr-web.bat
    Katalog z zapytaniami: soa\zapytania\
    Katalog z wynikami:    soa\wyniki\

    Skrypt do poprawnego dzialania potrzebuje programow:
      - curl     ( http://curl.haxx.se/download.html )
      - xsltproc ( http://www.zlatkovic.com/libxml.en.html
                   http://xmlsoft.org/XSLT/xsltproc2.html  )

    Programy te powinny byc widoczne dla skryptu tr-web.bat.
    Nalezy umiescic je na sciezce PATH albo poprostu wgrac do katalogu
    z tr-web.bat

    Jako jedyny parametr wywolania tr-web.bat nalezy podac adres i port
    serwera uslug Trawers ( np. tr-web.bat 127.0.0.1:7000 )


 4. Opis komunikacji
 -------------------

   Do serwera uslug Trawers wysylane jest protokolem http polecenie POST.
   POST powinien miec w naglowku: "Content-Type: application/soap+xml"
   lub wpis: "SOAPAction: TrawersSOA"

   Serwer zwraca odpowiedz w postaci komunikatu SOAP.

   W zamieszczonym przykladzie do wyslania polecenia POST uzyto programu curl.

   W przypadku wyslania polecenia POST nie spelniajacego powyzszego warunku.
   Nie zostanie ono rozpoznane jako pytanie do serwera i zwrocona zostanie
   standardowa strona powitalna.

 5. Przyklady w jezyku PHP
 -------------------------

   W katalogu php/ znajduja sie przyklady wywolania funkcji SOA
   w języku PHP.


      * trsoa1.php - proste wywolania funkcji bez parametrow i z parametrami

      * trsoa2.php - wywolania z formularzami HTML + JavaScript + CSS

--- koniec ---