Jdbc系列十：DbUtils类

痛定思痛。 2022-01-27 10:25 296阅读 0赞

一、DbUtils类  
 DbUtils ：提供如关闭连接、装载JDBC驱动程序等常规工作的工具类，里面的所有方法都是静态的。主要方法如下：  
 public static void close(…) throws java.sql.SQLException：　DbUtils类提供了三个重载的关闭方法。这些方法检查所提供的参数是不是NULL，如果不是的话，它们就关闭Connection、Statement和ResultSet。  
 public static void closeQuietly(…): 这一类方法不仅能在Connection、Statement和ResultSet为NULL情况下避免关闭，还能隐藏一些在程序中抛出的SQLEeception。  
 public static void commitAndCloseQuietly(Connection conn)： 用来提交连接，然后关闭连接，并且在关闭连接时不抛出SQL异常。  
 public static boolean loadDriver(java.lang.String driverClassName)：这一方装载并注册JDBC驱动程序，如果成功就返回true。使用该方法，你不需要捕捉这个异常ClassNotFoundException。

二、QueryRunner类  
 该类简单化了SQL查询，它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作，能够大大减少编码量。  
 QueryRunner类提供了两个构造方法：  
  默认的构造方法。  
  需要一个 javax.sql.DataSource 来作参数的构造方法。

三、QueryRunner类的主要方法  
 public Object query(Connection conn, String sql, Object\[\] params, ResultSetHandler rsh) throws SQLException：执行一个查询操作，在这个查询中，对象数组中的每个元素值被用来作为查询语句的置换参数。该方法会自行处理 PreparedStatement 和 ResultSet 的创建和关闭。  
 public Object query(String sql, Object\[\] params, ResultSetHandler rsh) throws SQLException:　几乎与第一种方法一样；唯一的不同在于它不将数据库连接提供给方法，并且它是从提供给构造方法的数据源(DataSource) 或使用的setDataSource 方法中重新获得 Connection。  
 public Object query(Connection conn, String sql, ResultSetHandler rsh) throws SQLException : 执行一个不需要置换参数的查询操作。  
 public int update(Connection conn, String sql, Object\[\] params) throws SQLException:用来执行一个更新（插入、更新或删除）操作。  
 public int update(Connection conn, String sql) throws SQLException：用来执行一个不需要置换参数的更新操作。  
1、引入依赖

<dependency>
    	 <groupId>commons-dbutils</groupId>
         <artifactId>commons-dbutils</artifactId>
         <version>1.3</version>
    </dependency>

2、 测试 QueryRunner 类的 update 方法。该方法可用于 INSERT, UPDATE 和 DELETE

@Test
    public void testQueryRunnerUpdate() {
    	//1. 创建 QueryRunner 的实现类
    	QueryRunner queryRunner = new QueryRunner();
    	
    	String sql = "DELETE FROM user " +
    			"WHERE id IN (?)";
    	
    	Connection connection = null;
    	
    	try {
    		connection = JDBCTools.getConnection();
    		//2. 使用其 update 方法
    		queryRunner.update(connection, 
    				sql, 1);
    	} catch (Exception e) {
    		e.printStackTrace();
    	} finally{
    		JDBCTools.releaseDB(null, null, connection);
    	}
    	
    }

3、测试 QueryRunner 的 query 方法和ResultSetHandler接口

@SuppressWarnings({ "unchecked", "rawtypes" })
    @Test
    public void testResultSetHandler(){
    	String sql = "SELECT id, name FROM user";
    	
    	//1. 创建 QueryRunner 对象
    	QueryRunner queryRunner = new QueryRunner();
    	
    	Connection conn = null;
    	
    	try {
    		conn = JDBCTools.getConnection();
    		/**
    		 * 2. 调用 query 方法:
    		 * ResultSetHandler 参数的作用: query 方法的返回值直接取决于 
    		 * ResultSetHandler 的 hanlde(ResultSet rs) 是如何实现的. 实际上, 在
    		 * QueryRunner 类的 query 方法中也是调用了 ResultSetHandler 的 handle()
    		 * 方法作为返回值的。
    		 */
    		Object object = queryRunner.query(conn, sql, 
    				new ResultSetHandler(){
    					@Override
    					public Object handle(ResultSet rs) throws SQLException {
    						List<User> users = new ArrayList<>();
    						
    						while(rs.next()){
    							String id = rs.getString(1);
    							String name = rs.getString(2);
    							
    							User user =
    									new User(id, name);
    							users.add(user);
    						}
    						
    						return users;
    					}
    				}
    		
    				);			
    		
    		System.out.println(object); 
    	} catch (Exception e) {
    		e.printStackTrace();
    	} finally{
    		JDBCTools.releaseDB(null, null, conn);
    	}
    	
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70]  
四、ResultSetHandler接口  
 该接口用于处理 java.sql.ResultSet，将数据按要求转换为另一种形式。  
 ResultSetHandler 接口提供了一个单独的方法：Object handle (java.sql.ResultSet .rs)。

五、ResultSetHandler 接口的实现类  
 ArrayHandler：把结果集中的第一行数据转成对象数组。  
 ArrayListHandler：把结果集中的每一行数据都转成一个数组，再存放到List中。  
 BeanHandler：将结果集中的第一行数据封装到一个对应的JavaBean实例中。  
 BeanListHandler：将结果集中的每一行数据都封装到一个对应的JavaBean实例中，存放到List里。  
 ColumnListHandler：将结果集中某一列的数据存放到List中。  
 KeyedHandler(name)：将结果集中的每一行数据都封装到一个Map里，再把这些map再存到一个map里，其key为指定的key。  
 MapHandler：将结果集中的第一行数据封装到一个Map里，key是列名，value就是对应的值。  
 MapListHandler：将结果集中的每一行数据都封装到一个Map里，然后再存放到List。

1、测试 ResultSetHandler 的 BeanListHandler 实现类

/**
     * BeanListHandler: 把结果集转为一个 Bean 的 List. 该 Bean
     * 的类型在创建 BeanListHandler 对象时传入:
     * 		new BeanListHandler<>(User.class)
     */
    @Test
    public void testBeanListHandler(){
    	String sql = "SELECT id, name FROM user";
    	
    	//1. 创建 QueryRunner 对象
    	QueryRunner queryRunner = new QueryRunner();
    	
    	Connection conn = null;
    	
    	try {
    		conn = JDBCTools.getConnection();
    		
    		Object object = queryRunner.query(conn, sql, 
    				new BeanListHandler<>(User.class));
    		
    		System.out.println(object); 
    	} catch (Exception e) {
    		e.printStackTrace();
    	} finally{
    		JDBCTools.releaseDB(null, null, conn);
    	}
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70 1]  
2、测试 ResultSetHandler 的 MapHandler实现类

@Test
    public void testMapHandler(){
    	Connection connection = null;
    	QueryRunner queryRunner = new QueryRunner();
    	
    	String sql = "SELECT id, name FROM user WHERE id = ?";
    	
    	try {
    		connection = JDBCTools.getConnection();
    		Map<String, Object> map = queryRunner.query(connection, 
    				sql, new MapHandler(), 2);
    		
    		System.out.println(map); 
    	} catch (Exception e) {
    		e.printStackTrace();
    	} finally{
    		JDBCTools.releaseDB(null, null, connection);
    	}
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70 2]  
3、测试 ResultSetHandler 的 MapListHandler实现类

@Test
    public void testMapListHandler(){
    	Connection connection = null;
    	QueryRunner queryRunner = new QueryRunner();
    	
    	String sql = "SELECT id, name FROM user";
    	
    	try {
    		connection = JDBCTools.getConnection();
    		List<Map<String, Object>> mapList = queryRunner.query(connection, 
    				sql, new MapListHandler());
    		
    		System.out.println(mapList); 
    	} catch (Exception e) {
    		e.printStackTrace();
    	} finally{
    		JDBCTools.releaseDB(null, null, connection);
    	}
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70 3]

/**
     * 1. ResultSetHandler 的作用: QueryRunner 的 query 方法的返回值最终取决于
     * query 方法的 ResultHandler 参数的 hanlde 方法的返回值.
     * 
     * 2. BeanListHandler: 把结果集转为一个 Bean 的 List, 并返回. Bean 的类型在
     * 创建 BeanListHanlder 对象时以 Class 对象的方式传入. 可以适应列的别名来映射 
     * JavaBean 的属性名: 
     * String sql = "SELECT id, name FROM user WHERE id = ?";
     * 
     * BeanListHandler(Class<T> type)
     * 
     * 3. BeanHandler: 把结果集转为一个 Bean, 并返回. Bean 的类型在创建 BeanHandler
     * 对象时以 Class 对象的方式传入
     * BeanHandler(Class<T> type) 
     * 
     * 4. MapHandler: 把结果集转为一个 Map 对象, 并返回. 若结果集中有多条记录, 仅返回
     * 第一条记录对应的 Map 对象. Map 的键: 列名(而非列的别名), 值: 列的值
     * 
     * 5. MapListHandler: 把结果集转为一个 Map 对象的集合, 并返回. 
     * Map 的键: 列名(而非列的别名), 值: 列的值
     * 
     * 6. ScalarHandler: 可以返回指定列的一个值或返回一个统计函数的值. 
     */
    @Test
    public void testScalarHandler(){
    	Connection connection = null;
    	QueryRunner queryRunner = new QueryRunner();
    	
    	String sql = "SELECT name FROM user WHERE id = ?";
    	
    	try {
    		connection = JDBCTools.getConnection();
    		Object count = queryRunner.query(connection, sql, 
    				new ScalarHandler(), 2);
    		
    		System.out.println(count); 
    	} catch (Exception e) {
    		e.printStackTrace();
    	} finally{
    		JDBCTools.releaseDB(null, null, connection);
    	}
    }

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70 4]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70]: /images/20220127/98bbf5cb679143fdb2d20f4a810a5e91.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70 1]: /images/20220127/cf18cd849a274e33956ceaa0515034c3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70 2]: /images/20220127/0c1a6ad8f5464a1fb0b8afdf31b1df0b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70 3]: /images/20220127/280d0f535de5479aae2de520d46208cf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xpemhpcWlhbmcxMjE3_size_16_color_FFFFFF_t_70 4]: /images/20220127/2e5b1161a1214d63b366e1058e7ec6a7.png