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

Unterstützte Konfigurationen Unterstützte Konfigurationen: Sie können Thin Client for JAX-RS mit WebSphere Application Server als eigenständige Clientlaufzeitumgebung in einer reinen Java-SE-Umgebung verwenden. Die Ausführung von Thin Client for JAX-RS in Umgebungen mit WebSphere Application Server oder WebSphere Application Client wird nicht unterstützt. In dieser Version des Anwendungsservers können sich weitere Thin-Client-Laufzeiten, die mit dem Anwendungsserver bereitgestellt werden, im Klassenpfad befinden und mit Thin Client for JAX-RS koexistieren.sptcfg

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

Konfigurieren Sie die Umgebung von Thin Client for JAX-RS wie folgt:

Vorgehensweise

  1. Konfigurieren Sie den Pfad. Geben Sie den folgenden Befehl ein, um Ihrem Pfad die Java-Verzeichnisse bin hinzuzufügen:
    [Windows][z/OS]
    set PATH=<JDK-bin-Verzeichnis>;%PATH%
    [AIX][HP-UX][Solaris][Linux]
    export PATH=<JDK-bin-Verzeichnis>:$PATH
  2. Konfigurieren Sie den Klassenpfad. Fügen Sie die JAR-Datei von Thin Client for JAX-RS der Klassenpfaddefinition hinzu, z. B.:
    [Windows][z/OS]
    set CLASSPATH=.;<Installationsverzeichnis_des_JAX-RS_Thin_Client>\com.ibm.jaxrs2.0.thinclient_9.0.jar;
    <JAR-Dateien_für_Ihre_Anwendung>;%CLASSPATH%
    [AIX][HP-UX][Solaris][Linux][IBM i]
    export CLASSPATH=.:<Installationsverzeichnis_des_JAX-RS_Thin_Client>/com.ibm.jaxrs2.0.thinclient_9.0.jar:
    <JAR-Dateien_für_Ihre_Anwendung>;$CLASSPATH
  3. Geben Sie den folgenden Befehl ein, um Ihre Clientanwendung auszuführen:
    [Windows][z/OS]
    %JAVA_HOME%/bin/java <Clientanwendung>
    [AIX][HP-UX][Solaris][Linux][IBM i]
    $JAVA_HOME/bin/java <Clientanwendung>

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}
  • 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.port
      Tipp: 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.type
      Tipp: 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);

Symbol, das den Typ des Artikels anzeigt. Taskartikel



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