第五课：RESTful 客户端编程

课程网站：

• http://ss.sysu.edu.cn/~pml/dct/5_restful_client.html

相关文章：

• 第一课：Java进阶与Socket通讯实验
• 第二课：Socket通讯与HTTP服务器
• 第三课：Java Web 编程原理
• 第四课：RESTful Webservice 编程

习题部分

---

写出实验 1 中执行 // Sent HTTP PUT request to update customer info 对应的 curl，与输出结果。

curl -v -H "Content-Type: application/xml" -d "<?xml version='1.0'?><Customer><name>Mary</name><id>123</id></Customer>" -X PUT "http://localhost:9000/customerservice/customers"

• STATE: INIT => CONNECT handle 0x6000572f0; line 1108 (connection #-5000)

简述 问题 1 中对应程序执行的过程。

// 输出信息，表示进入
System.out.println("\n");
System.out.println("Sent HTTP PUT request to update customer info");

// 创建一个client对象
Client client = new Client();

// 获得输入的xml
String inputFile = client.getClass().getResource("/update_customer.xml").getFile();

// 解析输入的xml文件
URIResolver resolver = new URIResolver(inputFile);

// 读xml文件中的URL对应的文件
File input = new File(resolver.getURI());

// 创建一个PutMethod对象
PutMethod put = new PutMethod("http://localhost:9000/customerservice/customers");

// 创建RequestEntity对象，里面包含了文件内容和类型
RequestEntity entity = new FileRequestEntity(input, "text/xml; charset=ISO-8859-1");

// 提交数据
put.setRequestEntity(entity);

// 创建HttpClient对象
HttpClient httpclient = new HttpClient();

try {
   // 输出结果
   int result = httpclient.executeMethod(put);
   System.out.println("Response status code: " + result);
   System.out.println("Response body: ");
   System.out.println(put.getResponseBodyAsString());
} finally {
   // Release current connection to the connection pool once you are
   // done
   put.releaseConnection();
}

实验 1 中，简述 URIResolver 类的作用是什么？

解析文件、资源或者URL。

实验 1 中，简述 CachedOutputStream 类的作用是什么？

获取并且对输出流进行处理

翻译 jersey 文档 5.1. Uniform Interface Constraint 的 5 个目标。

1. every resource is identified by a URI;（每个资源对应一个URL）
2. a client interacts with the resource via HTTP requests and responses using a fixed set of HTTP methods; （一个客户使用一系列HTTP的方法，通过HTTP请求和响应与资源交互）
3. one or more representations can be returned and are identified by media types;（一个或者多个陈述可以被传播媒介返回和识别） and
4. the contents of which can link to further resources.（这些陈述的内容可以连接到更加远的资源）

简述实验 2 中官方文档 5.2 提到的 UriBuilder 类的作用。

URI building using UriBuilder and UriTemplate to safely build URIs
翻译：安全地产生URL

阅读实验 3 官方文档，用自己的语言（中文）陈述 Motivation for Reactive Client Extension。

如果要一个用户同时申请多个服务，可以每个服务都申请一遍，然后得到结果。但是这样就很麻烦。所以使用无扩展的客户服务。客户只要申请一遍就行了

（！）给出一个可运行的实验程序，包含在作业中。

……

阅读实验 4 官方文档，为什么 Java 写 web 服务必须先声明接口？通常这样的接口必须放在一个独立的 Java 文件中。

可能是为了更加灵活，方便维护。

JAXRSClientFactory 类的作用是什么？

可以通过JAXRSClientFactory工厂类创建Service对象。

简述透明代理的作用。

透明代理的意思是客户端根本不需要知道有代理服务器的存在，它改编你的request fields（报文），并会传送真实IP。用户A和用户B并不知道行为管理设备充当透明代理行为，当用户A或用户B向服务器A或服务器B提交请求的时候，透明代理设备根据自身策略拦截并修改用户A或B的报文，并作为实际的请求方，向服务器A或B发送请求，当接收信息回传，透明代理再根据自身的设置把允许的报文发回至用户A或B，如上图，如果透明代理设置不允许访问服务器B，那么用户A或者用户B就不会得到服务器B的数据。

参考资料：
图解正向代理、反向代理、透明代理