Informacje portu klienta usług Web services

Ta strona służy do określania limitu czasu żądania, wymuszania punktu końcowego i wymuszania wiążącej przestrzeni nazw dla portu klienta usług Web Service.

Usługa WWW może mieć wiele portów. Atrybuty portu można wyświetlać i konfigurować dla każdego zdefiniowanego portu usługi WWW. Usługi Web Service są wyświetlane na stronie Powiązania klienta usług Web Service.

Aby wyświetlić tę stronę Konsoli administracyjnej, wykonaj następujące czynności:

Kliknij opcję Aplikacje > Typy aplikacji > Aplikacje korporacyjne WebSphere > nazwa_zasobu.
Kliknij opcję Zarządzaj modułami > nazwa_modułu > Powiązania klienta usług Web Service.
Kliknij opcję Edytuj w obszarze Informacje o portach.

Niniejsza strona Konsoli administracyjnej ma zastosowanie zarówno do usługi Java API for XML-Based Web Services (JAX-WS), jak i usługi Java API for XML-based RPC (JAX-RPC). Pole Adres URL przesłoniętego punktu końcowego jest jedynym polem obsługiwanym w przypadku klientów JAX-WS. Pozostałe pola nie mają zastosowania w przypadku tych klientów.

Port

Określa nazwę portu.

Limit czasu żądania

Określa czas (w sekundach), przez który klient usługi www czeka na żądania do wykonania na tym porcie. Jeśli limit czasu nie jest określony, domyślny limit czasu oczekiwania przez klienta na żądanie wynosi 300 sekund. Jeśli wartość ustawiona jest na 0 (zero), używana jest wartość domyślna limitu czasu dla mechanizmu transportu bazowego. To pole jest obsługiwane wyłącznie w przypadku klientów JAX-RPC.

Typowym zastosowaniem tego ustawienia jest dostosowywanie zachowania klienta, gdy skonfigurowano go do używania transportu JMS w celu uzyskania dostępu do usługi WWW, tak aby oczekiwał dłużej na spodziewane zakończenie. W zależności od warunków sieciowych lub rodzaju implementacji usługi WWW może zaistnieć konieczność dostrojenia limitu czasu.

Adres URL przesłoniętego punktu końcowego

Określa nazwę punktu końcowego, która jest używana do przesłonięcia bieżącego punktu końcowego. Klient wywołujący żądanie na tym porcie używa tego punktu końcowego zamiast punktu końcowego określonego w pliku WSDL. To pole jest obsługiwane w przypadku klientów JAX-WS i JAX-RPC.

Jeśli zostaną wywołane klienty JAX-RPC lub JAX-WS, żądania zostaną wysłane do adresu URL określonego w atrybucie położenia adresu SOAP portu, który jest podany w pliku WSDL (Web Services Description Language). Oba modele programistyczne oferują także klientom możliwość programistycznego ustawiania adresu URL punktu końcowego. W przypadku klienta JAX-RPC do ustawienia adresu URL punktu końcowego używana jest właściwość javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY, natomiast w przypadku klienta JAX-WS - javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY.

Jeśli złożona aplikacja zawiera klient usługi WWW, który jest powiązany statycznie, klient musi używać implementacji (punktu końcowego usługi) zidentyfikowanej w pliku WSDL używanym podczas programowania. Przesłonięcie punktu końcowego jest alternatywą dla skonfigurowania zainstalowanego atrybutu WSDL.

Nadpisany atrybut URI punktu końcowego jest określony na bazie dla każdego portu. Nie wymaga alternatywnego pliku WSDL w obrębie modułu. Nadpisany URI punktu końcowego ma pierwszeństwo nad zainstalowanym atrybutem WSDL. Klient używa tej wartości dla URI punktu końcowego usługi lub adresu SOAP zamiast wartości w statycznych powiązaniach klienta.

Unikanie problemów:

Zwykle to pole nie ma wpływu na niezarządzane klienty JAX-WS, ponieważ nie można go edytować, jeśli używane są tylko niezarządzane klienty. Jednak jeśli wszystkie klienty są zarządzane lub część jest zarządzana, a część nie, to pole można edytować i ustawienie właściwości może mieć wpływ na niezarządzane klienty. Jeśli żądanie pochodzące z usługi niezarządzanego klienta JAX-WS nie ma zostać wysłane do adresu URL punktu końcowego określonego w tym polu, należy dodać następującą właściwość niestandardową do ustawień maszyny JVM:
```
com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri
```
Dodanie tej właściwości niestandardowej do ustawień maszyny JVM serwera aplikacji i ustawienie jej na wartość true uniemożliwia usługom niezarządzanych klientów JAX-WS dostęp do adresu URL punktu końcowego, który zastępuje punkt końcowy w pliku WSDL.
Ustawienia adresu URL punktu końcowego nie są utrwalone, jeśli moduł lub aplikacja zostały zastąpione podczas wykonywania operacji aktualizacji.

gotcha

Przesłonięte powiązanie

Określa URI przestrzeni nazw powiązań pliku WSDL używany w tym porcie zamiast przestrzeni nazw w pliku WSDL. To powiązanie nie musi istnieć w pliku WSDL. Klient wywołujący żądanie na tym porcie używa tego powiązania zamiast powiązania określonego w pliku WSDL. Przesłonięta przestrzeń nazw powiązania nie może być określone, jeśli nie określono przesłoniętego punktu końcowego. To pole jest obsługiwane wyłącznie w przypadku klientów JAX-RPC.

Nazwa pliku: uwbs_portattribute.html