SpringBoot入门与RESTful API的实现

一，Hello World

IDE：Intellij IDEA 2016.2.4

JDK：1.8

1，创建项目：

创建Spring Boot项目

设置项目基础信息

选择需要使用的第三方依赖

启动

至此，就创建了一个简单的Spring jar程序。

2，目录与文件说明

src/main/java下的程序入口：SpringBootHelloworldApplication

src/main/resources下的配置文件：application.properties

src/test/下的测试入口：SpringBootHelloworldApplicationTests

pom.xml

1：spring项目的基础信息，一个jar包项目。

2：每个spring boot项目必有 parent。

3：公共的属性设置，字符集，java版本等。

4：基础依赖。spring-boot-starter：核心模块，包括自动配置支持、日志和YAML

5：单元测试的依赖。spring-boot-starter-test：测试模块，包括JUnit、Hamcrest、Mockito

6：打包插件。

每个spring boot项目都有一个application。@SpringBootApplication 是 spring boot 的核心全局注解。

3，工程项目升级

当前只是一个最简单的 jar 包项目，运行一下就结束了。接着实现一个简单的web服务。

a，pom.xml 追加如下依赖：

    <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-web</artifactId>

    </dependency>

spring-boot-starter依赖即可注释掉。

b，创建 ApiTestController 服务类：

ApiTestController2V 服务类使用复合注解：

@Controller：修饰class，用来处理http请求的对象

@RestController：Spring4之后新加入，原来在@Controller中返回json需要@ResponseBody来配合，现在用@RestController替代即可，默认返回json格式，是 @Controller 与 @ResponseBody 的复合注解。

@RequestMapping：配置url映射

注：1，如果项目前后台分离，纯接口的，使用 @RestController 即可；

        2，如果项目前后台混合，使用 @Controller ，接口的方法，加 @ResponseBody。

        3，@RequestMapping 后面指定请求方法时，默认是支持所有请求方法的（get，put，delete，post等）。

c，配置启动

当前程序启动后，默认8080端口，可修改 application.properties 文件。

访问： http://localhost:8071/spring_boot_hello/v1/apiTest/hello 和  http://localhost:8071/spring_boot_hello/v2/apiTest/hello

注：也可以将项目打包，用 java 命令运行。

#打包

mvn clean install

#运行

java -jar springboot_helloworld-0.0.1-SNAPSHOT.jar

4，编写单元测试

在 src/test/ 下，创建 ApiTestController 的测试类 ApiTestControllerTests，来模拟http请求测试。

右击运行该单元测试case。

注：因为有中文，所以，MediaType 设置为 APPLICATION_JSON_UTF8，否则会报错。

三，RESTful API的实现

1，创建 ApiRestFullTestController 服务类：

2，编写单元测试

在 src/test/ 下，创建 ApiRestFullTestController 的测试类 ApiRestFullTestControllerTests。

右击运行该单元测试case。

注：切记，因为有中文，所以，MediaType 设置为 APPLICATION_JSON_UTF8，否则会报错。

补充：1，spring 启动时，控制台界面：

通过，在 resources 目录下创建 banner.txt 文件，输入：

重新启动后：

例：springBoot_Helloworld