Spring Boot 2实战之旅
上QQ阅读APP看书,第一时间看更新

4.2 使用JDBC操作数据库

JDBC的全名是Java DataBase Connectivity,可能是我们最先接触到的数据库连接,通过JDBC可以直接使用Java编程来操作数据库。其实我们可以这样理解JDBC,它就是一个可以执行SQL语句的Java API。

4.1节讲了很多数据库,本节以MySQL为例介绍Spring Boot使用JDBC操作MySQL数据库。

4.2.1 JDBC依赖配置

新建项目,在pom文件中加入JDBC依赖和MySQL依赖以及Web功能的依赖,如代码清单4-17所示。

4.2.2 配置数据库信息

在配置文件中配置数据库信息,与4.1节介绍的一样,配置文件内容如代码清单4-18所示。

4.2.3 创建实体类

创建一个实体类,用作接收表数据,这里省略set、get方法,代码如代码清单4-19所示。

4.2.4 使用Controller进行测试

新建一个UserController,由于这个类只是用来测试使用JDBC操作数据库,因此我们在类上加入@RestController注解,熟悉Spring的人都知道,这个注解其实相当于@ResponseBody和@Controller两个注解结合起来使用。并且在UserController内注入JdbcTemplate,代码如代码清单4-20所示。

其中,@Autowired注解是Spring用于自动装配类的注解,功能和@Resource类似。刚刚我们注入的JdbcTemplate就是Spring Boot使用JDBC操作数据库的核心,接下来进一步对它进行学习。

对于操作数据库来说,其实基本上就是创建(Create)、更新(Update)、读取(Retrieve)和删除(Delete)操作。而对于JdbcTemplate操作数据库的CURD,基本上分为三种方法:

1. execute方法

execute方法用来直接执行SQL语句,是最直接的操作数据库的方法。接下来我们在UserController内写一个建表方法createTable来使用它,方法内容如代码清单4-21所示。

启动项目,在浏览器上访问http://localhost:8080/createTable,显示如下。然后查看数据库,顺利地创建了User表。这里是以创建表为例,其实也可以直接执行CURD操作,就不一一举例了。

    创建User表成功
2. update方法

update方法多用于增、删、改操作,update方法默认返回一个int值,了解SQL的人应该知道,方法的返回值就是影响的数据行数,比如我们数据库中存在两条性别为男的用户数据,当执行update语句修改性别为男的数据时,执行成功后,我们可以得到返回值2,这个就是我们执行update方法的返回值,新增、删除操作的原理类似。当然,也支持直接执行SQL语句,比如下面的方法saveUserSql,直接执行一个插入语句,代码如代码清单4-22所示。

重启项目,在浏览器访问可以看到:

    执行成功,影响1行

上面的场景可能并不常用,甚至基本上用不到,因为插入的数据不可能是已知的并且都是固定的。插入的数据是动态的怎么办呢?update方法中也是支持传值进去的,只需要在执行的SQL上用问号来代替参数,其中update方法内第一个参数是执行的SQL,接着对应传入动态的参数即可。下面3个方法分别列举了增、删、改的方法,代码如代码清单4-23所示。

这里就不一一测试了,感兴趣的读者可以自行测试。接下来我们继续学习update方法的延伸,其实JdbcTemplate中也提供了批处理方法batchUpdate,可以传入SQL和一个批处理的数组进行操作。比如下面的batchSaveUserSql方法,可以批量插入10条数据,代码如代码清单4-24所示。

3. query方法

query方法看名字就能想到,用于执行有关查询的方法。

首先我们使用一个JdbcTemplate的query方法,这里可以用到之前创建的实体类User,方法如下,根据userName查询一个列表,代码如代码清单4-25所示。

重启项目,在浏览器上访问http://localhost:8080/getUserByUserName?userName=zhangsan0,如下所示:

    [{"id":10,"user_name":"zhangsan0","user_password":"password0"}]

刚刚我们使用了一个返回List集合的方法,接下来使用一个返回Map的方法queryForMap,代码如代码清单4-26所示。

在浏览器访问http://localhost:8080/getMapById?id=1,如下所示:

    {"id":1,"user_name":"lisi","user_password":"111"}

接下来我们查询一个数据库中不存在的数据,在浏览器访问http://localhost:8080/getMapById?id=1000,页面显示如图4-14所示。

图4-14 JDBC项目Error图

我们回过头看一下控制台,报错如代码清单4-27所示。

接下来查看一下DataAccessUtils源代码,可以看到nullableSingleResult在查到空集合的时候默认抛出EmptyResultDataAccessException异常,看到就明白了。我们修改一下getMapById方法,在方法内捕获EmptyResultDataAccessException异常,方法代码修改如代码清单4-28所示。

前面介绍了返回List集合、Map集合,接下来学习一个返回User实体类的方法queryForObject。基于刚刚查不到结果抛出异常的原因,吃一堑长一智,在这个方法中直接捕获这个异常,方法如代码清单4-29所示。

测试就不再赘述了,和之前的方法一样。到这里,Spring Boot使用JDBC就告一段落了,毕竟在实际开发中对JDBC的使用不是很多,有一定基础就可以了。