Web服务和SOA(三) 上

使用REST协议来实现SOA服务

REST是Representation State Transfer(表示层有状态的传输协议)的简称，它是一种Web架构类型，由Roy Fielding于2000年在他的博士论文中提出来的。REST的基本思想是如何充分利用HTTP协议的功能，它特别关注以下内容：

(1)     REST关注资源，即，每种服务都应该设计成对资源进行某种操作；

(2)     REST充分利用了HTTP协议中的谓词的功能，它不仅使用我们常用的GET和POST谓词，而且还使用PUT和DELETE谓词

在我们前面使用POX-over-HTTP方法完成的的SOA服务中，我们就使用了POST这个HTTP谓词。虽然前面我们仅仅列出了几个服务的源代码，它们都可以使用POST谓词来实现，当然，您也可以使用其它谓词实现这些服务。REST的思想就是，我们为什么不充分利用HTTP协议谓词的功能，把常见的CRUD操作映射到HTTP协议的谓词上，这样，消息交换协议就显得更加清晰。因此，我们可以把CRUD操作和相应的HTTP谓词进行关联，具体关系如下表所示：

 

HTTP谓词	CRUD操作	操作表述
POST	CREATE	Save new resources
GET	READ	Read resources
PUT	UPDATE	Modify existing resources
DELETE	DELETE	Delete resources

 

请您记住，资源及其对应的值代表了系统的状态，系统状态的转换将遵行以下几个规则：

(1)     POST、PUT和DELETE谓词可以改变资源的状态

(2)     GET谓词不能修改资源的状态

(3)     往系统增加新资源时应该使用POST谓词

(4)     修改系统中的资源应使用PUT谓词

(5)     从系统中删除资源应调用DELETE谓词

(6)     系统交换协议应该是无状态的，即本次方法的调用不应依赖于上次的方法调用

这些听起来很有趣，但资源究竟是什么？资源其实就是HTTP四个谓词能覆盖的请求操作的范围。拿我们前面的讨论过的商品对象来说，它就是一个典型的资源实例。您可以看到，在我们的实现代码中(见代码清单5)，有一个IF-THEN的判断语句块，这个语句块根据请求中的含有的方法名来执行不同的操作，实际上，我们可以通过使用HTTP谓词，避免这些条件判断。那么，这是如何实现的呢？

如果客户端想新添一个商品，它需要调用insertItem服务，先要为这个新商品创建一个XML文档，然后通过POST方法把这个XML文档发送到服务器端，服务器的应答可以是一个比较通用的一个结果对象。

代码清单9— 通用结果对象Outcome的源代码

@XmlRootElement(name="Outcome")
public class Outcome {
private String retCode;
private String retMessaget;
...
}

服务器端的实现代码也会因此而减少，因为现在我们不需要考虑条件判断语句(请把下面的代码和代码清单5相比较)：

代码清单10— REST风格的新建服务的服务器端实现代码

protected void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
try{
JAXBContext jaxbContext = JAXBContext.newInstance(Item.class, Outcome.class);
Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
//Receiving the XML request and transform it into a Java object
Item item = (Item) unmarshaller.unmarshal(request.getInputStream());

System.out.println("Inserting item# "+item.getId());

// ... insert item
Marshaller marshaller = jaxbContext.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT,Boolean.TRUE);

Outcome outcome = new Outcome();
outcome.setRetCode("OK");
outcome.setRetMessaget("Item was inserted successfully");
marshaller.marshal(outcome, response.getOutputStream());
}catch (Exception e) {
throw new ServletException(e);
}}

请注意，上面的代码只是REST协议的一个非常简单的手工实现，我们是使用一个简单的Servlet实现的，因为我们想把注意力集中在消息交换协议的一些重要概念上。虽然REST可由多种方法实现，比如JAX-WS(我们在讨论SOAP时会讲到)或Axis2都可实现REST。

好，现在回到我们的例子，updateItem服务可由与上面类似的代码实现，唯一的区别就是把update服务的实现代码放在Servlet的doPut方法中，而不是放在doPost方法中。其实，REST方法还有一点与众不同，我们这里提前说一下。

代码清单11— REST风格的新建服务的客户器端实现代码

Item item = new Item();
item.set...

//Prepare and establish the connection with the service
URL url = new URL("http://localhost/SoaBookREST/itemService");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setDoOutput(true);
//Set the HTTP request method
con.setRequestMethod("POST");
con.connect();
JAXBContext jaxbContext = JAXBContext.newInstance(Item.class, Outcome.class);
Marshaller marshaller = jaxbContext.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT,Boolean.TRUE);

//Send the XML request to the service
marshaller.marshal(item, con.getOutputStream());

//Get the XML response from the service and deserialize it
Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
Outcome outcome = (Outcome)
unmarshaller.unmarshal(con.getInputStream());