文档

框架概述

DAO 框架内置支持 JDBC、MyBatis 和 Hibernate 数据库访问方法,并对数据库访问机
制进行了抽象,为不同的数据库访问方法提供一致的使用接口。DAO 框架主要由以下三种组件构成:

Session  Manager

实现 SessionMgr 接口,负责创建和维护数据库连接对象(Session)。
nsg通过配置的方式在应用程序启动过程中创建 Session Manager。DAO 框架为 JDBC、
MyBatis 和 Hibernate 实现了相应的 Session Manager:

  • JDBC    :org.nsg.dao.jdbc.JdbcSessionMgr
                        :org.nsg.dao.jdbc.DruidSessionMgr
  • MyBatis    :org.nsg.dao.mybatis.MybatisSessionMgr
  • Hibernate  :org.nsg.dao.hbn.HibernateSessionMgr
  • DAO Facade:org.nsg.dao.AbstractFacade
    DAO  Facade 派生于抽象类 AbstractFacade,是所有用户 DAO 的基类


DAO  Facade 并实现应用程序的数据库访问方法。应用程序不会直接创建 DAO  Facade 或用
户 DAO 对象实例,而是通过 FacadeProxy 创建其代理对象。DAO 框架为 JDBC、MyBatis
和 Hibernate 实现了各自的 DAO Facade:
  JDBC    :org.nsg.dao.jdbc.JdbcFacade
  MyBatis    :org.nsg.dao.mybatis.MybatisFacade
  Hibernate  :org.nsg.dao.hbn.HibernateFacade

DAO Facade Proxy 负责创建 DAO 代理对象,该代理对象隐含事务处理和连接管理等操
作。因此, 应用程序应该使用由 DAO Facade Proxy 创建的代理对象访问数据库,而不该直
接创建 DAO 对象。
当执行 DAO  代理对象的数据库访问方法时,如果发生错误会抛出 DAOException
(org.nsg.dao.DAOException),它是 Runtime  Exception,如果有需要,程序可以在代码
中捕捉这个异常。
在应用程序中使用 DAO 框架一般需要执行以下四个步骤:


1.  在应用程序配置文件(默认:app-config.xml)中配置 Session Manager
2.  根据应用程序的需要创建 DAO 类,并实现数据库访问方法
3.  通过 DAO Facade Proxy 获取 DAO 代理对象
4.  通过 DAO 代理对象执行数据库访问方法



Session Manager初始化


Session Manager 实现了 SessionMgr 接口,SessionMgr 接口中的两个方法:
  void initialize(String ... args)
  void unInitialize()
分别用于初始化和销毁 Session  Manager。如果在应用程序配置文件中配置了 Session
Manager,则会在应用程序启动时创建该 Session Manager 的实例并调用它的 initialize(String ...
args)  方法;在应用程序关闭前调用它的 unInitialize()  方法。对于不同类型的 Session
Manager, initialize(String ... args)  方法的参数个数和意义不确定,由 Session Manager 自行解
析,下面分别阐述 nsg内置的 Session Manager 的初始化参数含义:

  JDBC  Session  Manager : 、 JdbcSessionMgr 、DruidSessionMgr

(其他 JDBC Session Manager :   JdbcSessionMgr、 DruidSessionMgr
的参数说明请参考 API 文档)

DAO Facade


DAO Facade 派生于抽象类 AbstractFacade。作为用户 DAO 的基类, nsg内置的 DAO
Facade 都提供了很多非常有用的底层数据库访问方法,用户 DAO 使用这些方法执行数据库
访问能大大减少编程的代码量,这些方法的使用说明请参考 API 文档。
  JDBC DAO Facade:org.nsg.dao.jdbc.JdbcFacade
  call(…)            :执行存储过程
  query(…)          :执行查询操作
  update(…)          :执行更新操作
  updateAndGenerateKeys(…)    :执行更新操作,并返回被影响行的主键
  updateBatch(…)        :执行批量更新操作
  MyBatis DAO Facade:org.nsg.dao.jdbc.MybatisFacade
  selectXxx(…)          :执行查询操作
  insert(…)          :执行插入操作
  update(…)          :执行更新操作
  delete(…)          :执行删除操作
  clearCache(…)        :清空 Session 缓存
  getMapper(…)        :获取 VO Mapper
  changeSessionExecutorTypeToXxx(…)  :更改 Session 的 Executor Type
  Hibernate DAO Facade:org.nsg.dao.jdbc.HibernateFacade
  hqlQueryX(…)      :执行 HQL 查询操作
  hqlUpdateX(…)      :执行 HQL 更新操作
  namedQueryX (…)      :执行命名查询操作
  namedUpdateX (…)    :执行命名更新操作
  qbcQuery(…)        :执行 QBC 查询操作
  sqlQueryX(…)      :执行 SQL 查询操作
  sqlUpdate(…)        :执行 SQL 更新操作
  save(…)          :保存 VO
  update(…)        :更新 VO
  saveOrUpdate (…)     :保存或更新 VO
  delete (…)        :删除 VO
  get(…)          :获取 VO
  load(…)          :加载 VO
  clear(…)         :清空 Session 缓存
  flush(…)          :刷新 Session 缓存

posted @ 2014-10-10 13:17  子木聊出海  阅读(258)  评论(0编辑  收藏  举报