cn.xnatural.app.util

类 DB

java.lang.Object

cn.xnatural.app.util.DB

所有已实现的接口:

AutoCloseable

public class DB
extends Object
implements AutoCloseable

数据库 sql 操作工具

字段概要

字段

限定符和类型	字段和说明
protected static AtomicInteger	count
protected DataSource	ds 数据源
String	name 名字标识
protected static ThreadLocal<Connection>	txConn 事务连接,保存在线程上下文

构造器概要

构造器

构造器和说明
DB(DataSource dataSource) 创建一个 DB
DB(Map<String,Object> dsAttr) 创建一个 DB
DB(String jdbcUrl) 创建一个DB
DB(String jdbcUrl, Integer minIdle, Integer maxActive) 创建一个DB
DB(String jdbcUrl, String username, String password) 创建一个DB
DB(String jdbcUrl, String username, String password, Integer minIdle, Integer maxActive) 创建一个DB

方法概要

限定符和类型	方法和说明
int	call(String sql, Object... params) 执行一个存储过程
void	close()
static DataSource	createDataSource(Map<String,Object> dsAttr) 创建一个 数据源
int	execute(String sql, Object... params) 插入一条数据/更新数据
protected void	fillParam(PreparedStatement pst, Object... params)
String	getJdbcUrl() 获取 jdbc 连接地址
Object	insertWithGeneratedKey(String sql, Object... params) 插入一条数据 并 返回第一个 数据库自生成字段
<T> void	iterate(String sql, Class<T> type, Function<T,Boolean> fn, Object... params) 遍历数据
<T> T	row(String sql, Class<T> type, Object... params) 返回一条数据
Map<String,Object>	row(String sql, Object... params) 返回一条数据
<T> List<T>	rows(String sql, Class<T> type, Object... params) 查询多条数据
List<Map<String,Object>>	rows(String sql, Object... params)
<T> T	single(String sql, Class<T> retType, Object... params) 查询单个值
String	toString()
<T> T	trans(Supplier<T> fn) 开启一个事务
<T> T	withConn(Function<Connection,T> fn) 执行连接

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细资料

count

protected static final AtomicInteger count

name

public final String name

名字标识

ds

protected final DataSource ds

数据源

txConn

protected static final ThreadLocal<Connection> txConn

事务连接,保存在线程上下文

构造器详细资料

DB

public DB(DataSource dataSource)

创建一个 DB

参数:

dataSource - 外部数据源

DB

public DB(Map<String,Object> dsAttr)

创建一个 DB

参数:

dsAttr - 属性集

DB

public DB(String jdbcUrl)

创建一个DB

参数:

jdbcUrl - jdbc 连接地址

DB

public DB(String jdbcUrl,
          String username,
          String password)

创建一个DB

参数:

jdbcUrl - jdbc 连接地址

username - 连接用户名

password - 连接密码

DB

public DB(String jdbcUrl,
          Integer minIdle,
          Integer maxActive)

创建一个DB

参数:

jdbcUrl - jdbc 连接地址

minIdle - 最小连接

maxActive - 最大活动连接

DB

public DB(String jdbcUrl,
          String username,
          String password,
          Integer minIdle,
          Integer maxActive)

创建一个DB

参数:

jdbcUrl - jdbc 连接地址

username - 连接用户名

password - 连接密码

minIdle - 最小连接

maxActive - 最大活动连接

方法详细资料

withConn

public <T> T withConn(Function<Connection,T> fn)

执行连接

参数:

fn - 函数

返回:

DB

trans

public <T> T trans(Supplier<T> fn)

开启一个事务

类型参数:

T - 返回类型

参数:

fn - 事务执行函数

返回:

返回值

execute

public int execute(String sql,
                   Object... params)

插入一条数据/更新数据

参数:

sql - sql 语句

params - 参数

返回:

成功条数

call

public int call(String sql,
                Object... params)

执行一个存储过程

参数:

sql - sql语句

params - 参数

返回:

影响条数

insertWithGeneratedKey

public Object insertWithGeneratedKey(String sql,
                                     Object... params)

插入一条数据 并 返回第一个 数据库自生成字段

参数:

sql - sql 语句

params - 参数

返回:

自生成字段的值

rows

public List<Map<String,Object>> rows(String sql,
                                     Object... params)

rows

public <T> List<T> rows(String sql,
                        Class<T> type,
                        Object... params)

查询多条数据

参数:

sql - sql 语句

type - 返回类型

params - 参数

返回:

多条数据结果

iterate

public <T> void iterate(String sql,
                        Class<T> type,
                        Function<T,Boolean> fn,
                        Object... params)

遍历数据

参数:

sql - sql 语句

type - 返回类型

fn - 消费函数. 返回false: 结束遍历

params - 参数

row

public Map<String,Object> row(String sql,
                              Object... params)

返回一条数据

参数:

sql - sql语句

params - 参数

返回:

一条数据

row

public <T> T row(String sql,
                 Class<T> type,
                 Object... params)

返回一条数据

参数:

sql - sql语句

type - 返回类型

params - 参数

返回:

一条数据

single

public <T> T single(String sql,
                    Class<T> retType,
                    Object... params)

查询单个值

类型参数:

T - 类型

参数:

sql - sql 语句

retType - 返回的类型 Integer.class, Long.class, String.class, Double.class, BigDecimal.class, Boolean.class, Date.class

params - 参数

返回:

单个值

fillParam

protected void fillParam(PreparedStatement pst,
                         Object... params)
                  throws SQLException

抛出:

SQLException

close

public void close()

指定者:

close 在接口中 AutoCloseable

getJdbcUrl

public String getJdbcUrl()

获取 jdbc 连接地址

toString

public String toString()

覆盖:

toString 在类中 Object

createDataSource

public static DataSource createDataSource(Map<String,Object> dsAttr)

创建一个 数据源

参数:

dsAttr - 连接池属性

返回:

DataSource 数据源