public interface Jdbc extends AutoCloseable
| 限定符和类型 | 方法和说明 |
|---|---|
int |
add(String sql)
提供插入、更新、删除单行数据的方法
提供向Statement添加参数的方法
|
int |
add(String[] sql)
提供插入、更新、删除多行数据的方法
提供向Statement添加参数的方法
|
int |
addBatch(Object[] args)
提供插入、更新、删除单行数据的方法
提供向PreparedStatement添加参数的方法
|
boolean |
append(Object[] args)
提供向PreparedStatement添加参数的方法
|
int |
begin()
开启事务,设置事务自动提交为false
|
int |
changeAutoCommit()
设置自动提交关闭
|
void |
close()
实现AutoCloseable接口 关闭数据库链接
|
void |
closePart()
保持数据库链接,关闭其他数据对象
|
int |
commitTransaction()
提交事务
|
int |
delete(String strTable,
String strColumnName,
String strIds)
提供基于字符串拼接的多条数据插入方法
|
int |
executeBatch()
提供统一向数据库提交的方法 批处理
|
int |
executeBatch(int type)
提供统一向数据库提交的方法 批处理
|
ResultSet |
executeQuery()
提供统一向数据库提交查询的SQL请求
|
ResultSet |
executeQuery(String sql)
提供统一向数据库提交查询的SQL请求
|
int |
executeUpdate()
提供逐行向数据库提交的方法 非批处理
|
CallableStatement |
getCallableStatement()
Gets callable statement.
|
Connection |
getConnection()
对外提供一个方法来获取数据库连接
本方法默认开启自动提交
|
Connection |
getConnection(boolean flag)
对外提供一个方法来获取数据库连接
|
List<Map<String,Object>> |
getListMap(ResultSet resultSet)
提供提取ResultSet中详细数据的方法,返回键值对数组供后续处理
私有公用方法
|
PreparedStatement |
getPreparedStatement()
Gets prepared statement.
|
PreparedStatement |
getPreparedStatement(String sql)
提供获得PreparedStatement对象的方法
本方法默认开启自动提交
|
PreparedStatement |
getPreparedStatement(String sql,
boolean flag)
提供获得PreparedStatement对象的方法
|
List<Map<String,Object>> |
getResultListMap(String sql)
提供获得ResultSet中详细数据的方法,返回键值对数组供后续处理
|
List<Map<String,Object>> |
getResultListMap(String[] strTable,
String[] strColumn,
String[] strConditionColumn,
Object[] conditionValue)
提供获得ResultSet中详细数据的方法,返回键值对数组供后续处理
|
List<Map<String,Object>> |
getResultListMap(String sql,
Object[] conditionValue)
提供获得ResultSet中详细数据的方法,返回键值对数组供后续处理
|
ResultSet |
getResultSet()
Gets result set.
|
ResultSet |
getResultSet(String sql)
提供获得ResultSet对象的方法
|
ResultSet |
getResultSet(String[] strTable,
String[] strColumn,
String[] strConditionColumn,
Object[] conditionValue)
提供获得ResultSet对象的方法
|
ResultSet |
getResultSet(String sql,
Object[] conditionValue)
提供获得ResultSet对象的方法
|
int |
getResultSetCountColumn(ResultSet resultSet)
提供获得ResultSet列数的方法
|
int |
getResultSetCountRow(ResultSet resultSet)
提供获得ResultSet行数的方法
|
Statement |
getStatement()
Gets statement.
|
int |
insertSingle(String strTableName,
Object[] args)
提供基于字符串拼接的单个数据插入方法
|
int |
rollback()
回滚事务
|
ResultSet |
runCallableStatement(String proc,
Object[] args)
调用存储过程,返回执行结果集
|
CallableStatement |
runCallableStatement(String proc,
Object[] args,
Object[] outArgs)
调用存储过程,返回
CallableStatement |
int |
singleSql(String sql)
提供传入完整SQL语句进行插入、更新、删除单行数据的方法
|
int |
singleSql(String sql,
Object[] args)
提供传入完整SQL语句进行插入、更新、删除单行数据的方法
|
int |
updateSingle(String strTable,
String[] strColumnName,
Object[] args)
提供基于字符串拼接的单个数据更新方法
|
boolean |
use(String path)
当本程序作为第三方库被调用/依赖时,使用此方法
|
Connection getConnection()
此方法需要实例化,对于批处理方式请按照如下方式执行:
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理Connection getConnection(boolean flag)
flag - 传入boolean值,设置setAutoCommit事务自动提交此方法需要实例化,对于批处理方式请按照如下方式执行:
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理PreparedStatement getPreparedStatement(String sql)
sql - 提供创建PreparedStatement的SQL语句此方法在创建PreparedStatement时追加了
ResultSet.TYPE_SCROLL_INSENSITIVE 和 ResultSet.CONCUR_READ_ONLY参数,所获得的结果集支持滚动
ResultSet.TYPE_SCROLL_INSENSITIVE
结果集的游标可以上下移动,当数据库变化时,当前结果集不变。
ResultSet.CONCUR_READ_ONLY 不能用结果集更新数据库中的表.
此方法需要实例化,对于批处理方式请按照如下方式执行:
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理PreparedStatement getPreparedStatement(String sql, boolean flag)
sql - 提供创建PreparedStatement的SQL语句flag - the flag此方法在创建PreparedStatement时追加了
ResultSet.TYPE_SCROLL_INSENSITIVE 和 ResultSet.CONCUR_READ_ONLY参数,所获得的结果集支持滚动
ResultSet.TYPE_SCROLL_INSENSITIVE 结果集的游标可以上下移动,当数据库变化时,当前结果集不变。
ResultSet.CONCUR_READ_ONLY 不能用结果集更新数据库中的表.
此方法需要实例化,对于批处理方式请按照如下方式执行:
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理ResultSet getResultSet(String sql)
sql - 需要查询SQL语句ResultSet getResultSet(String sql, Object[] conditionValue)
sql - 需要查询SQL语句conditionValue - 传入与需要检索条件的列名称对应的检索值ResultSet getResultSet(String[] strTable, String[] strColumn, String[] strConditionColumn, Object[] conditionValue)
strTable - 传入需要查询数据表名strColumn - 传入需要查询数据列名,如是多表查询需提供包含表名完整的完成列名 参数格式:TABLE_A,TABLE_B.COLUMN_AstrConditionColumn - 传入需要检索条件的列名,若不进行条件检索请赋空conditionValue - 传入与需要检索条件的列名称对应的检索值boolean append(Object[] args)
args - 传入需提交的参数List<Map<String,Object>> getResultListMap(String sql)
sql - 需要查询SQL语句java.util.List<java.util.Map<java.lang.String, java.lang.Object>> 返回键值对数组,其中键为数据表中列名,值为与列对应的值List<Map<String,Object>> getResultListMap(String sql, Object[] conditionValue)
sql - 需要查询SQL语句conditionValue - 传入与需要检索条件的列名称对应的检索值java.util.List<java.util.Map<java.lang.String, java.lang.Object>> 返回键值对数组,其中键为数据表中列名,值为与列对应的值List<Map<String,Object>> getResultListMap(String[] strTable, String[] strColumn, String[] strConditionColumn, Object[] conditionValue)
strTable - 传入需要查询数据表名strColumn - 传入需要查询数据列名,如是多表查询需提供包含表名完整的完成列名 参数格式:TABLE_A,TABLE_B.COLUMN_AstrConditionColumn - 传入需要检索条件的列名,若不进行条件检索请赋空conditionValue - 传入与需要检索条件的列名称对应的检索值java.util.List<java.util.Map<java.lang.String, java.lang.Object>> 返回键值对数组,其中键为数据表中列名,值为与列对应的值List<Map<String,Object>> getListMap(ResultSet resultSet)
resultSet - 传入 已获取的结果集java.util.List<java.util.Map<java.lang.String, java.lang.Object>> 返回键值对数组,其中键为数据表中列名,值为与列对应的值int getResultSetCountRow(ResultSet resultSet)
resultSet - 传入带操作的结果集返回结果为-1即调用失败
返回结果为0即调用成功,传入的ResultSet为空
返回结果为大于或等于1即调用成功,返回传入的ResultSet实际行数
int getResultSetCountColumn(ResultSet resultSet)
resultSet - 传入带操作的结果集返回结果为-1即调用失败
返回结果为0即调用成功,传入的ResultSet为空
返回结果为大于或等于1即调用成功,返回传入的ResultSet实际行数
ResultSet executeQuery()
ResultSet executeQuery(String sql)
sql - 需要查询SQL语句int singleSql(String sql) throws SQLException
sql - 传入标准SQL语句SQLException - Statement执行异常本方法调用Statement
int singleSql(String sql, Object[] args)
sql - 传入标准SQL语句args - 传入将要插入的值本方法调用PreparedStatement
int insertSingle(String strTableName, Object[] args)
strTableName - 传入需要操纵的数据库表名
参数格式:TABLE_A(COLUMN_A,COLUMN_B,COLUMN_C)args - 传入将要插入的值int updateSingle(String strTable, String[] strColumnName, Object[] args)
strTable - 传入需要操纵的数据库表名strColumnName - 传入需要操纵的数据表列名称,最后一项为条件列,即表主键
参数格式:TABLE_A,TABLE_B,TABLE_Cargs - 传入将要更新后的值int delete(String strTable, String strColumnName, String strIds)
strTable - 传入需要操纵的数据库表名strColumnName - 传入条件列名称,即表主键名strIds - 传入索引值 参数格式:1,2,3建议传入主键字段
int executeUpdate()
自本方法v1.1.0开始,使用此方法执行提交后将会自动关闭JdbcImpl所有链接
向数据库更新时未自动关闭数据库链接,数据复现为JavaWeb开发中,Servlet将会持久化本类的数据库链接
ResultSet runCallableStatement(String proc, Object[] args)
proc - 传入完整SQL语句
参数形式CALL procedure(?...)args - 传入存储过程参数组在使用存储过程前,请了解需要调用的存储过程所需传入的参数和返回结果
CallableStatement runCallableStatement(String proc, Object[] args, Object[] outArgs)
CallableStatementproc - 传入完整SQL语句
参数形式CALL procedure(?...)args - 传入存储过程参数组outArgs - 传入返回值参数CallableStatementint begin()
返回结果为-1即调用失败
返回结果为0即调用成功,connection已存在
返回结果为等于1即调用成功
int commitTransaction()
返回结果为-1即调用失败
返回结果为0即调用成功,connection不存在,需重新开启事务
int rollback()
返回结果为-1即调用失败
返回结果为0即调用成功,connection不存在,需重新开启事务
返回结果为等于1即调用成功
int changeAutoCommit()
返回结果为-1即调用失败
返回结果为0即调用成功,connection不存在,需重新开启事务
返回结果为等于1即调用成功
int add(String sql)
sql - 传入需提交的SQL语句返回结果为-1,statement不存在且创建失败
返回结果为0即调用成功,未执行任何添加操作
返回结果为等于1即调用成功
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得Statement对象addBatch()向Statement追加参数executeBatch()提交批处理int add(String[] sql)
sql - 传入需提交的SQL语句返回结果为-1,statement不存在且创建失败
返回结果为0即调用成功,未执行任何添加操作
返回结果为大于等于1即调用成功,返回添加成功的实际行数,请检查返回数值是否与传入参数行数相同
本方法采用正序添加至statement,若返回数值小于传入参数行数,截取下标为返回数值开始至末行的数据重新添加。 e.g. 如传入参数为50行,本方法执行后返回数值21,请续传下标为21-49的SQL语句
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得Statement对象addBatch()向Statement追加参数executeBatch()提交批处理int addBatch(Object[] args)
args - 传入需提交的参数返回结果为-1即调用失败
返回结果为0即调用成功,connection不存在,需创建PreparedStatement
返回结果为等于1即调用成功,返回传入的ResultSet实际行数
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理int executeBatch()
作者认为此方法并不安全,建议使用JdbcImpl.executeBatch(String type)方法,
由于使用者将两种类型的请求在同一实例化对象中完成,可能导致最终提交数据并不是使用者希望提交的数据
返回结果为-2即调用失败,调用过程中产生异常
返回结果为-1即调用失败,statement preparedStatement均为null
返回结果为大于等于0即调用成功,返回受影响行数
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理int executeBatch(int type)
type - 传入将进行提交的类型,输入错误将返回错误代码-1 作者认为此方法并不安全,建议使用JdbcImpl.executeBatch(String type)方法,
由于使用者将两种类型的请求在同一实例化对象中完成,可能导致最终提交数据并不是使用者希望提交的数据
返回结果为-2即调用失败,调用过程中产生异常
返回结果为-1即调用失败,参数 type 传递错误
返回结果为大于等于0即调用成功,返回受影响行数
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理@FuncVerification(version="1.0.0", status=Unverified, date="2020/5/12 11:50") void closePart()
void close()
throws Exception
close 在接口中 AutoCloseableException - AutoClosedStatement getStatement()
PreparedStatement getPreparedStatement()
CallableStatement getCallableStatement()
ResultSet getResultSet()
boolean use(String path)
path - 传入配置文件路径当传入路径不正确程序会抛异常,请确保传入路径正确
当被依赖项目为Maven时请将资源文件放置resources资源包中,否则无法找到路径
当被依赖项目为Maven时不必将资源文件放置resources资源包中
资源包必须包含如下参数,否则程序异常:
db.BatchMax
jdbc.driver
jdbc.url
jdbc.user
jdbc.password
This documentation was released into the public domain.