一起来学SpringBoot | 第五篇：使用JdbcTemplate访问数据库

我就是我 2022-05-23 03:56 249阅读 0赞

>  *  **本文作者：**唐亚峰
>  *  **本文链接：**[http://blog.battcn.com/2018/05/07/springboot/v2-orm-jdbc/][http_blog.battcn.com_2018_05_07_springboot_v2-orm-jdbc]
>  *  **版权声明：**本博客所有文章除特别声明外，均采用[CC BY-NC-SA 3.0][]许可协议。转载请注明出处！

--------------------

> `SpringBoot`是为了简化`Spring`应用的创建、运行、调试、部署等一系列问题而诞生的产物，**`自动装配的特性让我们可以更好的关注业务本身而不是外部的XML配置，我们只需遵循规范，引入相关的依赖就可以轻易的搭建出一个 WEB 工程`**

## 更多干货： ##

[SpringBoot系列博客目录，含1.5.X版本和2.X版本][SpringBoot_1.5.X_2.X]

`Spring Framework`对数据库的操作在`JDBC`上面做了深层次的封装，通过`依赖注入`功能，可以将`DataSource`注册到`JdbcTemplate`之中，使我们可以轻易的完成对象关系映射，并有助于规避常见的错误，在`SpringBoot`中我们可以很轻松的使用它。

> 特点

*  速度快，对比其它的ORM框架而言，JDBC的方式无异于是最快的
 *  配置简单，`Spring`自家出品，几乎没有额外配置
 *  学习成本低，毕竟`JDBC`是基础知识，`JdbcTemplate`更像是一个`DBUtils`

## 导入依赖 ##

在`pom.xml`中添加对`JdbcTemplate`的依赖

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

## 连接数据库 ##

在`application.properties`中添加如下配置。值得注意的是，SpringBoot默认会自动配置`DataSource`，它将优先采用`HikariCP`连接池，如果没有该依赖的情况则选取`tomcat-jdbc`，如果前两者都不可用最后选取`Commons DBCP2`。**通过`spring.datasource.type`属性可以指定其它种类的连接池**

server.port=1111
    spring.datasource.url=jdbc:mysql://localhost:3306/chapter4?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true&useSSL=false
    spring.datasource.password=root
    spring.datasource.username=root
    #spring.datasource.type
    #更多细微的配置可以通过下列前缀进行调整
    #spring.datasource.hikari
    #spring.datasource.tomcat
    
    #spring.datasource.dbcp2

启动项目，通过日志，可以看到默认情况下注入的是`HikariDataSource`

2018-06-01 13:23:01.038  INFO 45277 --- [           main] o.s.j.e.a.AnnotationMBeanExporter        : Bean with name 'dataSource' has been autodetected for JMX exposure
    2018-06-01 13:23:01.044  INFO 45277 --- [           main] o.s.j.e.a.AnnotationMBeanExporter        : Located MBean 'dataSource': registering with JMX server as MBean [com.zaxxer.hikari:name=dataSource,type=HikariDataSource]
    2018-06-01 13:23:01.116  INFO 45277 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
    2018-06-01 13:23:01.122  INFO 45277 --- [           main] c.w.SpringBootJdbctemplateApplication    : Started SpringBootJdbctemplateApplication in 6.716 seconds (JVM running for 9.518)

## 具体编码 ##

完成基本配置后，接下来进行具体的编码操作。**为了减少代码量，就不写`UserDao`、`UserService`之类的接口了，将直接在`Controller`中使用`JdbcTemplate`进行访问数据库操作，这点是不规范的，各位别学我…**

### 表结构 ###

创建一张`t_user`的表

CREATE TABLE `t_user` ( `id` int(8) NOT NULL AUTO_INCREMENT COMMENT '主键自增', `username` varchar(50) NOT NULL COMMENT '用户名', `password` varchar(50) NOT NULL COMMENT '密码', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='用户表';

### 实体类 ###

package com.winterchen.domain;
    
    /** * Created by Donghua.Chen on 2018/6/1. */
    public class User { 
    
        private Long id;
        private String username;
        private String password;
    
        // TODO 省略get set
    }

### restful 风格接口 ###

package com.winterchen.controller;
    
    import com.winterchen.domain.User;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.jdbc.core.BeanPropertyRowMapper;
    import org.springframework.jdbc.core.JdbcTemplate;
    import org.springframework.web.bind.annotation.*;
    
    import java.util.List;
    
    /** * Created by Donghua.Chen on 2018/6/1. */
    @RestController
    @RequestMapping("/users")
    public class SpringJdbcController { 
    
        private final JdbcTemplate jdbcTemplate;
    
        @Autowired
        public SpringJdbcController(JdbcTemplate jdbcTemplate) {
            this.jdbcTemplate = jdbcTemplate;
        }
    
        @GetMapping
        public List<User> queryUsers() {
            // 查询所有用户
            String sql = "select * from t_user";
            return jdbcTemplate.query(sql, new Object[]{}, new BeanPropertyRowMapper<>(User.class));
        }
    
        @GetMapping("/{id}")
        public User getUser(@PathVariable Long id) {
            // 根据主键ID查询
            String sql = "select * from t_user where id = ?";
            return jdbcTemplate.queryForObject(sql, new Object[]{id}, new BeanPropertyRowMapper<>(User.class));
        }
    
        @DeleteMapping("/{id}")
        public int delUser(@PathVariable Long id) {
            // 根据主键ID删除用户信息
            String sql = "DELETE FROM t_user WHERE id = ?";
            return jdbcTemplate.update(sql, id);
        }
    
        @PostMapping
        public int addUser(@RequestBody User user) {
            // 添加用户
            String sql = "insert into t_user(username, password) values(?, ?)";
            return jdbcTemplate.update(sql, user.getUsername(), user.getPassword());
        }
    
    
        @PutMapping("/{id}")
        public int editUser(@PathVariable Long id, @RequestBody User user) {
            // 根据主键ID修改用户信息
            String sql = "UPDATE t_user SET username = ? ,password = ? WHERE id = ?";
            return jdbcTemplate.update(sql, user.getUsername(), user.getPassword(), id);
        }
    }

### 测试 ###

由于上面的接口是 restful 风格的接口，添加和修改无法通过浏览器完成，所以需要我们自己编写`junit`或者使用`postman`之类的工具。

所以我们使用postman进行测试：

> 新增数据

![新增数据][WX20180601-142040_2x.png]

> 查询数据

![查询数据][WX20180601-142111_2x.png]

## 总结 ##

本章介绍了`JdbcTemplate`常用的几种操作，详细请参考[JdbcTemplate API文档][JdbcTemplate API]

目前很多大佬都写过关于**`SpringBoot`**的教程了，如有雷同，请多多包涵，本教程基于最新的`spring-boot-starter-parent：2.0.1.RELEASE`编写，包括新版本的特性都会一起介绍…

## 说点什么 ##

springboot技术交流群：681513531

个人博客：[https://winterchen.com][https_winterchen.com]

全文代码：[https://github.com/WinterChenS/springboot-learning-experience][https_github.com_WinterChenS_springboot-learning-experience]

*  **本文作者：**唐亚峰
 *  **本文链接：**[http://blog.battcn.com/2018/05/07/springboot/v2-orm-jdbc/][http_blog.battcn.com_2018_05_07_springboot_v2-orm-jdbc]
 *  **版权声明：**本博客所有文章除特别声明外，均采用[CC BY-NC-SA 3.0][]许可协议。转载请注明出处！

[http_blog.battcn.com_2018_05_07_springboot_v2-orm-jdbc]: http://blog.battcn.com/2018/05/07/springboot/v2-orm-jdbc/
[CC BY-NC-SA 3.0]: https://creativecommons.org/licenses/by-nc-sa/3.0/
[SpringBoot_1.5.X_2.X]: https://blog.csdn.net/Winter_chen001/article/details/80537829
[WX20180601-142040_2x.png]: /images/20220523/386aa47147dd4ed5ab32e863024b150a.png
[WX20180601-142111_2x.png]: /images/20220523/4aba65bb41ee47f1a928e2b2ed5aab6e.png
[JdbcTemplate API]: https://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/jdbc/core/JdbcTemplate.html
[https_winterchen.com]: https://winterchen.com
[https_github.com_WinterChenS_springboot-learning-experience]: https://github.com/WinterChenS/springboot-learning-experience