DBUtils 的使用与踩坑记录

博主声明：

转载请在开头附加本文链接及作者信息，并标记为转载。本文由博主威威喵原创，请多支持与指教。

本文首发于此博主：威威喵 | 博客主页：https://blog.csdn.net/smile_running

DBUtils工具包

DBUtils是Apache组织提供的一个开源JDBC工具类库，它是对JDBC的简单封装，学习成本极低，并且使用dbutils能极大简化JDBC编码的工作量，同时也不会影响程序的性能。

QueryRunner类简单化了SQL查询，它与ResultSetHandler接口组合在一起使用可以完成大部分的数据库操作，能够大大减少编码量。ResultSetHandler接口提供将数据按要求转换为另一种形式。

一、常用实现类

1、BeanHandler

将结果集中的第一行数据封装到一个对应的JavaBean实例中

例如：

 @Testpublic void testBeanHandler() {QueryRunner queryRunner = new QueryRunner();Connection conn = null;try {conn = JdbcUtils.getConnectionForC3P0();String sql = "select username,password,register_time,sex,user_role,id_card from user where username=?";User user = queryRunner.query(conn, sql, new BeanHandler<>(User.class), "小王");System.out.println(user);} catch (Exception e) {e.printStackTrace();} finally {if (conn != null) {JdbcUtils.release(null, conn, null);}}}

2、BeanListHandler

将结果集中的每一行数据都封装到一个对应的JavaBean实例中，存放到List里

例如：

 @Testpublic void testBeanListHandler() {QueryRunner queryRunner = new QueryRunner();Connection conn = null;try {conn = JdbcUtils.getConnectionForC3P0();String sql = "select username,password,register_time,sex,user_role,id_card from user";List<User> user = queryRunner.query(conn, sql, new BeanListHandler<>(User.class));System.out.println(user);} catch (Exception e) {e.printStackTrace();} finally {if (conn != null) {JdbcUtils.release(null, conn, null);}}}

3、MapHandler

将结果集中的第一行数据封装为一个Map

例如：

 @Testpublic void testMapHandler() {QueryRunner queryRunner = new QueryRunner();Connection conn = null;try {conn = JdbcUtils.getConnectionForC3P0();String sql = "select username,password,register_time,sex,user_role,id_card from user where username=?";Map<String, Object> user = queryRunner.query(conn, sql, new MapHandler(), "小王");System.out.println(user);} catch (Exception e) {e.printStackTrace();} finally {if (conn != null) {JdbcUtils.release(null, conn, null);}}}

4、MapListHandler

将结果集中的每一行数据都封装到一个Map里，然后再存放到List

例如：

 @Testpublic void testMapListHandler() {QueryRunner queryRunner = new QueryRunner();Connection conn = null;try {conn = JdbcUtils.getConnectionForC3P0();String sql = "select username,password,register_time,sex,user_role,id_card from user";List<Map<String, Object>> user = queryRunner.query(conn, sql, new MapListHandler());System.out.println(user);} catch (Exception e) {e.printStackTrace();} finally {if (conn != null) {JdbcUtils.release(null, conn, null);}}}

5、ScalarHandler

将结果集中的单个值返回

例如：

 @Testpublic void testScalarHandler2() {QueryRunner queryRunner = new QueryRunner();Connection conn = null;try {conn = JdbcUtils.getConnectionForC3P0();String sql = "select register_time from user where id_card=?";Object register_time = queryRunner.query(conn, sql, new ScalarHandler(), "321...");System.out.println(register_time);} catch (Exception e) {e.printStackTrace();} finally {if (conn != null) {JdbcUtils.release(null, conn, null);}}}

6、需注意的坑

通过BeanHandler和BeanListHandler得到的结果集会有不存在（NULL）的情况，比如这种情况下就会导致NULL，图：

出现这种情况的原因是：实体类（User）中的对应属性名与数据库的字段（列名）无法匹配，数据库的数据如下图：

其中register_time、user_role、id_card与类变量registerTime、userRole、idCard无法对应赋值，这也是BeanHandler的一种缺陷，而其它如MapHandler、ScalarHandler就不会出现这种情况。

原因是：MapHandler、ScalarHandler的底层运用了反射来获取元数据的列名，所以它可以获取的到结果。

©原文链接：https://blog.csdn.net/smile_Running/article/details/87009755

©作者博客 ID：smile_running