前言
难度：简单
类型：step-by-step
适用：初学者，完全没有接触过 Spring-Boot
开发环境：jdk 1.8
关键词：java, sring-boot, spring-mvc, restful
笔者环境：macOS
1. 项目创建
1.1 使用脚手架生成项目
打开 http://start.spring.io/ 网站，选择Gradle ，依赖项选择Web（网站）、DevTools（开发工具）、JPA（ORM）、MySQL（数据库）、Thymeleaf（模板）。
如下图所示：
start.spring.io
2. 项目配置
2.1 配置 application.properties
打开~demo/src/main/resource/application.properties文件，添加必要配置，如下：
#服务端口
server.port=8012
#mysql 配置
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
#mysql 链接字符串
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/test?useUnicode=true&characterEncoding=UTF-8&useSSL=false&autoReconnect=true&failOverReadOnly=false
#mysqly用户名和密码
spring.datasource.username=your_mysql_name
spring.datasource.password=your_mysql_password
#jap 配置，是否输出 sql
spring.jpa.show-sql=true
#thymeleaf配置
#开发环境关闭缓存
spring.thymeleaf.cache=false
spring.thymeleaf.encoding=utf-8
#设置使用非严格的HTML5校验
spring.thymeleaf.mode=LEGACYHTML5
#调整id生成策略
spring.jpa.hibernate.use-new-id-generator-mappings=false
2.2 配置 Application 主入口
打开类文件 demo/src/main/java/com/example/demo/DemoApplication.java
2.2.1 添加注解@ComponentScan
组件扫描，如果不添加，可能无法正确的@Autowired
2.2.2 添加注解@Configuration
声明配置，告诉 Spring，该类是bean 的配置类
2.2.3 完成后的样子
如下图：
DemoApplication
3. Resftful 接口的示例
3.1 添加数据表的 Entity 实体类
3.1.1假设有一个数据表test_user_info
结构如下图 :
表结构
插入一些测试数据：
测试数据
3.1.2 新建包名 entities
其中新建 Entity 实体 TestUserInfo,完整如下图：
TestUserInfo.java
其中@Entity 声明这是一个数据实体，因为表名和类名不一致，所以用@Table 告诉 Jpa，这个表名的具体名字。
@Id 声明了主键，@GeneratedValue声明了主键是自增的，
@Column 声明了字段名的真实名字，Jpa 大小写是代表下划线分割，所以只能传全部小写的字段名。
3.2 新建 Repository
3.2.1 新建包名 repositories
新建接口 TestUserInfoRepository，该接口继承自，，需要JpaRepository<T,ID>，T就是数据实体类，ID是类 id 字段的类型，如下图：
TestUserInfoRepository.java
@Repository 声明，告诉Spring-Boot，这是一个仓储的组件。
3.2.2 创建查询
因为 JpaData，采用的是规范契约的方式来声明查询，所以只要按照规范来创建接口中的方法，框架会自动生成对应的 sql 语句。如果有特殊需求，也可以用声明的方式写 sql 语句，例如：
TestUserInfoRepository.java
上下两条语句的效果一样，区别就是第一条按照规格来写，框架会自动提示字段的名字，定义了方法，框架会自动解析 sql，第二条框架会读取@Query中的 sql 使用。
3.3 创建 Service 服务
3.3.1 新建包名 services,
新建服务类TestInfoService，如下图
TesrInfoService.java
```@Service`` 声明了这是一个服务类。
3.3.2 关联 Repository
如下图，
自动关联
因为 TestUserInfoRepository 声明了@Repository，所以能够使用@Autowired 进行关联，这里要说明一点，SpringMvc 中的@Controller,@Service,@Repository 本质都是@Component，Spring-Boot 本质上能够使用@Autowired 进行关联的必须是有@Component声明，或者其子继承声明的才行。
3.3.3 创建查询方法
如下图，
查询方法
一个简单的服务查询类和方法。
3.4 创建 Model 实体
3.4.1 创建报名 models
TestUserInfoResponseModel用于接口返回相应 json 使用，如下图
TestUserInfoResponseModel.java
3.5 创建 Restful 的 Controller
3.5.1 创建包名 controllers
ApiController 类，如下图，
ApiController.java
@RestController 声明这是一个Restful 的控制器，@RequestMapping 声明了 url-route，是/api开头的。
3.5.2 关联 service
如下图，
关联 service
同 Repository 一样，TestUserInfoService 声明了@Service，所以他可以被@Autowired，前面讲过原因了。
3.5.3 创建 aciton方法
如下图，
action方法
@RequestMapping，声明了 action 的 url-route，那么这个action 的完整路径就是/api/get_user
另外，因为是 Restful 的 controller ，所以，如果不声明@ResponseBody 的话，就必须返回一个对象实体，框架会自动序列化成一个 json。
3.5.4 创建返回 plain 字符串的action
如下图，
plain action
声明了@ResponseBody，接口机会以纯文本的形式返回。
4. 请求测试
4.1 运行项目
4.1.1 点击运行，看到控制输出如下图，
console logs
看到端口的展示，代表运行成功了。
4.1.2 请求get_user接口
地址为：http://localhost:8012/api/get_user?name=test1
get_user
4.1.3 请求 get_plain 接口
地址为：http://localhost:8012/api/get_plain?name=test1
get_plain
4.1.4 至此，Restful 的项目 Demo 创建完毕。
5. 创建动态Web项目
5.1 创建 HomeController
并且关联service，如下图，
HomeController
@Controller 声明这是一个 web 的控制器，/home 是 url-route
5.2 创建 action
如下图，
index
@RequestMapping中 value 可以多一个，空白，代表可以省略，/home/index，或者/home都是请求这个 action。
方法返回的 String，是 ViewName，比如新建一个 index.html 的模板，这里使用就是返回字符串index。
参数中的 Model 是在模板中使用的 Model 实体，示例中把查询出来的实体，装入了 model的字典中，这样在前台模板就能使用。
5.3 另外一种 aciton
如果不太喜欢返回字符串，可以使用另外一种，如下图，
ModelAndView
返回 ModelAndView，这样自己实例化的 ModelAndView，传入模板的名字，还有前台需要使用的 model，就能避免返回字符串，我个人推荐使用第一种方式，会比较灵活。
5.4 创建模板页面
在/resource/templates 中创建index.html，如下图，
index.html
因为我们使用的是thymeleaf模板，所以html 中声明了 xmlns=th="http://www.thymeleaf.org"，这样在 html 种就能使用模板属性去绑定数据，控制元素。
span中的 th:text=“${model?.id}”，告诉了模板，这个span的text 设置为model?.id的值。带上?问号的意思是，model 可能为 null，这样不会报错，null 的时候，text 就是空。
model 就是我们在 action 传给 model的名字，id，name，age，就是 model 的字段。
5.5 运行请求
请求地址：http://localhost:8012/home/index?name=test1
如下图,
请求访问 index
请求另一个 aciton:
http://localhost:8012/home/test
请求访问test
5.6 至此动态 web的示例结束
想看有料有趣的 Github 精品项目，欢迎关注我的公众号：cool_github
或者搜索：GitHub精品推荐
GitHub精品推荐
网友评论