实现使用 Apache Wink REST 客户机的客户机
您可以使用 Apache Wink REST 客户机来发送请求以及处理来自 RESTful 服务的响应。您可以在 Java™ 程序中使用客户机 API 与 Web service 通信。
关于此任务
缺省情况下,Apache Wink 客户机将来自 Java 运行时环境的 java.net.HttpURLConnection 类用于发布请求和处理响应。Apache Wink 客户机还可以将 Apache HttpClient 4.0 用作底层客户机传输。
您还可以使用 JAX-RS 实体提供程序来帮助序列化请求实体或反序列化响应实体。JAX-RS 服务器端服务中使用的标准 JAX-RS 提供程序是随客户机提供的。
您可以用编程方式配置 Apache Wink REST 客户机或者通过设置 Java 虚拟机 (JVM) 属性来进行配置。
要实施 Apache Wink REST 客户机,您必须首先创建 org.apache.wink.client.ClientConfig 对象,然后将此对象用于构造 org.apache.wink.client.RestClient。您可以用编程方式更改 RestClient 对象的配置设置,或者您可以使用 JVM 属性来修改缺省 ClientConfig 对象值。
- wink.client.readTimeout
该属性指定 RestClient 对象将等待请求的响应多久(以毫秒为单位)才会超时。值 0 意味着客户机无限期地等待并且不会超时。
缺省值为 60,000 毫秒。
- wink.client.connectTimeout
此属性指定 RestClient 对象在尝试连接至目标资源时等待多久才会超时(以毫秒计)。值 0 意味着客户机无限期地等待并且不会超时。
缺省值为 60,000 毫秒。
通过使用 JVM 属性,您可以用编程方式对您指定的 RestClient 对象变更任何值。编程值优先于任何 JVM 属性值。
过程
结果
您使用 Apache Wink REST 客户机(可以向 JAX-RS 应用程序发布请求)来实施 JAX-RS 客户机。