本章通过完成Spring Boot基础项目的构建并实现一个简单的Http请求处理,让大家对Spring Boot有一个初步的了解,并体验其结构简单、开发快速的特性。预计阅读及演练过程将花费约5分钟。
使用Maven构建项目
- 通过
SPRING INITIALIZR
工具生成基础项目- 访问:
http://start.spring.io/
- 填写group(例如com.v5ent),选择构建工具
Maven Project
、Spring Boot版本以及一些工程基本信息,可参考下图 - 点击
Generate Project
下载项目压缩包
- 访问:
- 解压项目包,以
Maven
项目形式导入到IDE中
项目结构解析
通过上面步骤完成了基础项目结构的创建,Spring Boot的基础结构共三个文件:
-
src/main/java
下的程序入口:DemoApplication
-
src/main/resources
下的配置文件:application.properties
-
src/test/
下的测试入口:DemoApplicationTests
生成的DemoApplication
和DemoApplicationTests
类都可以直接运行来启动当前创建的项目,由于目前该项目未配合任何数据访问或Web模块,程序会在加载完Spring之后结束运行。
引入Web模块
当前的pom文件已经
引入了两个模块:
-
spring-boot-starter
:核心模块,包括自动配置支持、日志和YAML -
spring-boot-starter-test
:测试模块,包括JUnit、Hamcrest、Mockito
我们需添加spring-boot-starter-web
模块:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
编写HelloWorld服务
- 创建
package
命名为com.v5ent.demo.web
- 创建
HelloController
类,内容如下
@RestController
public class HelloController {
@RequestMapping("/hello")
public String index() {
return "Hello World";
}
}
- 启动主程序,打开浏览器访问
http://localhost:8080/hello
,可以看到页面输出Hello World
编写单元测试用例
打开src/test/
下的测试入口DemoApplicationTests
类。下面编写一个简单的单元测试来模拟http请求,具体如下:
@RunWith(SpringRunner.class)
@SpringBootTest
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()
函数中。
注意引入下面内容:
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;
Ok,跑起来,完全和预想的一样。至此已完成本章目标,通过Maven构建了一个空白Spring Boot项目,再通过引入web模块实现了一个简单的请求处理。
如此快速、开箱即用,爽到飞起。