Spring Boot 精简使用教程
前言
- 本博客主要分享博主学习 Spring Boot 的过程,特别是学习的方式—— 查看官方文档的正确姿势(如果觉得有问题欢迎小伙伴们留言)。
- 学习一种技术,我们一般都希望尽量获取“第一手”资料。在本博客,博主会分享自己如何从 Spring Boot 官网中获取想要的信息,搭建自己的 Spring Boot 项目。
- Spring Boot 的项目有很多种,侧重点也不相同。本博客主要介绍如何创建 Spring Boot Web 项目并实现访问关系数据库(如 MySQL )的功能。
- 项目源代码:https://github.com/AndyWannaSing/SpringBootRestService
目录
- Spring Boot
创建 Spring Boot Web 项目
寻找 Spring Boot Web 项目创建教程
- 打开官网,选择 “GUIDES” 页面,搜索关键字 WEB,并点击打开“Building a RESTful Web Service ”的教程:
教程中的项目功能介绍
- 查看教程中的“What you’ll build”这一章节,可以看到项目介绍:
- 你将会创建一个服务接收以下 HTTP GET 请求:
http://localhost:8080/greeting
- 并响应一个 JSON 格式的问候:
{"id":1,"content":"Hello, World!"}
- 你也可以通过一个可选的
name
参数自定义一个问候:http://localhost:8080/greeting?name=User
- 这个
name
参数的值会覆盖默认值 “World”,最终返回以下响应:{"id":1,"content":"Hello, User!"}
- 此时,可以确认这个项目完全符合我们的要求
- 你将会创建一个服务接收以下 HTTP GET 请求:
开始项目创建
- 参考 “How to complete this guide” 这一章节内容,按部就班即可:
- 这里有两个选择:
- 从零开始创建。
- 跳过基础的部分(这部分代码从官网下载),直接编写和 WEB 项目相关的代码。
- 博主选择从零开始创建。因为博主主要使用 Maven 作为管理依赖的工具,所以这里选择 Build With Maven。没有选择 “Build with your IDE”是因为这个教程本质上只是简单的复制官网的代码,然后在自己的 IDE 上打开。
创建 Maven 项目
- 博主使用 Intellij IDEA 作为开发工具,所以,Build With Maven章节的内容只需要参考
pom.xml
文件部分,引入必需的依赖。- Intellij IDEA 上创建 Maven 项目:New ==》Project:
- 参考
pom.xml
文件部分,引入必需的依赖.
- 此时,项目的架子已经搭建起来了
- Intellij IDEA 上创建 Maven 项目:New ==》Project:
创建用于展示信息的类
- 创建用于展示信息的类。参考 “Create a resource representation class”,创建 Greeting 类。
创建处理 HTTP 请求的 Controller。
- 参考 “Create a resource controller”
创建程序启动类
- 参考“Make the application executable”。
构建程序。
- 要部署程序,参考“Build an executable JAR”。因为博主是在 IDE 上创建项目,所以直接执行程序启动类的 main 方法即可。
测试接口:
实现连接关系数据库的功能
- 实现数据库连接的功能,有很多种选择。博主这里分享最近比较流行的 MyBatis 框架与 Spring Boot 的整合。在开始之前,需要先去 Mybatis 官网简单了解一下框架的基础知识。
寻找Mybatis 和 Spring Boot 集成教程
- Mybatis 和 Spring Boot 集成教程官网地址:http://www.mybatis.org/spring-boot-starter/mybatis-spring-boot-autoconfigure/index.html
引入依赖
配置数据源
- 查看官网地址可以知道,mybatis 的工作流程如下:
- 所以,我们首先需要配置数据源。要找到数据源的配置方法,需要访问官网,查询文档:
- https://docs.spring.io/spring-boot/docs/2.1.3.RELEASE/reference/htmlsingle/#boot-features-configure-datasource
MyBatis 配置
- 在 application.yml 添加相应配置。配置内容参考:
创建访问数据库接口
- 创建展示类 User
- 创建 UserMapper 接口
- 创建 UserMapper 接口的配置文件 userMapper .xml
- 创建 mybatis-config 配置文件
- 创建 数据层操作对象 UserDao 类
- 创建 处理请求的 UserController 类