Usługi WWW Jax-WS |
|
![]() |
Budowanie za pomocą narzędzia Ant | Przykłady usług WWW JAX-WS |
Pierwsze kroki |
Poznawanie struktury katalogów budowanych przykładów |
Odbudowywanie i reinstalowanie pliku JaxWSServicesSamples.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. Budując aplikacje J2EE na platformie
Intel lub w systemach operacyjnych takich jak AIX i Linux, programista może
uniknąć problemów z konwersją plików między formatami EBCDIC i ASCII lub ASCII i 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 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 zostaną zainstalowane na jednej z platform obsługiwanych
przez ten pakiet, w każdej z nich będzie widoczna ta sama galeria. Istnieje jednak pewna różnica. Kliknięcie opcji nazwa_przykładu> Zbuduj przy użyciu narzędzia Ant > platforma > Odbudowywanie i instalowanie pliku powoduje, że wyświetlane instrukcje odbudowywania pliku EAR są specyficzne dla używanej platformy.
Ponieważ pliki tekstowe w pliku EAR, takie jak pliki XML, xmi lub JSP,
muszą być w formacie ASCII, łatwiej jest edytować te pliki na komputerze używającym standardu
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.
Podczas instalowania serwera WebSphere Application Server na wybranej platformie rozproszonej należy wybrać opcję instalowania aplikacji przykładowych. W panelu Instalowanie aplikacji przykładowych należy zaznaczyć pole wyboru Instaluj aplikacje przykładowe.
Należy utworzyć kopię zapasową katalogu <katalog_główny_profilu>/samples/src/JaxWSServicesSamples przed próbą zmodyfikowania lub ponownego zbudowania przykładów.
Przykłady są zainstalowane w następujących katalogach:
<katalog_główny_profilu>/samples/src/JaxWSServicesSamples | Zawiera kod źródłowy przykładów Ping, Echo oraz MTOM. |
<katalog_główny_profilu>/samples/lib/JaxWSServicesSamples | Zawiera pliki WAR (Web archive) i JAR (Java archive) oraz końcowy plik JaxWSServicesSamples.ear dla przykładów. Ten katalog jest tworzony po odbudowaniu przykładu. |
<katalog_główny_profilu>/samples/javadoc/JaxWSServicesSamples | Zawiera dokumentację Javadoc przykładów. Ten katalog jest tworzony po odbudowaniu przykładu. |
<katalog_główny_profilu>/samples/bld/JaxWSServicesSamples | Zawiera wygenerowane pliki klas. Są one używane do generowania końcowego pliku JaxWSServicesSamples.ear. Ten katalog jest tworzony po odbudowaniu przykładu. |
Plik EAR (Enterprise Archive) przykładów usług WWW JAX-WS jest dostępny 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 JaxWSServicesSamples.ear |
Aby odbudować plik EAR przykładów usług WWW JAX-WS, wykonaj następujące kroki:
Przykład zostanie zbudowany.
Skrypty buildJaxWSSamples znajdują się w katalogu <katalog_główny_profilu>/bin. Skrypty ustawiają odpowiednie informacje ścieżki klasy i uruchamiają budujący program narzędziowy Ant. Program narzędziowy Ant odczytuje pliki build.xml, które opisują sposób budowania przykładów. Dodatkową dokumentację dotyczącą programu narzędziowego Ant można znaleźć w serwisie WWW projektu Apache Ant.
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-WS 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('JaxWSServicesSamples')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')"
wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')"
wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')"
wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear', ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>' ] )"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('JaxWSServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>' ] )"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('JaxWSServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>' ] )"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('JaxWSServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>' ] )"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-WS została odbudowana i ponownie zainstalowana. Można teraz skonfigurować i uruchomić przykładowe klienty usług Ping, Echo i MTOM.