Day06_02_Spring Boot教程之SpringBoot快速实现

SpringBoot快速实现

一. 快速入门

有很多方法可以快速创建Spring boot项目,可以通过idea的Spring boot initialization来创建,也可以通过手工新建一个maven工程,然后引入Spring boot的dependency来完成Spring boot的工程导入,还可以通过Spring官网的来创建Spring boot项目.本教程采用Spring boot initialization来创建一个Spring boot项目.

二. 使用Spring initializer来构建项目

通过Spring initializer工具产生基础项目
访问: http://start.spring.io/
选择构建工具Maven Project、Spring Boot版本1.5.21以及一些工程基本信息,可参考下图所示Spring initializer.


点击Generate Project下载项目压缩包
解压项目包,并用IDE以Maven项目导入,以intelliJ IDEA为例:
菜单中选择File–>New–>Project from Existing Sources...
选择解压后的项目文件夹,点击OK
点击Import project from external model并选择Maven,然后一路点击Next到底finish为止.
若你的环境有多个版本的JDK,注意到选择Java SDK的时候请选择Java 7以上的版本.



三. 项目结构解析



通过上面步骤完成了基础项目的创建,如上图所示,Spring Boot的基础结构共三个文件(具体路径根据用户生成项目时填写的Group所有差异):

创建完成后的工程目录结构如下：

│  .gitignore
│  pom.xml
│
│
└─src
    ├─main
    │  ├─java
    │  │  └─com
    │  │      └─syc
    │  │          └─boot
    │  │              └─demo
    │  │                          DemoApplication.java
    │  │
    │  └─resources
    │      │  application.properties
    └─test
        └─java
            └─com
                └─syc
                    └─boot
                        └─demo
                                    DemoApplicationTests.java

• src/main/java下的程序入口:DemoApplication;
• src/main/resources下的配置文件:application.properties
• src/test/下的测试入口:DemoApplicationTests.
• .gitignore：Git 过滤配置文件
• pom.xml：Maven 的依赖管理配置文件
• DemoApplication.java：程序入口
• resources：资源文件目录
  • static: 静态资源文件目录
  • templates：模板资源文件目录
  • application.properties：Spring Boot 的配置文件，实际开发中会替换成 YAML 语言配置（application.yml）

生成的DemoApplication和DemoApplicationTests类都可以直接运行来启动当前创建的项目,由于目前该项目未配合任何数据访问或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.syc.boot.demo.web(根据实际情况修改).


注意:DemoApplication启动类一定要在最外层!!!否则可能会出现404

创建HelloController类,内容如下:

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

启动主程序,打开浏览器访问http://localhost:8080/hello,
可以看到页面输出Hello World



神奇之处

• 没有配置 web.xml;
• 没有配置 application.xml，Spring Boot 帮你配置了;
• 没有配置 application-mvc.xml，Spring Boot 帮你配置了;
• 没有配置 Tomcat,Spring Boot 内嵌了 Tomcat 容器.

六. 编写单元测试用例

打开的src/test/下的测试入口DemoApplicationTests类,下面编写一个简单的单元测试来模拟http请求,具体如下:

@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = MockServletContext.class)
@WebAppConfiguration
public class DemoApplicationTests {

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

使用MockServletContext来构建一个空的WebApplicationContext,这样我们创建的HelloController就可以在@Before函数中创建并传递到MockMvcBuilders.standaloneSetup（）函数中.

执行getHello()测试方法,运行正常.


注意引入下面内容,让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模块实现了一个简单的web请求.