Portinformationen für Web-Service-Clients

Verwenden Sie diese Seite, um ein Anforderungszeitlimit anzugeben, einen Endpunkt und einen Bindungsnamespace für einen Web-Service-Client-Port zu überschreiben.

Ein Web-Service kann mehrere Ports haben. Sie können die Portattribute für jeden definierten Web-Service-Port anzeigen und konfigurieren. Die Web-Service sind auf der Seite "Web-Service-Clientbindungen" aufgelistet.

Führen Sie die folgenden Schritte aus, um diese Seite der Administrationskonsole anzuzeigen:
  1. Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen > Ressourcenname .
  2. Klicken Sie auf Module verwalten > Modulname > Web-Service-Clientbindungen.
  3. Klicken Sie unter Portinformationenauf Bearbeiten.

Diese Seite der Administrationskonsole gilt für JAX-WS- (Java™ API for XML-Based Web Services) und JAX-RPC-Web-Services (Java API for XML-based RPC). Das Feld Überschriebener Endpunkt-URL ist das einzige Feld, das für JAX-WS-Clients unterstützt wird. Die anderen Felder gelten nicht für JAX-WS-Clients.

Port

Gibt den Namen eines Ports an.

Zeitlimit für Anforderung

Gibt an, wie lange (in Sekunden) der Web-Service-Client auf den Abschluss einer Anforderung an diesem Port wartet. Wenn Sie kein Zeitlimit angeben, wird das Standardanforderungszeitlimit von 300 Sekunden für den Client verwendet. Wenn diese Einstellung auf 0 (null) gesetzt ist, wird der Standardwert für den zugrunde liegenden Transportmechanismus als Zeitlimit verwendet. Dieses Feld wird nur für JAX-RPC-Clients unterstützt.

Diese Einstellung wird typischerweise verwendet, um das Verhalten eines Clients anzupassen, wenn dieser einen JMS-Transport für den Zugriff auf einem Web-Service verwendet und Sie die Wartezeit für den Zugriff erhöhen möchten. Die Netzlast oder die Art der Web-Service-Implementierung können eine Optimierung des Zeitlimits erforderlich machen.

Überschriebener Endpunkt-URL

Gibt den Namen eines Endpunkts an, der zum Überschreiben des aktuellen Endpunkts verwendet wird. Ein Client, der eine Anforderung an diesem Port aufruft, verwendet diesen Endpunkt anstelle des in der WSDL-Datei angegebenen Endpunkts. Dieses Feld wird für JAX-WS- und JAX-RPC-Clients unterstützt.

Beim Aufruf von JAX-RPC- oder JAX-WS-Clients werden Anforderungen an die URL gesendet, die im Positionsattribut für die SOAP-Adresse des Ports in der WSDL-Datei (Web Services Description Language) angegeben ist. Beide Programmiermodelle ermöglichen den Clients außerdem, die URL der Endpunktadresse über das Programm festzulegen. Für JAX-RPC verwendet der Client die Eigenschaft javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY, um die URL der Endpunktadresse festzulegen. Für JAX-WS verwendet der Client die Eigenschaft javax.xml.ws.BindingProvider.ENDPOINT_ADDRESS_PROPERTY.

Wenn eine assemblierte Anwendung einen Web-Service-Client enthält, der statisch gebunden ist, wird der Client mit der Implementierung (Serviceendpunkt) gesperrt, die in der während der Implementierung verwendeten WSDL-Datei angegeben ist. Das Überschreiben des Endpunkts ist eine Alternative zur Konfiguration des Attributs für die implementierte WSDL.

Das Attribut "Überschriebener Endpunkt-URI" wird für jeden Port gesondert definiert. Es ist keine alternative WSDL-Datei im Modul erforderlich. Der überschriebene Endpunkt-URI hat Vorrang vor dem Attribut für die implementierte WSDL. Der Client verwendet diesen Wert anstelle des Wertes in den statischen Clientbindungen für den Serviceendpunkt-URI.

Fehler vermeiden Fehler vermeiden:
  • Normalerweise hat dieses Feld keine Auswirkungen für nicht verwaltete JAX-WS-Clients, da Sie dieses Feld nicht bearbeiten können, wenn Sie nur nicht verwaltete Clients verwenden. Wenn Sie jedoch nur verwaltete Clients oder eine Kombination aus verwalteten und nicht verwalteten Clients verwenden, können Sie dieses Feld bearbeiten und die Einstellung der Eigenschaft kann Auswirkungen auf die nicht verwalteten Clients haben. Wenn Sie nicht möchten, dass eine Anforderung von einem nicht verwalteten JAX-WS-Client-Service an die in diesem Feld angegebene Endpunkt-URL gesendet wird, fügen Sie Ihren JVM-Einstellungen die folgende angepasste Eigenschaft hinzu:
    com.ibm.ws.websvcs.unmanaged.client.dontUseOverriddenEndpointUri
    Wenn Sie diese angepasste Eigenschaft den JVM-Einstellungen für einen Anwendungsserver hinzufügen und auf true setzen, verhindert dies den Zugriff nicht verwalteter JAX-WS-Client-Services auf die Endpunkt-URL, die den Endpunkt in der WSDL-Datei überschreibt.
  • Endpunkt-URL-Einstellungen, die überschrieben wurden, werden nicht beibehalten, wenn ein Modul oder eine Anwendung in einer Aktualisierungsoperation ersetzt wird.
gotcha

Überschriebene Bindung

Gibt den Namespace-URI der WSDL-Dateibindung an, der anstelle des Namespace in der WSDL-Datei für den Port verwendet werden soll. Diese Bindung muss nicht in der WSDL-Datei vorhanden sein. Ein Client, der eine Anforderung an diesem Port aufruft, verwendet diese Bindung anstelle der in der WSDL-Datei angegebenen Bindung. Ein überschriebener Bindungsnamespace kann nur angegeben werden, wenn ein überschriebener Endpunkt angegeben ist. Dieses Feld wird nur für JAX-RPC-Clients unterstützt.


Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=uwbs_portattribute
Dateiname:uwbs_portattribute.html