@Service public class JdbcImpl extends AbstractJdbc implements Jdbc
使用本类时请先use()方法传入资源文件路径,
或使用构造方法public JdbcImpl(String path)传入资源文件路径
请不用使用同一实例对象完成多重类型操作,若需完成多重操作请实例化多个JdbcImpl对象,尽最大可能避免异常抛出
此项目希望做到提供尽可能的通用方法,但某些特殊情况可能无法提供处理。
此封装类已实现对AutoCloseable的支持,调用方可以获取它的资源直到结束,这将自动调用close。
此封装类已尽可能的对Exception进行try捕获,
不可避免的这可能将会导致后续程序的在特定情况下产生NullPointerException。
自本方法v3.1.0开始,使用本类执行提交后将会自动关闭JdbcImpl所有链接
AutoCloseable 实现自动关闭driver, intBatchCount, pass, url, user| 限定符和类型 | 方法和说明 |
|---|---|
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)
提供基于字符串拼接的单个数据更新方法
|
getBatchMax, getDatabaseCurrentlyInUse, getDriver, getIntBatchCount, getPass, getStrResourcePath, getUrl, getUser, setBatchMax, setDatabaseCurrentlyInUse, setDriver, setIntBatchCount, setPass, setUrl, setUser, usepublic JdbcImpl()
public JdbcImpl(String path)
path - 传入资源文件路径@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 16:07") public Connection getConnection()
getConnection 在接口中 Jdbc此方法需要实例化,对于批处理方式请按照如下方式执行:
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 16:09") public Connection getConnection(boolean flag)
getConnection 在接口中 Jdbcflag - 传入boolean值,设置setAutoCommit事务自动提交此方法需要实例化,对于批处理方式请按照如下方式执行:
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 16:17") public PreparedStatement getPreparedStatement(String sql)
getPreparedStatement 在接口中 Jdbcsql - 提供创建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()提交批处理@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 16:17") public PreparedStatement getPreparedStatement(String sql, boolean flag)
getPreparedStatement 在接口中 Jdbcsql - 提供创建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()提交批处理@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 17:12") public ResultSet getResultSet(String sql)
getResultSet 在接口中 Jdbcsql - 需要查询SQL语句@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 17:12") public ResultSet getResultSet(String sql, Object[] conditionValue)
getResultSet 在接口中 Jdbcsql - 需要查询SQL语句conditionValue - 传入与需要检索条件的列名称对应的检索值@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 17:12") public ResultSet getResultSet(String[] strTable, String[] strColumn, String[] strConditionColumn, Object[] conditionValue)
getResultSet 在接口中 JdbcstrTable - 传入需要查询数据表名strColumn - 传入需要查询数据列名,如是多表查询需提供包含表名完整的完成列名 参数格式:TABLE_A,TABLE_B.COLUMN_AstrConditionColumn - 传入需要检索条件的列名,若不进行条件检索请赋空conditionValue - 传入与需要检索条件的列名称对应的检索值@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 19:17", note="\u8c03\u7528\u65b9\u6cd5\u6d4b\u8bd5 getResultSet") public boolean append(Object[] args)
@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 20:31") public List<Map<String,Object>> getResultListMap(String sql)
getResultListMap 在接口中 Jdbcsql - 需要查询SQL语句java.util.List<java.util.Map<java.lang.String, java.lang.Object>> 返回键值对数组,其中键为数据表中列名,值为与列对应的值@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 20:31") public List<Map<String,Object>> getResultListMap(String sql, Object[] conditionValue)
getResultListMap 在接口中 Jdbcsql - 需要查询SQL语句conditionValue - 传入与需要检索条件的列名称对应的检索值java.util.List<java.util.Map<java.lang.String, java.lang.Object>> 返回键值对数组,其中键为数据表中列名,值为与列对应的值@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 20:33") public List<Map<String,Object>> getResultListMap(String[] strTable, String[] strColumn, String[] strConditionColumn, Object[] conditionValue)
getResultListMap 在接口中 JdbcstrTable - 传入需要查询数据表名strColumn - 传入需要查询数据列名,如是多表查询需提供包含表名完整的完成列名 参数格式:TABLE_A,TABLE_B.COLUMN_AstrConditionColumn - 传入需要检索条件的列名,若不进行条件检索请赋空conditionValue - 传入与需要检索条件的列名称对应的检索值java.util.List<java.util.Map<java.lang.String, java.lang.Object>> 返回键值对数组,其中键为数据表中列名,值为与列对应的值@FuncVerification(version="1.1.0", status=Pass, date="2020/4/26 20:36") public List<Map<String,Object>> getListMap(ResultSet resultSet)
getListMap 在接口中 JdbcresultSet - 传入 已获取的结果集java.util.List<java.util.Map<java.lang.String, java.lang.Object>> 返回键值对数组,其中键为数据表中列名,值为与列对应的值@FuncVerification(version="1.1.0", status=Pass, date="2020/4/26 20:34", note="\u8c03\u7528\u65b9\u6cd5\u6d4b\u8bd5 getListMap") public int getResultSetCountRow(ResultSet resultSet)
getResultSetCountRow 在接口中 JdbcresultSet - 传入带操作的结果集返回结果为-1即调用失败
返回结果为0即调用成功,传入的ResultSet为空
返回结果为大于或等于1即调用成功,返回传入的ResultSet实际行数
@FuncVerification(version="1.1.0", status=Pass, date="2020/4/26 20:35", note="\u8c03\u7528\u65b9\u6cd5\u6d4b\u8bd5 getListMap") public int getResultSetCountColumn(ResultSet resultSet)
getResultSetCountColumn 在接口中 JdbcresultSet - 传入带操作的结果集返回结果为-1即调用失败
返回结果为0即调用成功,传入的ResultSet为空
返回结果为大于或等于1即调用成功,返回传入的ResultSet实际行数
@FuncVerification(version="1.0.0", status=Pass, date="2020/4/26 19:07") public ResultSet executeQuery()
executeQuery 在接口中 Jdbc@FuncVerification(version="1.1.0", status=Pass, date="2020/4/26 19:12") public ResultSet executeQuery(String sql)
executeQuery 在接口中 Jdbcsql - 需要查询SQL语句@FuncVerification(version="1.1.0", status=Pass, date="2020/4/27 00:53") public int singleSql(String sql) throws SQLException
singleSql 在接口中 Jdbcsql - 传入标准SQL语句SQLException - Statement执行异常本方法调用Statement
@FuncVerification(version="1.0.0", status=Unverified, date="2020/4/27 00:52") public int singleSql(String sql, Object[] args)
singleSql 在接口中 Jdbcsql - 传入标准SQL语句args - 传入将要插入的值本方法调用PreparedStatement
@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/27 00:01") public int insertSingle(String strTableName, Object[] args)
insertSingle 在接口中 JdbcstrTableName - 传入需要操纵的数据库表名
参数格式:TABLE_A(COLUMN_A,COLUMN_B,COLUMN_C)args - 传入将要插入的值@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/27 00:25") public int updateSingle(String strTable, String[] strColumnName, Object[] args)
updateSingle 在接口中 JdbcstrTable - 传入需要操纵的数据库表名strColumnName - 传入需要操纵的数据表列名称,最后一项为条件列,即表主键
参数格式:TABLE_A,TABLE_B,TABLE_Cargs - 传入将要更新后的值@FuncVerification(version="1.0.0", status=Unverified, date="2020/4/27 00:46") public int delete(String strTable, String strColumnName, String strIds)
@FuncVerification(version="1.0.0",status=Error,date="2020/4/26 19:15",note="\u5411\u6570\u636e\u5e93\u66f4\u65b0\u65f6\u672a\u81ea\u52a8\u5173\u95ed\u6570\u636e\u5e93\u94fe\u63a5\uff0c\u6570\u636e\u590d\u73b0\u4e3aJavaWeb\u5f00\u53d1\u4e2d\uff0cServlet\u5c06\u4f1a\u6301\u4e45\u5316\u672c\u7c7b\u7684\u6570\u636e\u5e93\u94fe\u63a5") @FuncVerification(version="1.1.0",status=Pass,date="2020/5/2 11:10",note="\u672c\u6b21\u7248\u672c\u5c06\u5728\u6267\u884c\u63d0\u4ea4\u540e\u624b\u52a8\u5173\u95ed\u6570\u636e\u5e93\u94fe\u63a5") public int executeUpdate()
executeUpdate 在接口中 Jdbc自本方法v1.1.0开始,使用此方法执行提交后将会自动关闭JdbcImpl所有链接
向数据库更新时未自动关闭数据库链接,数据复现为JavaWeb开发中,Servlet将会持久化本类的数据库链接
@FuncVerification(version="1.0.0", status=Unverified, date="2020/4/27 01:06") public ResultSet runCallableStatement(String proc, Object[] args)
runCallableStatement 在接口中 Jdbcproc - 传入完整SQL语句
参数形式CALL procedure(?...)args - 传入存储过程参数组在使用存储过程前,请了解需要调用的存储过程所需传入的参数和返回结果
@FuncVerification(version="1.0.0", status=Error, date="2020/5/18 21:19") public CallableStatement runCallableStatement(String proc, Object[] args, Object[] outArgs)
CallableStatementrunCallableStatement 在接口中 Jdbcproc - 传入完整SQL语句
参数形式CALL procedure(?...)args - 传入存储过程参数组outArgs - 传入返回值参数CallableStatement@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/26 21:51") public int begin()
@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/26 21:59") public int commitTransaction()
commitTransaction 在接口中 Jdbc返回结果为-1即调用失败
返回结果为0即调用成功,connection不存在,需重新开启事务
@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/26 21:57") public int rollback()
@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/27 01:03") public int changeAutoCommit()
changeAutoCommit 在接口中 Jdbc返回结果为-1即调用失败
返回结果为0即调用成功,connection不存在,需重新开启事务
返回结果为等于1即调用成功
@FuncVerification(version="1.0.0", status=Unverified, date="2020/4/26 23:07") public int add(String sql)
add 在接口中 Jdbcsql - 传入需提交的SQL语句返回结果为-1,statement不存在且创建失败
返回结果为0即调用成功,未执行任何添加操作
返回结果为等于1即调用成功
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得Statement对象addBatch()向Statement追加参数executeBatch()提交批处理@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/26 22:04") public int add(String[] sql)
add 在接口中 Jdbcsql - 传入需提交的SQL语句返回结果为-1,statement不存在且创建失败
返回结果为0即调用成功,未执行任何添加操作
返回结果为大于等于1即调用成功,返回添加成功的实际行数,请检查返回数值是否与传入参数行数相同
本方法采用正序添加至statement,若返回数值小于传入参数行数,截取下标为返回数值开始至末行的数据重新添加。 e.g. 如传入参数为50行,本方法执行后返回数值21,请续传下标为21-49的SQL语句
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得Statement对象addBatch()向Statement追加参数executeBatch()提交批处理@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/26 22:04") public int addBatch(Object[] args)
addBatch 在接口中 Jdbcargs - 传入需提交的参数返回结果为-1即调用失败
返回结果为0即调用成功,connection不存在,需创建PreparedStatement
返回结果为等于1即调用成功,返回传入的ResultSet实际行数
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/26 23:19") public int executeBatch()
executeBatch 在接口中 Jdbc作者认为此方法并不安全,建议使用JdbcImpl.executeBatch(String type)方法,
由于使用者将两种类型的请求在同一实例化对象中完成,可能导致最终提交数据并不是使用者希望提交的数据
返回结果为-2即调用失败,调用过程中产生异常
返回结果为-1即调用失败,statement preparedStatement均为null
返回结果为大于等于0即调用成功,返回受影响行数
本方法执行完成后系统将不会提交本次批处理
Connection连接Connection连接获得PreparedStatement对象addBatch()向PreparedStatement追加参数executeBatch()提交批处理@FuncVerification(version="1.1.0", status=Unverified, date="2020/4/26 23:19") public int executeBatch(int type)
executeBatch 在接口中 Jdbctype - 传入将进行提交的类型,输入错误将返回错误代码-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") public void closePart()
public void close()
throws Exception
close 在接口中 Jdbcclose 在接口中 AutoCloseableException - AutoClosedpublic Statement getStatement()
getStatement 在接口中 Jdbcpublic PreparedStatement getPreparedStatement()
getPreparedStatement 在接口中 Jdbcpublic CallableStatement getCallableStatement()
getCallableStatement 在接口中 Jdbcpublic ResultSet getResultSet()
getResultSet 在接口中 JdbcThis documentation was released into the public domain.