概述

由来

Hutool-db是一个在JDBC基础上封装的数据库操作工具类，通过包装，使用ActiveRecord思想操作数据库。在Hutool-db中，使用Entity（本质上是个Map）代替Bean来使数据库操作更加灵活，同时提供Bean和Entity的转换提供传统ORM的兼容支持。

整体的架构

整体分为几部分:

概述 - 图1

  • 数据源 DataSource
  • SQL执行器 SqlExecutor
  • CRUD的封装 Db、SqlConnRunner SqlRunner
  • 支持事务的CRUD封装 Session
  • 各种结果集处理类 handler
  • 数据库的一些工具方法汇总 DbUtil还有就是没有列出来的dialect（数据库方言），我会根据给定的DataSource、Connection等对象自动识别是什么数据库，然后使用不同的方言构造SQL语句，暂时支持的数据库有MySQL、Oracle、SqlLite3，当然如果识别失败会用ANSI SQL，这样遇到不支持的数据，可以搞定大部分方法。

下面解释下：

CRUD的封装 Db SqlConnRunner SqlRunner

这两个类有些相似，里面都封装了增、删、改、查、分页、个数方法，差别是SqlConnRunner需要每个方法都传Connection对象，而SqlRunner继承自SqlConnRunner，在传入DataSource会自动获取Connection对象。

各种结果集处理类 handler

此包中有个叫做RsHandler的接口，传入ResultSet对象，返回什么则在handle方法中自己指定。实现的类有：

  • EntityListHandler 转换为Entity列表

  • NumberHandler 当使用select count(1)这类语句的时候，或者返回只有一个结果，且为数字结果的时候，用这个handler

  • EntityHandler 返回一条记录的时候用这个

  • 数据库的一些工具方法汇总 DbUtil提供一些工具方法，最常用的就是close方法了，由于JDK7才把ResultSetStatementPreparedStatement``Connection这几个接口实现了Closeable接口，所以之前只能判断类型再去关闭，这样一个close方法可以关闭多个对象。

对象解释

1. Entity

在ORM中，我把一张表中的一条数据映射成为一个叫做Entity的类，继承自HashMap，key是字段名，value是Object类型，字段值，这样一个Entity对象就是数据库表中的一条记录，当然这个对象中还有个字段是表的名字，方便之后的操作。之后对数据库增删改查操作的对象大多是这个。

这个对象充当着两种角色，一个是数据的载体，表示一条数据，另一个就是where语句的条件，充当where条件时，key依旧是字段名，value是字段条件值。例如：

  1. Entity where = Entity.create(TABLE_NAME).set("条件1", "条件值");

表示的where语句是：

  1. WHERE `条件1` = 条件值

当然到时候会用PreparedStatement，不会出现SQL注入。

2. Table Column

这两个对象主要是描述数据库表结构的，暂时和ORM本身没啥关系，只是当你想获得一些字段信息的时候，这样来获得表结构信息：

  1. private static void getTableMetaInfo(DataSource ds) {
  2.     // 获得当前库的所有表的表名
  3.     List<String> tableNames = DbUtil.getTables(ds);
  4.     Log.info("{}", tableNames);
  6.     /*
  7.      * 获得表结构 表结构封装为一个表对象，里面有Column对象表示一列，列中有列名、类型、大小、是否允许为空等信息
  8.      */
  9.     Table table = DbUtil.getTableMeta(ds, TABLE_NAME);
  10.     Log.info("{}", table);
  11. }