SpringMVC实现Restful风格的WebService

1.环境

---

• JDK7
• MyEclipse2014
• tomcat8
• maven 3.3.3
• spring4.1.4

2.创建maven工程

---

　　使用MyEclipse创建maven工程的方式可以参考这篇博文(链接1), 该博文中的第四小结是关于如何创建SpringMVC+maven教程。下面只给出创建好的目录结构，其中的部分文件如java程序是后面要完成的。

　　

3.指定依赖文件

---

　　maven具有特定的文件结构，并通过pom.xml来管理工程。下面是在实现Restful时需要的依赖。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.dy.xidian</groupId>
  <artifactId>transport</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>
  <name>transport Maven Webapp</name>
  <url>http://maven.apache.org</url>
  
  <properties>
    <spring.version>4.1.4.RELEASE</spring.version>
  </properties>
  
  <dependencies>
      <dependency>
         <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <!-- web项目编译时需要，部署到tomcat中就不需要了 -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
    <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.2</version>
    <scope>provided</scope>
    </dependency>
 
    <dependency>
         <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-databind</artifactId>
      <version>2.3.4</version>
    </dependency>
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
       <artifactId>jackson-annotations</artifactId>
      <version>2.4.0</version>
    </dependency>
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-core</artifactId>
      <version>2.4.3</version>
    </dependency>
  </dependencies>
 
  <build>
    <finalName>transport</finalName>
  </build>
</project>

 4.配置web.xml

---

　　web.xml的配置过程十分简单，只需指定dispatchServlet即可。

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>
  
  <context-param>
       <param-name>contextConfigLocation</param-name>
     <param-value>/WEB-INF/transport-servlet.xml</param-value>
  </context-param>
  <servlet>    
        <servlet-name>transport</servlet-name>    
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>    
        <load-on-startup>1</load-on-startup>
    </servlet>    
   <servlet-mapping>    
       <servlet-name>transport</servlet-name>  
       <url-pattern>/</url-pattern>    
    </servlet-mapping>  
  <listener>
      <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>
</web-app>

5.配置spring的配置文件(spring-servlet.xml)

---

　　配置该文件时，约束文档要指定成spring4的约束，因为spring4实现了对restful的支持。

<?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:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context 
        http://www.springframework.org/schema/context/spring-context-4.1.xsd
        http://www.springframework.org/schema/mvc
         http://www.springframework.org/schema/mvc/spring-mvc-4.1.xsd">

    <mvc:annotation-driven />
    <context:component-scan base-package="com.dy.xidian" />
</beans>

6.controller的实现

---

　　前面是已经把准备工作做完了，下面进入编程阶段。关于Restful风格的webService相信大家已经做过功课了，这里不在累述。因为应答是json格式，所以我们需要进行下面的工作。

6.1建立bean类

　　在开始的图片中，我们可以看到有个Greeting.java类，它其实就是一个bean类，具体代码如下。

package com.dy.xidian;

public class Greeting {
    private final long id;
    private final String content;

    public Greeting(long id, String content) {
        this.id = id;
        this.content = content;
    }

    public long getId() {
        return id;
    }

    public String getContent() {
        return content;
    }
}

6.2 在控制器中处理请求

　　SpringMVC会将请求交给一个控制器来处理，所以我们必须实现这样一个控制器，不过这个控制器在编写时要遵循restful风格。

　　GreetingController.java

package com.dy.xidian;

import java.util.concurrent.atomic.AtomicLong;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class GreetingController {
    private static final String template = "Hello, %s!";
    private final AtomicLong counter = new AtomicLong();

    @RequestMapping("/getuser")
    public Greeting greeting(
            @RequestParam(value = "name", defaultValue = "World") String name) {
        return new Greeting(counter.incrementAndGet(), String.format(template,
                name));
    }
}

虽然控制器返回的是一个Greeting对象，但是Spring会通过Jackson工具将其转换为一个json串。

7.访问

---

　　注意访问时输入的URL

　　

8.参考文章

---

　　博文1：http://bbs.51cto.com/thread-1131636-1.html

　　博文2：http://www.blogjava.net/soken/articles/371548.html

　　博文3：http://wiselyman.iteye.com/blog/2002446