RESTful Web Services in Spring 3（下）

上一篇我主要发了RESTful Web Services in Spring 3的服务端代码，这里我准备写客户端的代码。

 

上篇得连接地址为：http://yangjizhong.iteye.com/blog/600540

 

 

开始本篇了：

 

注:附件里有源码，下载即可，依赖包请在spring网获得，谢谢。

 

applicationContext.xml:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:p="http://www.springframework.org/schema/p"
	xmlns:context="http://www.springframework.org/schema/context"
	xmlns:oxm="http://www.springframework.org/schema/oxm"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd 
			http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd 
			http://www.springframework.org/schema/oxm http://www.springframework.org/schema/oxm/spring-oxm-3.0.xsd">

	<context:component-scan base-package="com.informit.articleservice" />

	<bean id="restTemplate" class="org.springframework.web.client.RestTemplate">
		<property name="messageConverters">
			<list>
				<!-- We only have one message converter for the RestTemplate, namely the XStream Marshller -->
				<bean class="org.springframework.http.converter.xml.MarshallingHttpMessageConverter">
					<constructor-arg>
						<bean class="org.springframework.oxm.xstream.XStreamMarshaller">
							
							<!-- Tell XStream to find the alias names in the following classes -->
							<property name="annotatedClasses">
								<list>
									<value>com.informit.articleservice.model.Article</value>							
									<value>com.informit.articleservice.model.Category</value>							
								</list>						
							</property>
						</bean>
					</constructor-arg>
				</bean>
			</list>
		</property>
	</bean>

</beans>

 

 

applicationContext.xml声明了一个bean,名restTemplate，implemented by org.springframework.web.client.RestTemplate，RestTemplate 类提供了一个setter来声明message converters，在这个属性我们提供一个包含一个简单bean的list：a MarshallingHttpMessageConverter，这是你的实体信息声明的地方

 

restTemplate bean声明后，ArticleClient 使用了restTemplate来调取ArticleService：

 

package com.informit.articleservice.client;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestTemplate;

import com.informit.articleservice.model.Article;
import com.informit.articleservice.model.Category;

@Component("articleClient")
public class ArticleClient {

	@Autowired
	protected RestTemplate restTemplate;

	private final static String articleServiceUrl = "http://localhost:8082/articleservice/";

	@SuppressWarnings("unchecked")
	public List<Category> getCategories() {
		return restTemplate.getForObject(articleServiceUrl + "article", List.class);
	}

	public Article getArticle(String category, int id) {
		return restTemplate.getForObject(articleServiceUrl + "article/{category}/{id}", Article.class, category, id);
	}

	@SuppressWarnings("unchecked")
	public void delCategories() {
		restTemplate.delete(articleServiceUrl + "article");
	}

	@SuppressWarnings("unchecked")
	public List<Category> postCategories() {
		Map<String, String> params = new HashMap<String, String>();
		params.put("name", "jizhong");
		return restTemplate.postForObject(articleServiceUrl + "addarticle/{name}", null, List.class, params);

	}

}

 

 

在这里RestTemplate是自动加载的（auto-wired）,你会注意到ArticleClient被加上了@Component annotation而且applicationContext.xml自动扫描com.informit.articleservice包或他的子包，因此当ArticleClient通过application context被loaded时，他会自动作为一个接口来实现RestTemplate实例

 

RestTemplate的相关使用的方法在文档中是这样写的：

 

delete(): deletes an object hosted by the web service
getForObject(): executes the HTTP GET command and returns the requested object
headForHeaders(): executes the HTTP HEAD command and returns the headers for the requested service
optionsForAllow(): executes the HTTP OPTIONS command and returns list of content types the the request service allows
postForLocation: executes the HTTP POST command and returns the location header value
postForObject(): executes the HTTP POST command and returns the object at the specified URL
put(): executes the HTTP PUT command and sends the specified object to the web service
execute(): provides fine grained control if one of the aforementioned methods does not suit your needs

 

接下来列出测试类：

 

package com.informit.resttemplateexample;

import java.util.List;

import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

import com.informit.articleservice.client.ArticleClient;
import com.informit.articleservice.model.Category;

public class RestTemplateExample {
	public static void main(String[] args) {
		ApplicationContext applicationContext = new ClassPathXmlApplicationContext("applicationContext.xml");
		ArticleClient articleClient = applicationContext.getBean("articleClient", ArticleClient.class);

		//get operate
		//		Article article = articleClient.getArticle("fun", 1);
		//		System.out.println("Article: " + article.getBody());
		//
		//		List<Category> categories = articleClient.getCategories();
		//		for (Category category : categories) {
		//			System.out.println("Category: " + category);
		//		}

		//delete operate
		//articleClient.delCategories();

		//post operate
		List<Category> categories = articleClient.postCategories();

	}
}

 

 

 

好了，然后本地跑一下就可以了，当然前提是一定把服务端跑起来哦....

 

注：详细代码在附件，JAR包还是自己下哈，终于写完了，有点累，但是有收获。

 

 

评论

2 楼 azxaqwaa 2014-02-11  

不错。

1 楼 eric851018 2013-05-21  

写的非常棒