Spring Boot 系列 | 第一篇:快速创建一个简单的应用
2018-01-30 20:28
931 查看
Spring Boot 系列 | 第一篇:快速创建一个简单的应用
前言
本人由一个Android开发者转向学习后端的第一个学习的内容就是Spring Boot,虽然有系统了解过Spring/Spring MVC 相关的知识, 但是在学习Spring Boot的过程中会出现各种各样的问题,在学习Spring Boot的时候会出现一个现象:当你遇到问题的时候,上网百度,然后出现了几种方案,有一些是可以的,有一些是不行的,出现这个原因有可能是因为别人的问题解决方案是基于某个版本的,但是版本更新之后又不一样了。或者有时候配置一些东西的时候又会有一些疑惑,有些东西配不配都可以,有些不配置又会报错,这种现象我觉得很可怕,因为不了解一样东西。你不知道它做了什么。你只知道这样配置了就可以了,上网想找一些官方的文档,又不知道在哪里找,这么多starter到底帮你做了什么事。完全一头雾水,所以想自己做一个系列的笔记,把每一个知识点记录一下。本文不算原创(参考了网上相关博客资料),也不做任何声明,仅仅是作为笔者的笔记记录。
环境
Mac 系统IDEA
Maven 3
JAVA 8
使用IDEA创建项目
菜单选择:File -> New -> Project选中Spring Initializr
点击Next,到了工程信息界面,在这个界面可以配置工程名称,类型(Maven或者Gradle)打包方式(jar或者war)还有一些其他基本信息,可以根据自己需要进行改动。目前什么都不改动。
再次点击Next,就会进入Spring Boot的版本号和相关依赖,我的Spring Boot 版本为1.5.9
什么都不用选择,点击Next 进入设置项目名称和项目存储位置的页面
点击Finish,等待一会儿就会进入项目
编写Hello World
项目结构如下:打开
pom.xml之后显示如下内容:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.example</groupId> <artifactId>demo</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>demo</name> <description>Demo project for Spring Boot</description> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.9.RELEASE</version> <relativePath/> <!-- lookup parent from repository --> </parent> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <java.version>1.8</java.version> </properties> <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> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>
可以看到项目会默认依赖了
spring-boot-starter和
srping-boot-starter-test,这两个依赖一个是启动
Spring Boot的依赖,一个是Junit的相关依赖,为了开发一个HelloWorld程序。在
dependencies节点用
spring-boot-start-web替换
spring-boot-starter依赖以便提供Web服务。
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
修改后的
pom.xml如下:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging>
<name>demo</name>
<description>Demo project for Spring Boot</description>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.9.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
修改了
pom文件之后maven会下载相关依赖,需要等待一段时间.
然后新建一个
HelloController
package com.example.demo.controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestCon @RestController public class HelloController { @RequestMapping("/") public String index() { return "Greetings from Spring Boot!"; } }
这个类里面用了2个注解,
@RestController结合了
@Controller和
@ResponseBody用于标识Web请求返回的是数据而不是视图,
@RequestMapper标识了访问的路径,将“/”映射到了
index方法中.
运行
然后将鼠标放到DemoApplication类点击右键选择
run DemoApplication即可把应用启动,我们查看控制台输出:
Tomcat started on port(s): 8080 (http) Started DemoApplication in 2.965 seconds (JVM running for 3.582) Initializing Spring FrameworkServlet 'dispatcherServlet'
可以看到Tomcat启动绑定了8080端口,所以我们在浏览器输入
http://localhost:8080即可看到输出
Greetings from Spring Boot!
至此已经使用
Spring Boot写了一个
Hello world程序,并且把它启动起来。
测试接口
默认情况下,新建的Spring Boot程序会帮我们加入了Spring Test,在pom.xml中可以看到以下内容<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency>
如果没有,请自行添加。
下面开始编写一个简单的测试程序:
在src->test包目录下新建一个
HelloControllerTest类:
使用Mock框架测试:
package com.example.demo; import org.hamcrest.Matchers; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.beans.factory.annotation.Autowired; 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.result.MockMvcResultMatchers; @RunWith(SpringRunner.class) @SpringBootTest @AutoConfigureMockMvc public class HelloControllerTest { @Autowired private MockMvc mvc; @Test public void hello() throws Exception { mvc.perform(MockMvcRequestBuilders.get("/").accept(MediaType.APPLICATION_JSON)) .andExpect(MockMvcResultMatchers.status().isOk()) .andExpect(MockMvcResultMatchers.content().string(Matchers.equalTo("Greetings from Spring Boot!"))); } }
运行
hello方法就可以对
HelloController进行断言测试
或者不使用Mock框架测试:
package com.example.demo; import org.hamcrest.Matchers; import org.junit.Assert; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.context.embedded.LocalServerPort; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.boot.test.web.client.TestRestTemplate; import org.springframework.http.MediaType; import org.springframework.http.ResponseEntity; import org.springframework.test.context.junit4.SpringRunner; import org.springframework.test.web.servlet.request.MockMvcRequestBuilders; import org.springframework.test.web.servlet.result.MockMvcResultMatchers; import java.net.MalformedURLException; import java.net.URL; @RunWith(SpringRunner.class) @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) public class HelloControllerTest { @LocalServerPort private int port; private URL base; @Autowired TestRestTemplate testRestTemplate; @Before public void setUp() throws MalformedURLException { this.base = new URL("http://localhost:" + port + "/"); } @Test public void hello() throws Exception { ResponseEntity<String> respons = testRestTemplate.getForEntity(base.toString(), String.class); Assert.assertThat(respons.getBody(),Matchers.equalTo("Greetings from Spring Boot!")); } }
通过
webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT让内嵌服务器跑在任意一个端口,实际上的端口通过
@LocalServerPort获取。
总结
此篇记录了使用IDEA快速创建一个Spring Boot的程序,并实现了
Hello World接口,对接口测试方式进行介绍。
相关文章推荐
- IDEA-------(二)快速创建一个简单的Spring boot项目
- 利用Maven快速创建一个简单的spring boot 实例
- 利用Maven快速创建一个简单的spring boot 实例
- 怎样借助Spring boot快速实现一个简单的http服务器
- 使用Gradle创建一个最简单的Spring Boot项目
- spring cloud教程之使用spring boot创建一个应用
- 5分钟创建一个SpringBoot + Themeleaf的HelloWord应用
- SpringCloud微服务系列(2): 创建一个基于Springboot的RESTFul服务
- 快速创建一个SpringBoot项目
- 如何快速创建一个Spring Boot项目
- spring cloud教程之使用spring boot创建一个应用
- spring cloud教程之使用spring boot创建一个应用
- SpringBoot入门学习一(如何使用IDEA创建一个SpringBoot应用)
- spring cloud教程之使用spring boot创建一个应用
- spring cloud教程之使用spring boot创建一个应用
- spring cloud教程之使用spring boot创建一个应用
- 【SpringBoot】2.快速搭建一个SpringBoot应用
- SpringBoot入门系列:eclipse如何构建一个最简单的springBoot项目。
- Spring Boot整合Dubbo开发系列(一)----一个简单的示例