spring mvc实现Restful返回xml格式数据

最近，想在自己的小项目中搭建一个Restful风格的服务接口api，项目用的spring mvc 3，听说spring mvc本身就能十分方便的支持restful的实现，于是查询了下资料，果然非常强大。

在一次偶然的#墙#外#(你懂的)状态下浏览到了一个老外的博客，举了几个入门例子十分经典，原文是E文+被墙状态，觉得有必要扒过来收藏学习下。

在本示例中，我们将向您展示如何将对象转换成xml格式并通过spring mvc框架返回给用户。

技术及环境：

1. Spring 3.0.5.RELEASE
2. JDK 1.6
3. Eclipse 3.6
4. Maven 3

1、添加项目依赖

不需要更多，你只要添加spring mvc的依赖即可：

1. <properties>
2. <spring.version>3.0.5.RELEASE</spring.version>
3. </properties>
4. <dependencies>
5. <!-- Spring 3 dependencies -->
6. <dependency>
7. <groupId>org.springframework</groupId>
8. <artifactId>spring-core</artifactId>
9. <version>${spring.version}</version>
10. </dependency>
11. <dependency>
12. <groupId>org.springframework</groupId>
13. <artifactId>spring-web</artifactId>
14. <version>${spring.version}</version>
15. </dependency>
16. <dependency>
17. <groupId>org.springframework</groupId>
18. <artifactId>spring-webmvc</artifactId>
19. <version>${spring.version}</version>
20. </dependency>
21. </dependencies>

2、实体类JavaBean

一个简单的JavaBean，添加了JAXB 注解，稍后将会被转换成xml。

JAXB已经包含在JDK1.6中，你不需要添加额外的依赖库，只需要使用注解，spring会自动将其转换为xml格式。

1. import javax.xml.bind.annotation.XmlElement;
2. import javax.xml.bind.annotation.XmlRootElement;
3. @XmlRootElement(name = "coffee")
4. public class Coffee {
5. String name;
6. int quanlity;
7. public String getName() {
8. return name;
9. }
10. @XmlElement
11. public void setName(String name) {
12. this.name = name;
13. }
14. public int getQuanlity() {
15. return quanlity;
16. }
17. @XmlElement
18. public void setQuanlity(int quanlity) {
19. this.quanlity = quanlity;
20. }
21. public Coffee(String name, int quanlity) {
22. this.name = name;
23. this.quanlity = quanlity;
24. }
25. public Coffee() {
26. }
27. }

3、Controller

添加@ResponseBody注解到你的方法返回值，在spring文档中没有太多的细节，它会自动处理转换。

1. import org.springframework.stereotype.Controller;
2. import org.springframework.web.bind.annotation.PathVariable;
3. import org.springframework.web.bind.annotation.RequestMapping;
4. import org.springframework.web.bind.annotation.RequestMethod;
5. import org.springframework.web.bind.annotation.ResponseBody;
6. import com.mkyong.common.model.Coffee;
7. @Controller
8. @RequestMapping("/coffee")
9. public class XMLController {
10. @RequestMapping(value="{name}", method = RequestMethod.GET)
11. public @ResponseBody Coffee getCoffeeInXML(@PathVariable String name) {
12. Coffee coffee = new Coffee(name, 100);
13. return coffee;
14. }
15. }

4、mvc:annotation-driven

在你的spring配置文件中，启用mvc:annotation-driven注解。

1. <beans xmlns="http://www.springframework.org/schema/beans"
2. xmlns:context="http://www.springframework.org/schema/context"
3. xmlns:mvc="http://www.springframework.org/schema/mvc"
4. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5. xsi:schemaLocation="
6. http://www.springframework.org/schema/beans
7. http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
8. http://www.springframework.org/schema/context
9. http://www.springframework.org/schema/context/spring-context-3.0.xsd
10. http://www.springframework.org/schema/mvc
11. http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">
12. <context:component-scan base-package="com.mkyong.common.controller" />
13. <mvc:annotation-driven />
14. </beans>

或者，你也可以添加spring-oxm.jar依赖，并用以下的MarshallingView处理转换，使用这种方法，你可以不用在方法中使用@ResponseBody注解。

1. <beans ...>
2. <bean class="org.springframework.web.servlet.view.BeanNameViewResolver" />
3. <bean id="xmlViewer"
4. class="org.springframework.web.servlet.view.xml.MarshallingView">
5. <constructor-arg>
6. <bean class="org.springframework.oxm.jaxb.Jaxb2Marshaller">
7. <property name="classesToBeBound">
8. <list>
9. <value>com.mkyong.common.model.Coffee</value>
10. </list>
11. </property>
12. </bean>
13. </constructor-arg>
14. </bean>
15. </beans>

5、示例结果

访问URL:http://localhost:8080/SpringMVC/rest/coffee/arabica

原文链接：http://www.mkyong.com/spring-mvc/spring-3-mvc-and-json-example/