Apache-DBUtils简介
-
commons-dbutils 是 Apache 组织提供的一个开源 JDBC工具类库,它是对JDBC的简单封装,学习成本极低,并且使用dbutils能极大简化jdbc编码的工作量,同时也不会影响程序的性能。
-
API介绍:
- org.apache.commons.dbutils.QueryRunner
- org.apache.commons.dbutils.ResultSetHandler
- 工具类:org.apache.commons.dbutils.DbUtils
-
maven配置
<!-- https://mvnrepository.com/artifact/commons-dbutils/commons-dbutils --> <dependency> <groupId>commons-dbutils</groupId> <artifactId>commons-dbutils</artifactId> <version>1.7</version> </dependency>
主要的API
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 commitAndClose(Connection conn)throws SQLException: 用来提交连接的事务,然后关闭连接
- public static void commitAndCloseQuietly(Connection conn): 用来提交连接,然后关闭连接,并且在关闭连接时不抛出SQL异常。
- public static void rollback(Connection conn)throws SQLException:允许conn为null,因为方法内部做了判断
- public static void rollbackAndClose(Connection conn)throws SQLException
- rollbackAndCloseQuietly(Connection)
- public static boolean loadDriver(java.lang.String driverClassName):这一方装载并注册JDBC驱动程序,如果成功就返回true。使用该方法,你不需要捕捉这个异常ClassNotFoundException。
QueryRunner类
-
该类简单化了SQL查询,它与ResultSetHandler组合在一起使用可以完成大部分的数据库操作,能够大大减少编码量。
-
QueryRunner类提供了两个构造器:
- 默认的构造器
- 需要一个 javax.sql.DataSource 来作参数的构造器
-
QueryRunner类的主要方法:
- 更新
- public int update(Connection conn, String sql, Object… params) throws SQLException:用来执行一个更新(插入、更新或删除)操作。
- …
- 插入
- public T insert(Connection conn,String sql,ResultSetHandler rsh, Object… params) throws SQLException:只支持INSERT语句,其中 rsh - The handler used to create the result object from the ResultSet of auto-generated keys. 返回值: An object generated by the handler.即自动生成的键值
- …
- 批处理
- public int[] batch(Connection conn,String sql,Object[][] params)throws SQLException: INSERT, UPDATE, or DELETE语句
- public T insertBatch(Connection conn,String sql,ResultSetHandler rsh,Object[][] params)throws SQLException:只支持INSERT语句
- …
- 查询
- public Object query(Connection conn, String sql, ResultSetHandler rsh,Object… params) throws SQLException:执行一个查询操作,在这个查询中,对象数组中的每个元素值被用来作为查询语句的置换参数。该方法会自行处理 PreparedStatement 和 ResultSet 的创建和关闭。
- …
import bean.UserInfo; import org.apache.commons.dbutils.QueryRunner; import org.apache.commons.dbutils.handlers.BeanListHandler; import org.apache.commons.dbutils.handlers.ScalarHandler; import utils.JDBCUtils; import java.sql.Connection; import java.util.List; public class ApacheDBUtils { public static void main(String[] args) throws Exception{ Insert(); Delete(); Update(); Read(); ReadAgg(); } public static void Insert() throws Exception{ QueryRunner runner = new QueryRunner(); Connection conn = JDBCUtils.GetConnectionDruid(); String sqlstr = "insert into user_info(name,email)values(?,?)"; int count = runner.update(conn,sqlstr,"kangkang","kangkang@kk.com"); System.out.println("添加了 " + count + " 行数据"); JDBCUtils.CloseResource(conn,null); } public static void Delete() throws Exception{ QueryRunner runner = new QueryRunner(); Connection conn = JDBCUtils.GetConnectionDruid(); String sqlstr = "delete from user_info where id > ?"; int count = runner.update(conn,sqlstr,100); System.out.println("删除了 " + count + " 行数据"); JDBCUtils.CloseResource(conn,null); } public static void Update() throws Exception{ QueryRunner runner = new QueryRunner(); Connection conn = JDBCUtils.GetConnectionDruid(); String sqlstr = "update user_info set name = ? where id = ?"; int count = runner.update(conn,sqlstr,"kk",1); System.out.println("更新了 " + count + " 行数据"); JDBCUtils.CloseResource(conn,null); } // 查询 public static void Read() throws Exception{ QueryRunner runner = new QueryRunner(); Connection conn = JDBCUtils.GetConnectionDruid(); String sqlstr = "select id,name,email from user_info where id > ?"; BeanListHandler<UserInfo> handler = new BeanListHandler<>(UserInfo.class); List<UserInfo> list = runner.query(conn,sqlstr,handler,1); list.forEach(System.out::println); JDBCUtils.CloseResource(conn,null); } // 查询聚合的结果 public static void ReadAgg() throws Exception{ QueryRunner runner = new QueryRunner(); Connection conn = JDBCUtils.GetConnectionDruid(); String sqlstr = "select count(*) from user_info where id > ?"; ScalarHandler handler = new ScalarHandler(); Long count = (Long) runner.query(conn,sqlstr,handler,1); System.out.println("共有 " + count + " 行数据。"); JDBCUtils.CloseResource(conn,null); } }
添加了 1 行数据 删除了 0 行数据 更新了 1 行数据 UserInfo [id= 2 , name = kangkang , email = kangkang@kk.com ] UserInfo [id= 3 , name = kangkang , email = kangkang@kk.com ] UserInfo [id= 4 , name = kangkang , email = kangkang@kk.com ] UserInfo [id= 5 , name = kangkang , email = kangkang@kk.com ] UserInfo [id= 6 , name = kangkang , email = kangkang@kk.com ] UserInfo [id= 7 , name = kangkang , email = kangkang@kk.com ] 共有 6 行数据。
使用DBUtils关闭资源
// 使用DBUtils关闭资源 public static void CloseResourceDBUtils(Connection conn,PreparedStatement ps,ResultSet rs){ DbUtils.closeQuietly(conn); DbUtils.closeQuietly(ps); DbUtils.closeQuietly(rs); }
ResultSetHandler接口及实现类
-
该接口用于处理 java.sql.ResultSet,将数据按要求转换为另一种形式。
-
ResultSetHandler 接口提供了一个单独的方法:Object handle (java.sql.ResultSet .rs)。
-
接口的主要实现类:
- ArrayHandler:把结果集中的第一行数据转成对象数组。
- ArrayListHandler:把结果集中的每一行数据都转成一个数组,再存放到List中。
- **BeanHandler:**将结果集中的第一行数据封装到一个对应的JavaBean实例中。
- **BeanListHandler:**将结果集中的每一行数据都封装到一个对应的JavaBean实例中,存放到List里。
- ColumnListHandler:将结果集中某一列的数据存放到List中。
- KeyedHandler(name):将结果集中的每一行数据都封装到一个Map里,再把这些map再存到一个map里,其key为指定的key。
- **MapHandler:**将结果集中的第一行数据封装到一个Map里,key是列名,value就是对应的值。
- **MapListHandler:**将结果集中的每一行数据都封装到一个Map里,然后再存放到List
- **ScalarHandler:**查询单个值对象
- 更新