本章通过完成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
:核心模块,包括自动配置支持、日志和YAMLspring-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模块实现了一个简单的请求处理。
如此快速、开箱即用,爽到飞起。