Spring Boot起步：a RESTful Web Serv

本文将讲述如何通过使用Spring Boot 快速起步搭建web服务。

最终实现：

位于如下位置的HTTP服务，

http://localhost:8080/greeting

返回如下JSON数据：

{"id":1,"content":"Hello, World!"}

或带有name参数：

http://localhost:8080/greeting?name=User
//Response
{"id":1,"content":"Hello, User!"}

前提：

• IDEA
• JDK 1.8
• Maven 3.0+

创建工程：

1. IDEA选择Create New Project。 创建工程-1.png
2. 确定Java版本，选择Maven工程。 创建工程-2.png
3. 自己起一个GroupID和ArtifactId吧。IDEA会根据ArtifactId自动生成工程名。下面的Version会体现在pom.xml中。 创建工程-3.png
4. 最后一步可以手动修改工程名称以及存储位置。点击Finish。 创建工程-4.png
5. 修改pom.xml文件，引入依赖：

<?xml version="1.0" encoding="UTF-8"?>
<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>org.springframework</groupId>
    <artifactId>gs-rest-service</artifactId>
    <version>0.1.0</version>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.1.RELEASE</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.jayway.jsonpath</groupId>
            <artifactId>json-path</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
    <repositories>
        <repository>
            <id>spring-releases</id>
            <url>https://repo.spring.io/libs-release</url>
        </repository>
    </repositories>
    <pluginRepositories>
        <pluginRepository>
            <id>spring-releases</id>
            <url>https://repo.spring.io/libs-release</url>
        </pluginRepository>
    </pluginRepositories>
</project>

1. 此时IDEA会出现如下提示，选择Enable Auto-Import。（或者在工程根目录命令行输入mvn compile）
   创建工程-5.png

书写代码

创建Model

我们将Greeting的主要逻辑实现在Greeting中：
src/main/java/hello/Greeting.java

package hello;

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;
    }
}

创建Controller

在Spring中，请求由controller来处理。Spring通过@RestController
注解轻松识别controller。
我们实现的GreetingController处理对greeting的请求，并返回Greeting类的新实例。
src/main/java/hello/GreetingController.java

package hello;

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("/greeting")
    public Greeting greeting(@RequestParam(value="name", defaultValue="World") String name) {
        return new Greeting(counter.incrementAndGet(),
                            String.format(template, name));
    }
}

其中:

1. @RequestMapping注解将发送到/greeting的http请求映射到greeting()方法。
2. @RequestParam将请求中name参数的值映射到greeting()方法的name参数，并提供了defaultValue.

创建应用入口

按照传统方式，我们已经可以将上述内容打包为war文件，并上传至tomcat运行。但Spring Boot可以帮助我们快速创建包含内嵌tomcat的独立应用。
src/main/java/hello/Application.java

package hello;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

其中：

1. @SpringBootApplication注解用以标注SpringBoot应用。
2. SpringApplication.run()方法启动应用。

运行程序

此时程序已经可以运行了。如果用IDEA，直接点击run；如果不用，在命令行输入mvn spring-boot:run。

Paste_Image.png

运行结果

Result-1.png Result-2.png

可以注意到id从1变化为2，可以说明即使有多个请求，GreetingController也只有一个实例，counter根据每次请求增长。

总结

以上，我们已经成功使用Spring Boot建立了一个Restful web service。

参考：http://spring.io/guides/gs/rest-service/