Spring Boot（1）— Spring Boot快速入门

基础项目构建，引入web模块，完成一个简单的RESTful API

简介

在您第1次接触和学习Spring框架的时候，是否由于其繁杂的配置而退却了？在你第n次使用Spring框架的时候，是否以为一堆反复黏贴的配置有一些厌烦？那么您就不妨来试试使用Spring Boot来让你更易上手，更简单快捷地构建Spring应用！

Spring Boot让咱们的Spring应用变的更轻量化。好比：你能够仅仅依靠一个Java类来运行一个Spring引用。你也能够打包你的应用为jar并经过使用java -jar来运行你的Spring Web应用。

Spring Boot的主要优势：

• 为全部Spring开发者更快的入门；
• 开箱即用，提供各类默认配置来简化项目配置；
• 内嵌式容器简化Web项目；
• 没有冗余代码生成和XML配置的要求。

快速入门

本章主要目标完成Spring Boot基础项目的构建，而且实现一个简单的Http请求处理，经过这个例子对Spring Boot有一个初步的了解，并体验其结构简单、开发快速的特性。

系统要求：

• Java 7及以上；
• Spring Framework 4.1.5及以上；

本文采用Java 1.8.0_73、Spring Boot 1.5.10调试经过。

使用Maven构建项目

1. 经过SPRING INITIALIZR工具产生基础项目；
   
   1. 访问：http://start.spring.io/；
   2. 选择构建工具Maven Project、Spring Boot版本1.3.2以及一些工程基本信息，可参考下图所示：
      
   3. 点击Generate Project下载项目压缩包；
2. 解压项目包，并用IDE以Maven项目导入，以Eclipse Spring Tool Suite为例：
   
   1. 菜单中选择File–>import–>Existing Maven Projects...
   2. 选择解压后的项目文件夹，点击Finish
   3. 若你的环境有多个版本的JDK，注意选择Java SDK的时候请选择Java 7以上的版本

项目结构解析

经过上面步骤完成了基础项目的建立，如上图所示，Spring Boot的基础结构共三个文件（具体路径根据用户生成项目时填写的Group全部差别）：

• src/main/java下的程序入口：Chapter1Application
• src/main/resources下的配置文件：application.properties
• src/test/下的测试入口：Chapter1ApplicationTests

生成的Chapter1Application和Chapter1ApplicationTests类均可以直接运行来启动当前建立的项目，因为目前该项目未配合任何数据访问或Web模块，程序会在加载完Spring以后结束运行。

引入Web模块

当前的pom.xml内容以下，仅引入了两个模块：

- spring-boot-starter：核心模块，包括自动配置支持、日志和YAML
     - spring-boot-starter-test：测试模块，包括JUnit、Hamcrest、Mockito

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

引入Web模块，需添加spring-boot-starter-web模块：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

编写HelloWorld服务

• 建立package命名为com.didispace.web（根据实际状况修改）
• 建立HelloController类，内容以下：

@RestController
public class HelloController {

    @RequestMapping("/hello")
    public String index() {
        return "Hello World";
    }
}

启动主程序，打开浏览器访问http://localhost:8080/hello，能够看到页面输出Hello World。

编写单元测试用例

打开的src/test/下的测试入口Chapter1ApplicationTests类。下面编写一个简单的单元测试来模拟http请求，具体以下：

package com.didispace.Chapter1;

import static org.hamcrest.CoreMatchers.equalTo;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.http.MediaType;
import org.springframework.test.context.junit4.SpringRunner;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;

import com.didispace.Chapter1.web.HelloController;

@RunWith(SpringRunner.class)
@SpringBootTest
@AutoConfigureMockMvc
public class Chapter1ApplicationTests {

    private MockMvc mvc;

    @Before
    public void setUp() throws Exception {
        mvc = MockMvcBuilders.standaloneSetup(new HelloController()).build();
    }

    @Test
    public void getHello() throws Exception {
        mvc.perform(MockMvcRequestBuilders.get("/hello").accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("Hello World")));
    }
}

注意引入下面内容，让status、content、equalTo函数可用：

import static org.hamcrest.Matchers.equalTo;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

至此已完成目标，经过Maven构建了一个空白Spring Boot项目，再经过引入web模块实现了一个简单的请求处理。

完整示例Chapter1