Client mithilfe des nicht verwalteten JAX-RS-Clients für REST-konforme Web-Services implementieren
WebSphere Application Server stellt eine auf Java™ Platform, Standard Edition 8 (Java SE 8) basierende Thin-Client-Laufzeitumgebung für REST-konforme (RESTful) Web-Services bereit, um Anwendungsentwicklern die schnelle und einfache Erstellung von JAX-RS-Clientanwendungen zu ermöglichen. Thin Client for JAX-RS mit WebSphere Application Server ist eine eigenständige Clientumgebung der Java SE Version 8, die es ermöglicht, nicht verwaltete REST-konforme JAX-RS-Web-Service-Clientanwendungen in einer anderen Umgebung als WebSphere auszuführen, damit REST-konforme JAX-RS-Web-Services aufgerufen werden können, die vom Anwendungsserver gehostet werden.
Vorbereitende Schritte

Für die Konfiguration einer Ausführungsumgebung für nicht verwaltete JAX-RS-Clients benötigen Sie die JAR-Datei von Thin Client for JAX-RS. Sie erhalten Thin Client for JAX-RS, wenn Sie WebSphere Application Server Version 9.0 oder Application Client for WebSphere Application Server Version 9.0 installieren. Die JAR-Datei des Thin Client for JAX-RS, com.ibm.jaxrs2.0.thinclient_9.0.jar, befindet sich im Verzeichnis Stammverzeichnis_des_Anwendungsservers\runtimes.
Kopieren Sie die Datei com.ibm.jaxrs2.0.thinclient_9.0.jar des Thin Client for JAX-RS auf andere Maschinen, um eine einfache Clientumgebung zu erstellen, die die Kommunikation mit dem Produkt ermöglicht. Kopien von Thin Client for JAX-RS unterliegen den Lizenzbedingungen des WebSphere-Produkts, über das Sie Thin Client for JAX-RS erhalten haben. Informationen zur ordnungsgemäßen Verwendung und zu weiteren Einschränkungen entnehmen Sie den Lizenzvereinbarungen.
Thin Client for JAX-RS funktioniert mit IBM® Software Development Kits (SDKs) Version 8.0 und höher. Thin Client for JAX-RS wird auch in SDKs der Version 8.0 und höher anderer Anbieter unterstützt.
Informationen zu diesem Vorgang
Vorgehensweise
Nächste Schritte
- Verwenden Sie die Thin-Client-Eigenschaften,
com.ibm.ws.jaxrs.client.connection.timeout und
com.ibm.ws.jaxrs.client.receive.timeout, um die Zeitlimitwerte festzulegen.
- com.ibm.ws.jaxrs.client.connection.timeout
javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.connection.timeout", "1000"); Client c = cb.build();
- com.ibm.ws.jaxrs.client.receive.timeout
javax.ws.rs.client.ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.receive.timeout", "1000"); Client c = cb.build();
Tipp: Der Wert der Zeitlimiteigenschaft wird in Millisekunde angegeben und als Typ muss "Long" oder ein Integralwert verwendet werden. Wenn der Werttyp ungültig ist, wird die folgende Nachricht angezeigt:CWTRS0700E: Der Zeitlimitwert {0}, den Sie in der Eigenschaft com.ibm.ws.jaxrs.client.receive.timeout auf der JAX-RS-Clientseite angegeben haben, ist ungültig. Es wird der Standardwert 30000 verwendet. {3}
- com.ibm.ws.jaxrs.client.connection.timeout
- Verwenden Sie die folgenden Thin-Client-Eigenschaften zur Unterstützung des Thin Client-Proxy:
ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.proxy.host", "hostname"); cb.property("com.ibm.ws.jaxrs.client.proxy.port", "8888";); cb.property("com.ibm.ws.jaxrs.client.proxy.type", "HTTP"); Client c = cb.build();
- com.ibm.ws.jaxrs.client.proxy.host
- com.ibm.ws.jaxrs.client.proxy.portTipp: Der Typ des Proxy-Server-Ports muss ein Integralwert sein. Der Standardwert ist 80. Wenn der Werttyp ungültig ist, wird die folgende Nachricht angezeigt:
CWTRS0701E: Der Zeitlimitwert {0}, den Sie in der Eigenschaft com.ibm.ws.jaxrs.client.proxy.port auf der JAX-RS-Clientseite angegeben haben, ist ungültig. Es wird der Standardwert 80 verwendet. {3}
- com.ibm.ws.jaxrs.client.proxy.typeTipp: Der Wert des Proxy-Servers muss HTTP oder SOCKS sein. Der Standardwert ist HTTP. Wenn der Proxy-Server-Typ ungültig ist, wird die folgende Nachricht angezeigt:
CWTRS0702E: Der Proxy-Server-Typ {0}, den Sie in der Eigenschaft com.ibm.ws.jaxrs.client.proxy.type auf der JAX-RS-Clientseite angegeben haben, ist ungültig. Es wird der Standardwert HTTP verwendet. {3}
- Konfigurieren Sie den JAX-RS 2.0-Client für die Validierung der Authentifizierungsdaten im LTPA-Token.
- Sichern Sie den JAX-RS-Thin-Client mit SSL.
- Verwenden Sie die Thin-Client-Eigenschaft
com.ibm.ws.jaxrs.client.disableCNCheck, um die Prüfung der allgemeinen Namen zu inaktivieren.
ClientBuilder cb = ClientBuilder.newBuilder(); cb.property("com.ibm.ws.jaxrs.client.disableCNCheck", true);