Clients implementieren, die den REST-Client von Apache Wink verwenden
Sie können den REST-Client von Apache Wink verwenden, um Anforderungen zu senden und Antworten von RESTful-Services zu verarbeiten. Sie können die Client-API in Java™-Programmen verwenden, um mit Web-Services zu kommunizieren.
Informationen zu diesem Vorgang
Standardmäßig verwendet der Apache-Wink-Client die Klasse "java.net.HttpURLConnection" aus der Java-Laufzeitumgebung, um Anforderung auszugeben und Antworten zu verarbeiten. Der Apache-Wink-Client kann auch Apache HttpClient 4.0 als zugrunde liegenden Clienttransport verwenden.
Sie können auch JAX-RS-Entitätsprovider verwenden, um die Serialisierung von Anforderungsentitäten bzw. die Entserialisierung von Antwortentitäten zu unterstützen. Die JAX-RS-Standardprovider, die in den serverseitigen JAX-RS-Services verwendet werden, werden mit dem Client bereitgestellt.
Sie können den Apache-Wink-REST-Client über das Programm oder durch Definition von JVM-Eigenschaften (Java Virtual Machine) konfigurieren.
Zum Implementieren eines Apache-Wink-REST-Clients müssen Sie zuerst ein Objekt "org.apache.wink.client.ClientConfig" erstellen, das anschließend für die Erstellung eines org.apache.wink.client.RestClient verwendet wird. Sie können die Konfigurationseinstellungen für das Objekt "RestClient" über das Programm ändern, oder Sie können JVM-Eigenschaften verwenden, um die ClientConfig-Standardobjektwerte zu ändern.
- wink.client.readTimeout
Diese Eigenschaft gibt an, wie lange (in Millisekunden) das Objekt "RestClient" auf eine Antwort auf Anforderungen wartet, bevor eine Zeitlimitüberschreitung ausgelöst wird. Der Wert 0 bedeutet, dass der Client unbegrenzt wartet und keine Zeitlimitüberschreitung ausgelöst wird.
Der Standardwert ist 60.000 Millisekunden.
- wink.client.connectTimeout
Diese Eigenschaft gibt an, wie lange (in Millisekunden) das Objekt "RestClient" auf eine Verbindung zur Zielressource wartet, bevor eine Zeitlimitüberschreitung ausgelöst wird. Der Wert 0 bedeutet, dass der Client unbegrenzt wartet und keine Zeitlimitüberschreitung ausgelöst wird.
Der Standardwert ist 60.000 Millisekunden.
Sie können alle Werte für das Objekt "RestClient", die Sie mit JVM-Eigenschaften angeben, über das Programm ändern. Die programmgesteuerten Werte haben Vorrang vor den JVM-Eigenschaftswerten.
Vorgehensweise
Ergebnisse
Sie haben einen JAX-RS-Client mit dem REST-Client von Apache Wink implementiert, der Anforderungen an eine JAX-RS-Anwendung absetzen kann.