Uwagi do wydania narzędzi usług Web Service

© Copyright International Business Machines Corporation 2006. Wszelkie prawa zastrzeżone. Ograniczone prawa na rzecz rządu Stanów Zjednoczonych - używanie produktów, tworzenie ich duplikatów oraz ujawnianie informacji o nich podlega zastrzeżeniom zawartym w umowie GSA ADP Schedule zawartej z firmą IBM® Corp.

Uwagi do wydania

1.0 Ograniczenia
   1.1 Identyfikator UDDI w Eksploratorze usług Web Services nie będzie działać z serwerem proxy podstawowego uwierzytelniania.
2.0 Znane problemy oraz sposoby ich obejścia
   2.1 Błędy sprawdzania poprawności dla migrowanego projektu klienta usługi Web Service
   2.2 Brak podpowiedzi dla pobierania podczas próby modyfikacji wprowadzonego pliku WSDL tylko do odczytu. Kolejne zmiany są tracone podczas zapisywania.
   2.3 Sporadyczny błąd "HTTP Error 404" podczas wywoływania przykładowego pliku JSP usług Web Services
   2.4 Środowisko wykonawcze usług Web Services może się zmienić podczas zmiany serwera na stronie preferencji Serwer i środowisko wykonawcze usług Web Services
   2.5 Publikowanie UDDI: Przycisk Dalej na pierwszej stronie jest nieaktywny
   2.6 Wyjątek NullPointerException podczas generowania usługi Web Services po otwarciu i anulowaniu z okna dialogowego przeglądarki
   2.7 Edytor Java nie jest uruchamiany automatycznie po scenariuszu generowania zstępujących usług Web Service
   2.8 Wyjątek ClassCastException podczas tworzenia usługi Web Service w gałęzi JSR-109 usługi Web Services eksploratora projektów J2EE
   2.9 W kreatorach usług Web Services są pamiętane informacje o ID użytkownika i haśle
   2.10 Eksplorator usług Web Services może nie działać z adresem URL HTTPS

1.0 Ograniczenia

1.1 Usługi UDDI w eksploratorze usług Web Services nie będą działały z podstawowym uwierzytelnianiem serwera proxy

W przypadku korzystania z serwera proxy, który wymaga podstawowego uwierzytelniania, w celu uzyskania dostępu do sieci Internet  oraz korzystania z usługi UDDI wewnątrz eksploratora Web Services, pojawi się błąd.

 Na przykład:

Jeśli jest wyświetlana strona UDDI eksploratora usług Web Services, a następnie ma miejsce próba połączenia z rejestrem i odszukania potrzebnych informacji, w panelu wyników zostanie zwrócony następujący komunikat:
IWAB0135E Wystąpił nieoczekiwany błąd.
UDDIException
java.net.SocketException: Zresetowano połączenie

2.0 Znane problemy oraz sposoby ich obejścia

2.1 Błędy sprawdzania poprawności dla migrowanego projektu klienta usługi Web Service

Jeśli  istniejący projekt klienta usługi Web Service wygenerowany we wcześniejszej wersji produktu zostanie zaimportowany do obszaru roboczego, a następnie w tym samym projekcie zostanie ponownie wygenerowany klient usługi Web Service i przykładowe strony JSP, mogą wystąpić błędy sprawdzania poprawności na wygenerowanej stronie Result.jsp, mówiące, że  nie można rozstrzygnąć org.eclipse.jst.ws.util.JspUtils. Ta klasa znajduje się w pliku webserviceutils.jar; przykładowe strony JSP są kompilowane i uruchamiane bez problemów nawet w przypadku wyświetlenia błędów sprawdzania poprawności.

Aby obejść ten problem, należy zamknąć i ponownie otworzyć projekt, a następnie przeprowadzić czyszczenie i budowanie projektu.

2.2 Brak monitu dla pobrania podczas próby zmodyfikowania pobranego pliku WSDL tylko do odczytu. Kolejne zmiany są tracone podczas zapisywania.

Użytkownik nie będzie proszony o pobranie pliku WSDL tylko do odczytu/zwróconego sterowanego przez źródło przy każdej próbie zmodyfikowania pliku WSDL otwartego w edytorze WSDL. Ta zmiana początkowa i wszelkie kolejne zmiany nie zostaną zapisane. Rozwiązaniem jest najpierw pobranie pliku WSDL, a następnie wprowadzanie dowolnych zmian. 

 Podobny problem dotyczy edytora schematów XML. Użytkownik zostanie zapytany podczas pobierania pliku, jeśli jednak zmiany będą wprowadzone w widoku graficznym, zostaną utracone podczas zapisywania. Jeśli zmiany będą wprowadzone w widoku źródła, zostaną zapisane. Rozwiązaniem jest najpierw pobranie pliku XSD, a następnie wprowadzanie dowolnych zmian.

2.3 Nieregularny błąd "HTTP Error 404" podczas przywoływania przykładowej strony JSP usługi Web Services

Podczas uruchamiania przykładowej strony JSP usług Web Services w scenariuszu usługi Web Services może czasami pojawić się błąd "HTTP Error code 404" wraz z komunikatem: "Nie można znaleźć zasobu /sampleProjProxy/TestClient.jsp". Sposobem obejścia tego problemu jest odczekanie, aż na wskaźniku postępu w dolnym prawym rogu środowiska roboczego zniknie komunikat "Publikowanie na serwerze", a następnie wybranie w przeglądarce przykładowej strony JSP, kliknięcie prawym przyciskiem i wybranie opcji Odśwież.

2.4 Środowisko wykonawcze usług Web Services może się zmienić po zmianie serwera na stronie preferencji Serwer i środowisko wykonawcze usług Web Services

Na stronie preferencji Serwer i środowisko wykonawcze Web Service pole Środowisko wykonawcze Web Service może się zmienić po zmianie pola Serwer. Wyświetlany serwer i środowisko wykonawcze mogą nie być poprawną kombinacją. Przed zastosowaniem zmian należy się upewnić, czy ustawienia serwera oraz środowiska wykonawczego są poprawne.

2.5 Publikowanie UDDI: Przycisk Dalej na pierwszej stronie jest wyłączony

Podczas publikowania usługi Web Service w rejestrze UDDI testu jednostki przycisk Dalej na stronie Publikowanie usługi WWW powoduje przejście na stronę, na której można wybrać serwer docelowy publikowania. W niektórych przypadkach przycisk Dalej jest wyłączony i można kliknąć tylko przycisk Zakończ. Kliknięcie przycisku Zakończ powoduje wywołanie eksploratora usług Web Services, ale usługa Web Service nie zostanie w rzeczywistości opublikowana w rejestrze UDDI.

2.6 Wyjątek NullPointerException podczas generowania usługi Web Service po otwarciu i anulowaniu w oknie dialogowym przeglądania

Podczas generowania zstępującej usługi Web Service za pomocą kreatora usług Web Services wyjątek NullPointerException wystąpi, jeśli spełnione są następujące warunki:
1. Pole definicji usługi jest początkowo puste.
2. Użytkownik kliknął przycisk Przeglądaj..., aby otworzyć okno dialogowe Wybór elementu docelowego usługi.
3. Użytkownik zamknął okno dialogowe Wybór elementu docelowego usługi, nie wybierając niczego.
4. Użytkownik wprowadził poprawny adres URL WSDL w polu definicji usługi i kliknął przycisk Dalej lub Zakończ.

Można naprawić wyjątek NullPointerException, przechodząc do poprawnego adresu URL WSDL za pomocą okna dialogowego Wybór elementu docelowego usługi, a nie wprowadzając tekst w polu definicji usługi.

2.7 Edytor Java nie jest uruchamiany automatycznie po scenariuszu generowania zstępujących usług Web Service

Jeśli ścieżka obszaru roboczego zawiera spacje, edytor Java nie zostanie uruchomiony automatycznie po scenariuszu zstępującego generowania usługi Web Service.  Jeśli ten problem wystąpi, należy ręcznie otworzyć
wygenerowany plik implementacji usługi. Konwencja nazewnictwa pliku implementacji usługi jest następująca: <WSDL typPortu nazwa>Impl.java

2.8 Wyjątek ClassCastException podczas tworzenia usługi Web Service w gałęzi JSR-109 usługi Web Services eksploratora projektów J2EE

Podczas tworzenia wstępującej usługi Web Service za pomocą menu kontekstowego z gałęzi JSR-109 usługi Web Services eksploratora projektów J2EE można otrzymać komunikat "Wystąpił nieoczekiwany wyjątek - java.lang.ClassCastException", jeśli zostanie wybrana opcja Ukryj okno dialogowe tworzenia usługi Web Service w ramach preferencji Wybór wywoływanego okna dialogowego usług Web Services lub opcja Nie wyświetlaj ponownie tego okna dialogowego w kreatorze usług Web Services.

2.9 W kreatorach usług Web Services są pamiętane informacje o ID użytkownika i haśle

W kreatorach usług Web Services są pamiętane informacje o ID użytkownika i haśle dla serwerów z włączonym uwierzytelnianiem podstawowym. Może to powodować problemy w przypadku wprowadzenia niepoprawnego ID użytkownika i hasła.
Aby obejść ten problem, należy zrestartować środowisko Eclipse.

2.10 Eksplorator usług Web Services może nie działać z adresem URL HTTPS

Podczas uruchamiania eksploratora usług Web Services dla adresu URL HTTPS może zostać wygenerowany następujący błąd:

java.lang.ClassNotFoundException on com.ibm.websphere.ssl.protocol.SSLSocketFactory

Aby obejść ten problem, należy zrestartować środowisko robocze Eclipse, nie wywoływać żadnej operacji związanej z serwerem, takiej jak “Początkowy status serwera” lub “Publikowanie”, przed uruchomieniem eksploratora usług Web Services.