Usługi WWW JAX-RPC |
|
![]() |
Zbuduj przy użyciu narzędzia Ant | Przykłady usług WWW JAX-RPC |
Pierwsze kroki |
Poznawanie struktury katalogów budowanych przykładów |
Odbudowywanie i reinstalowanie pliku WebServicesSamples.ear |
Jedną z większych korzyści płynących z projektowania aplikacji na platformie
J2EE jest przenośność. Wszystkie przykładowe programy z galerii przykładów są tworzone na stacji roboczej i uruchamiane w systemach z/OS bez
konieczności modyfikowania ani jednego wiersza kodu Java. Poprzez budowanie aplikacji J2EE w
systemach Intel lub UNIX programista może wyeliminować problemy z konwersją
pliku ze standardu EBCDIC do standardu ASCII lub ze standardu ASCII do standardu EBCDIC.
Dostępność narzędzi ułatwia programistom pisanie i testowanie kodu
na programistycznej stacji roboczej oraz instalowanie plików Enterprise Archive (EAR)
w systemach z/OS.
Każdemu nabywcy serwera aplikacji WebSphere Application Server dla platformy z/OS
przysługuje prawo do korzystania z oprogramowania Application
Server Media for Multiplatforms. Jeśli produkt podstawowy (serwer WebSphere Application Server)
oraz przykłady instalowane są na jednej z platform obsługiwanych
przez ten pakiet, w każdej z nich widoczna będzie ta sama galeria. Jedynym
wyjątkiem jest sytuacja, gdy kliknięto opcję nazwa_przykładu > Budowanie za pomocą narzędzia Ant > platforma > Odbudowywanie i instalowanie pliku sample.ear - wtedy podawane
są instrukcje dotyczące odbudowywania pliku EAR na tej platformie. Ponieważ pliki tekstowe w
pliku EAR (XML, xmi, JSP itd.) muszą być
w formacie ASCII, łatwiej jest edytować te pliki na komputerze
ASCII. Dokonując zmian na komputerze ze standardem ASCII, można następnie zreinstalować wynikowy plik EAR na platformie z/OS bez potrzeby konwersji ze standardu EBCDIC do standardu ASCII.
Należy zainstalować serwer WebSphere Application Server na wybranej rozproszonej platformie i wskazać, że zainstalowane mają zostać również przykładowe aplikacje serwera aplikacji.
Przed próbą modyfikacji lub odbudowania przykładów należy utworzyć kopię zapasową katalogu <katalog_główny_profilu>/samples/src/WebServicesSamples.
Przykłady są zainstalowane w następujących katalogach:
<katalog_główny_profilu>/samples/src/WebServicesSamples | Zawiera kod źródłowy przykładów AddressBook oraz Stock Quote. |
<katalog_główny_profilu>/samples/lib/WebServicesSamples | Zawiera pliki WAR (Web archive) i JAR (Java archive) oraz końcowy plik WebServicesSamples.ear dla przykładów. Ten katalog jest tworzony po odbudowaniu przykładu. |
<katalog_główny_profilu>/samples/javadoc/WebServicesSamples | Zawiera dokumentację Javadoc przykładów. Ten katalog jest tworzony po odbudowaniu przykładu. |
<katalog_główny_profilu>/samples/bld/WebServicesSamples | Zawiera wygenerowane pliki klas. Są one używane do wygenerowania końcowego pliku WebServicesSamples.ear. Ten katalog jest tworzony po odbudowaniu przykładu. |
Plik EAR (Enterprise Archive) przykładów usług WWW JAX-RPC jest udostępniany po zainstalowaniu serwera WebSphere Application Server. Nie jest konieczne budowanie przykładów przed ich użyciem. Poniższe wskazówki
opisują kroki odbudowywania przykładów. Zawarto w nich także dodatkowe informacje dotyczące modyfikacji.
Wykonywanie skryptu budowania przykładów |
Usuwanie i reinstalowanie pliku WebServicesSamples.ear |
W celu odbudowania przykładu sprawdź, czy katalog <katalog_główny_profilu>/bin znajduje się w zmiennej środowiskowej PATH. Aby uruchomić skrypt budowania przykładu, który odbuduje przykład, wykonaj następujące kroki:
Przykład zostanie zbudowany.
Skrypty buildWebServicesSamples.bat oraz buildWebServicesSamples.sh znajdujące się w katalogu <katalog_główny_profilu>/samples/bin/WebServicesSamples ustawiają odpowiednie informacje ścieżki klasy i uruchamiają program narzędziowy budowania Ant. Narzędzie Ant odczytuje pliki build.xml, które opisują sposób budowania przykładu. Dodatkową dokumentację programu Ant można znaleźć w serwisie WWW projektu Jakarta.
Plik binarny EAR należy przekazać do serwera z/OS przy użyciu protokołu FTP, wykonując poniższe instrukcje.
Przykład usług WWW JAX-RPC jest instalowany domyślnie w katalogu <katalog_główny_profilu>/installedApps/<nazwa_komórki>, gdzie <nazwa_komórki> to nazwa komórki, w której zainstalowano aplikację.
Reinstalowanie przykładu polega na wykonaniu następujących kroków:
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('WebServicesSamples')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('WebServicesSamples')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('WebServicesSamples')"
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('WebServicesSamples')"
wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>', '-deployejb' ] )"gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>', '-deployejb' ] )"gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>', '-deployejb' ] )"gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>', '-deployejb' ] )"gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
Przykładowa aplikacja usług WWW JAX-RPC została odbudowana i ponownie zainstalowana. Można teraz konfigurować i uruchamiać klienty przykładów Address Book i Stock Quote.