本章通过完成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下的程序入口:DemoApplicationsrc/main/resources下的配置文件:application.propertiessrc/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模块实现了一个简单的请求处理。
如此快速、开箱即用,爽到飞起。