org.jessma.dao

类 FacadeProxy

java.lang.Object

org.jessma.dao.FacadeProxy

public class FacadeProxy
extends Object

Facade 代理类

构造器概要

构造器

构造器和说明
FacadeProxy()

方法概要

方法

限定符和类型	方法和说明
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	create(Class<F> daoClass) 获取 daoClass 的代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	create(Class<F> daoClass, M mgr) 获取 daoClass 的代理对象。
static <M extends SessionMgr<S>,S> void	executeCustomTransaction(M mgr, CustomTransaction<M,S> trans) 执行自定义事务 JessMA 的事务是 DAO 层事务，也就是说当外部调用某个 DAO 方法时，该方法作为一个事务单元执行。
static <M extends SessionMgr<S>,S> void	executeCustomTransaction(M mgr, TransIsoLevel level, CustomTransaction<M,S> trans) 执行自定义事务 JessMA 的事务是 DAO 层事务，也就是说当外部调用某个 DAO 方法时，该方法作为一个事务单元执行。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getAutoCommitProxy(Class<F> daoClass) 获取 daoClass 的自动提交事务代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getAutoCommitProxy(Class<F> daoClass, M mgr) 获取 daoClass 的自动提交事务代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getManualCommitProxy(Class<F> daoClass) 获取 daoClass 的手动提交事务代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getManualCommitProxy(Class<F> daoClass, M mgr) 获取 daoClass 的手动提交事务代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getManualCommitProxy(Class<F> daoClass, M mgr, TransIsoLevel level) 获取 daoClass 的手动提交事务代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getManualCommitProxy(Class<F> daoClass, TransIsoLevel level) 获取 daoClass 的手动提交事务代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getProxy(Class<F> daoClass, boolean autoCommit) 获取 daoClass 的代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getProxy(Class<F> daoClass, M mgr, boolean autoCommit) 获取 daoClass 的代理对象。
static <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F	getProxy(Class<F> daoClass, M mgr, boolean autoCommit, TransIsoLevel level) 获取 daoClass 的代理对象。

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

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

构造器详细资料

FacadeProxy

public FacadeProxy()

方法详细资料

getAutoCommitProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getAutoCommitProxy(Class<F> daoClass)

获取 daoClass 的自动提交事务代理对象。 其中，SessionMgr 由 daoClass 的默认构造函数提供。

参数:

daoClass - : 被代理的数据库访问类对象

返回:

与 daoClass 有相同接口的代理对象

getAutoCommitProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getAutoCommitProxy(Class<F> daoClass,
                                                                             M mgr)

获取 daoClass 的自动提交事务代理对象。 其中，SessionMgr 由 mgr 指定。

参数:

daoClass - : 被代理的数据库访问类对象

mgr - : SessionMgr

返回:

与 daoClass 有相同接口的代理对象

getManualCommitProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getManualCommitProxy(Class<F> daoClass)

获取 daoClass 的手动提交事务代理对象。 其中，SessionMgr 由 daoClass 的默认构造函数提供。

参数:

daoClass - : 被代理的数据库访问类对象

返回:

与 daoClass 有相同接口的代理对象

getManualCommitProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getManualCommitProxy(Class<F> daoClass,
                                                                               M mgr)

获取 daoClass 的手动提交事务代理对象。 其中，SessionMgr 由 mgr 指定。

参数:

daoClass - : 被代理的数据库访问类对象

mgr - : SessionMgr

返回:

与 daoClass 有相同接口的代理对象

getManualCommitProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getManualCommitProxy(Class<F> daoClass,
                                                                               TransIsoLevel level)

获取 daoClass 的手动提交事务代理对象。 其中，SessionMgr 由 mgr 指定。

参数:

daoClass - : 被代理的数据库访问类对象

level - : TransIsoLevel

返回:

与 daoClass 有相同接口的代理对象

getManualCommitProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getManualCommitProxy(Class<F> daoClass,
                                                                               M mgr,
                                                                               TransIsoLevel level)

获取 daoClass 的手动提交事务代理对象。 其中，SessionMgr 由 mgr 指定。

参数:

daoClass - : 被代理的数据库访问类对象

mgr - : SessionMgr

level - : TransIsoLevel

返回:

与 daoClass 有相同接口的代理对象

getProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getProxy(Class<F> daoClass,
                                                                   boolean autoCommit)

获取 daoClass 的代理对象。 其中，SessionMgr 由 daoClass 的默认构造函数提供，是否自动提交事务 transactional 指定。

参数:

daoClass - : 被代理的数据库访问类对象

autoCommit - : 是否自动提交事务（为了提高执行效率，对于只执行查询的访问通常采用自动提交事务）

返回:

与 daoClass 有相同接口的代理对象

getProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getProxy(Class<F> daoClass,
                                                                   M mgr,
                                                                   boolean autoCommit)

获取 daoClass 的代理对象。 其中，SessionMgr 由 mgr 指定，是否自动提交事务由 autoCommit 参数指定。

参数:

daoClass - : 被代理的数据库访问类对象

mgr - : SessionMgr

autoCommit - : 是否自动提交事务（为了提高执行效率，对于只执行查询的访问通常采用自动提交事务）

返回:

与 daoClass 有相同接口的代理对象

getProxy

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F getProxy(Class<F> daoClass,
                                                                   M mgr,
                                                                   boolean autoCommit,
                                                                   TransIsoLevel level)

获取 daoClass 的代理对象。 其中，SessionMgr 由 mgr 指定，是否自动提交事务由 autoCommit 参数指定。

参数:

daoClass - : 被代理的数据库访问类对象

mgr - : SessionMgr

autoCommit - : 是否自动提交事务（为了提高执行效率，对于只执行查询的访问通常采用自动提交事务）

level - : TransIsoLevel

返回:

与 daoClass 有相同接口的代理对象

create

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F create(Class<F> daoClass)

获取 daoClass 的代理对象。 其中，SessionMgr 由 daoClass 的默认构造函数提供。

参数:

daoClass - : 被代理的数据库访问类对象

返回:

与 daoClass 有相同接口的代理对象

create

public static final <F extends AbstractFacade<M,S>,M extends SessionMgr<S>,S> F create(Class<F> daoClass,
                                                                 M mgr)

获取 daoClass 的代理对象。 其中，SessionMgr 由 mgr 指定。

参数:

daoClass - : 被代理的数据库访问类对象

mgr - : SessionMgr

返回:

与 daoClass 有相同接口的代理对象

executeCustomTransaction

public static final <M extends SessionMgr<S>,S> void executeCustomTransaction(M mgr,
                                                        CustomTransaction<M,S> trans)
                                           throws DAOException

执行自定义事务
JessMA 的事务是 DAO 层事务，也就是说当外部调用某个 DAO 方法时，该方法作为一个事务单元执行。 但在一些特殊情形下可能需要在 DAO 方法外部执行事务（例如：作为一个事务单元调用多个 DAO 对象的多个方法）， 此时可以创建一个自定义事务（CustomTransaction），并调用 FacadeProxy 的 executeCustomTransaction(...) 来执行该自定义事务。自定义事务执行规则：

• FacadeProxy.executeCustomTransaction(...) 一般在 DAO 方法外部调用
• FacadeProxy.executeCustomTransaction(...) 也可以在 DAO 方法内部调用，但如果调用它的 DAO 方法与它拥有共同的 SessionMgr，则事务属性由该 DAO 方法控制
• CustomTransaction 的事务入口方法 execute(SessionMgr) 作为一个事务单元
• CustomTransaction.execute(SessionMgr) 方法中可以用 new 方式直接创建的 DAO 对象，也可以用 FacadeProxy 的代理方法 （create() / getXxxCommitProxy()）创建 DAO 对象，无论采用哪种方式创建的 DAO 对象，DAO 对象的事务属性均由 FacadeProxy.executeCustomTransaction(...) 指定

参数:

mgr - : SessionMgr

trans - : 自定义事务

抛出:

DAOException

executeCustomTransaction

public static final <M extends SessionMgr<S>,S> void executeCustomTransaction(M mgr,
                                                        TransIsoLevel level,
                                                        CustomTransaction<M,S> trans)
                                           throws DAOException

执行自定义事务
JessMA 的事务是 DAO 层事务，也就是说当外部调用某个 DAO 方法时，该方法作为一个事务单元执行。 但在一些特殊情形下可能需要在 DAO 方法外部执行事务（例如：作为一个事务单元调用多个 DAO 对象的多个方法）， 此时可以创建一个自定义事务（CustomTransaction），并调用 FacadeProxy 的 executeCustomTransaction(...) 来执行该自定义事务。自定义事务执行规则：

• FacadeProxy.executeCustomTransaction(...) 一般在 DAO 方法外部调用
• FacadeProxy.executeCustomTransaction(...) 也可以在 DAO 方法内部调用，但如果调用它的 DAO 方法与它拥有共同的 SessionMgr，则事务属性由该 DAO 方法控制
• CustomTransaction 的事务入口方法 execute(SessionMgr) 作为一个事务单元
• CustomTransaction.execute(SessionMgr) 方法中可以用 new 方式直接创建的 DAO 对象，也可以用 FacadeProxy 的代理方法 （create() / getXxxCommitProxy()）创建 DAO 对象，无论采用哪种方式创建的 DAO 对象，DAO 对象的事务属性均由 FacadeProxy.executeCustomTransaction(...) 指定

参数:

mgr - : SessionMgr

level - : 事务隔离级别

trans - : 自定义事务

抛出:

DAOException