cn.tenmg.sqltool.transaction

类 CustomTransactionExecutor

java.lang.Object

cn.tenmg.sqltool.transaction.CustomTransactionExecutor

所有已实现的接口:

Serializable

public class CustomTransactionExecutor
extends Object
implements Serializable

自定义事务执行器

作者:

赵伟均 wjzhao@aliyun.com

另请参阅:

序列化表格

构造器概要

构造器

构造器和说明
CustomTransactionExecutor()

方法概要

限定符和类型	方法和说明
void	beginTransaction(Map<String,String> options) 开始事务
void	commit() 提交事务
<T extends Serializable> int	delete(List<T> rows) 删除操作（实体对象集为空则直接返回0）
<T extends Serializable> int	delete(T obj) 删除操作
boolean	execute(String dsql, Map<String,?> params) 使用动态结构化查询语言（DSQL）执行插入、修改、删除操作。
boolean	execute(String dsql, Object... params) 使用动态结构化查询语言（DSQL）执行插入、修改、删除操作。
int	executeUpdate(String dsql, Map<String,?> params) 使用动态结构化查询语言（DSQL）执行插入、修改、删除操作。
int	executeUpdate(String dsql, Object... params) 使用动态结构化查询语言（DSQL）执行插入、修改、删除操作。
<T extends Serializable> T	get(Class<T> type, String dsql, Map<String,?> params) 使用动态结构化查询语言（DSQL）并组装对象，其中类型可以是实体对象，也可以是String、Number、 Date、BigDecimal类型，这时将返回结果集中的第1行第1列的值。
<T extends Serializable> T	get(Class<T> type, String dsql, Object... params) 使用动态结构化查询语言（DSQL）并组装对象，其中类型可以是实体对象，也可以是String、Number、 Date、BigDecimal类型，这事将返回结果集中的第1行第1列的值。
<T extends Serializable> T	get(T obj) 从数据库查询并组装实体对象。
int	getDefaultBatchSize()
DSQLFactory	getDSQLFactory()
<T extends Serializable> int	hardSave(List<T> rows) 硬保存。
<T extends Serializable> int	hardSave(T obj) 硬保存。
<T extends Serializable> int	insert(List<T> rows) 插入操作（实体对象集为空则直接返回null）。
<T extends Serializable> int	insert(T obj) 插入操作。
boolean	isShowSql()
void	rollback() 事务回滚。
<T extends Serializable> int	save(List<T> rows) 软保存。
<T extends Serializable> int	save(List<T> rows, String... hardFields) 部分硬保存。
<T extends Serializable> int	save(T obj) 软保存。
<T extends Serializable> int	save(T obj, String... hardFields) 部分硬保存。
<T extends Serializable> List<T>	select(Class<T> type, String dsql, Map<String,?> params) 使用动态结构化查询语言（DSQL）并组装对象列表，其中类型可以是实体对象，也可以是String、Number、 Date、BigDecimal类型，这时将返回结果集中的第1列的值。
<T extends Serializable> List<T>	select(Class<T> type, String dsql, Object... params) 使用动态结构化查询语言（DSQL）并组装对象列表，其中类型可以是实体对象，也可以是String、Number、 Date、BigDecimal类型，这时将返回结果集中的第1列的值。
<T extends Serializable> List<T>	select(T obj) 从数据库查询并组装实体对象列表。
void	setDefaultBatchSize(int defaultBatchSize)
void	setDSQLFactory(DSQLFactory DSQLFactory)
void	setShowSql(boolean showSql)

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

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

构造器详细资料

CustomTransactionExecutor

public CustomTransactionExecutor()

方法详细资料

getDSQLFactory

public DSQLFactory getDSQLFactory()

setDSQLFactory

public void setDSQLFactory(DSQLFactory DSQLFactory)

isShowSql

public boolean isShowSql()

setShowSql

public void setShowSql(boolean showSql)

getDefaultBatchSize

public int getDefaultBatchSize()

setDefaultBatchSize

public void setDefaultBatchSize(int defaultBatchSize)

beginTransaction

public void beginTransaction(Map<String,String> options)

开始事务

参数:

options - 数据库配置

insert

public <T extends Serializable> int insert(T obj)
                                    throws SQLException

插入操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

obj - 实体对象（不能为null）

返回:

返回受影响行数

抛出:

SQLException - SQL异常

insert

public <T extends Serializable> int insert(List<T> rows)
                                    throws SQLException

插入操作（实体对象集为空则直接返回null）。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

rows - 实体对象集

返回:

返回受影响行数

抛出:

SQLException - SQL异常

save

public <T extends Serializable> int save(T obj)
                                  throws SQLException

软保存。仅对属性值不为null的字段执行插入/更新操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

obj - 实体对象

返回:

返回受影响行数

抛出:

SQLException - SQL异常

save

public <T extends Serializable> int save(T obj,
                                         String... hardFields)
                                  throws SQLException

部分硬保存。仅对属性值不为null或硬保存的字段执行插入/更新操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

obj - 实体对象

hardFields - 硬保存属性

返回:

返回受影响行数

抛出:

SQLException - SQL异常

save

public <T extends Serializable> int save(List<T> rows)
                                  throws SQLException

软保存。仅对属性值不为null的字段执行插入/更新操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

rows - 实体对象集

返回:

返回受影响行数

抛出:

SQLException - SQL异常

save

public <T extends Serializable> int save(List<T> rows,
                                         String... hardFields)
                                  throws SQLException

部分硬保存。仅对属性值不为null或硬保存的字段执行插入/更新操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

rows - 实体对象集

hardFields - 硬保存属性

返回:

返回受影响行数

抛出:

SQLException - SQL异常

hardSave

public <T extends Serializable> int hardSave(T obj)
                                      throws SQLException

硬保存。对所有字段执行插入/更新操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

obj - 实体对象

返回:

返回受影响行数

抛出:

SQLException - SQL异常

hardSave

public <T extends Serializable> int hardSave(List<T> rows)
                                      throws SQLException

硬保存。对所有字段执行插入/更新操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

rows - 实体对象集

返回:

返回受影响行数

抛出:

SQLException - SQL异常

delete

public <T extends Serializable> int delete(T obj)
                                    throws SQLException

删除操作

参数:

obj - 实体对象（不能为null）

返回:

返回受影响行数

抛出:

SQLException - SQL异常

delete

public <T extends Serializable> int delete(List<T> rows)
                                    throws SQLException

删除操作（实体对象集为空则直接返回0）

参数:

rows - 实体对象集

返回:

返回受影响行数

抛出:

SQLException - SQL异常

get

public <T extends Serializable> T get(T obj)
                               throws SQLException

从数据库查询并组装实体对象。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

obj - 实体对象

返回:

返回查询到的实体对象

抛出:

SQLException - SQL异常

get

public <T extends Serializable> T get(Class<T> type,
                                      String dsql,
                                      Object... params)
                               throws SQLException

使用动态结构化查询语言（DSQL）并组装对象，其中类型可以是实体对象，也可以是String、Number、 Date、BigDecimal类型，这事将返回结果集中的第1行第1列的值。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

type - 对象类型

dsql - 动态结构化查询语言

params - 查询参数键值集

返回:

返回查询到的对象

抛出:

SQLException - SQL异常

get

public <T extends Serializable> T get(Class<T> type,
                                      String dsql,
                                      Map<String,?> params)
                               throws SQLException

使用动态结构化查询语言（DSQL）并组装对象，其中类型可以是实体对象，也可以是String、Number、 Date、BigDecimal类型，这时将返回结果集中的第1行第1列的值。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

type - 对象类型

dsql - 动态结构化查询语言

params - 查询参数键值集

返回:

返回查询到的对象

抛出:

SQLException - SQL异常

select

public <T extends Serializable> List<T> select(T obj)
                                        throws SQLException

从数据库查询并组装实体对象列表。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

obj - 实体对象

返回:

返回查询到的实体对象列表

抛出:

SQLException - SQL异常

select

public <T extends Serializable> List<T> select(Class<T> type,
                                               String dsql,
                                               Object... params)
                                        throws SQLException

使用动态结构化查询语言（DSQL）并组装对象列表，其中类型可以是实体对象，也可以是String、Number、 Date、BigDecimal类型，这时将返回结果集中的第1列的值。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

type - 对象类型

dsql - 动态结构化查询语言

params - 查询参数键值集

返回:

返回查询到的对象列表

抛出:

SQLException - SQL异常

select

public <T extends Serializable> List<T> select(Class<T> type,
                                               String dsql,
                                               Map<String,?> params)
                                        throws SQLException

使用动态结构化查询语言（DSQL）并组装对象列表，其中类型可以是实体对象，也可以是String、Number、 Date、BigDecimal类型，这时将返回结果集中的第1列的值。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

type - 对象类型

dsql - 动态结构化查询语言

params - 查询参数键值集

返回:

返回查询到的对象列表

抛出:

SQLException - SQL异常

execute

public boolean execute(String dsql,
                       Object... params)

使用动态结构化查询语言（DSQL）执行插入、修改、删除操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

dsql - 动态结构化查询语言

params - 查询参数键值集

返回:

如果第一个结果是ResultSet对象，则为true；如果第一个结果是更新计数或没有结果，则为false

execute

public boolean execute(String dsql,
                       Map<String,?> params)

使用动态结构化查询语言（DSQL）执行插入、修改、删除操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

dsql - 动态结构化查询语言

params - 查询参数键值集

返回:

如果第一个结果是ResultSet对象，则为true；如果第一个结果是更新计数或没有结果，则为false

executeUpdate

public int executeUpdate(String dsql,
                         Object... params)

使用动态结构化查询语言（DSQL）执行插入、修改、删除操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

dsql - 动态结构化查询语言

params - 查询参数键值集

返回:

返回受影响行数

executeUpdate

public int executeUpdate(String dsql,
                         Map<String,?> params)

使用动态结构化查询语言（DSQL）执行插入、修改、删除操作。该方法不自动提交事务，且调用前需要先调用beginTransaction方法开启事务，之后在合适的时机还需要调用commit方法提交事务。

参数:

dsql - 动态结构化查询语言

params - 查询参数键值集

返回:

返回受影响行数

rollback

public void rollback()

事务回滚。在业务方法发生异常时调用。

commit

public void commit()

提交事务