从零开始完整搭建 Spring-Boot 项目开发框架的教程

前言

难度：简单
类型：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的示例结束

做者：mcjiffy 连接：https://www.jianshu.com/p/512f84c439d8 來源：简书