iBATIS系统学习笔记四

最新推荐文章于 2019-06-20 11:23:49 发布

啊昕Alan

最新推荐文章于 2019-06-20 11:23:49 发布

阅读量460

点赞数

分类专栏： J2EE 文章标签： ibatis

本文链接：https://blog.csdn.net/u011768896/article/details/43968995

版权

J2EE 专栏收录该内容

15 篇文章 0 订阅

订阅专栏

目录：
学习笔记零 - 起源
 学习笔记一 - 概念与入门
 学习笔记二 - 基础配置
 学习笔记三 - 高级技巧与进阶

最佳实践

1 iBATIS中的单元测试

iBATIS至少在3个方面可以使得单元测试变得容易：
- 测试映射层本身
- 测试DAO层
- 在DAO的消费层（使用层）进行测试

1.1 对映射层进行单元测试

测试用数据库实例
即数据库管理系统的实例，比如SQL SERVER。
JAVA程序员可以使用内存数据库，如HSQLDB。

数据库脚本
数据库模式以及测试数据的构造与创建。即通过数据库脚本进行创建，这些数据库脚本保持和程序源代码同步。

iBATIS配置文件
分别进行测试环境配置和产品环境配置最简单的方式就是，使用不同的iBATIS配置文件，两份配置文件引用相同的一组SQL配置文件。

iBATIS SqlMapClient单元测试
单元测试：

public class PersonMapTest extends TestCase {
    private SqlMapClient sqlMapClient;
    public void setup () {
        sqlMapClient = SqlMapClientBuilder.
        build("maps/TestSqlMapConfig.xml");
        runSqlScript("scripts/drop-person-schema.sql");
        runSqlScript("scripts/create-person-schema.sql");
        runSqlScript("scripts/create-person-test-data.sql");
    }

    public void testShouldGetPersonWithIdOfOne() {
        Person person = (Person) sqlMapClient.queryForObject("getPerson", new Integer(1));
        assertNotNull("Expected to find a person.", person);
        assertEquals("Expected person ID to be 1.",
        new Integer(1), person.getId());
    }
}

1.2 对DAO进行单元测试

DAO层是一个抽象层，通常分离为一个接口和一个实现，单测试接口没有作用，所以需要直接对DAO的实现进行测试。

利用模拟对象来对DAO进行单元测试
提供一个Dao实现：

public class SqlMapPersonDao implements PersonDao {
    private SqlMapClient sqlMapClient;
    public SqlMapPersonDao(SqlMapClient sqlMapClient) {
        this.sqlMapClient = sqlMapClient;
    }
    public Person getPerson (int id) {
        try {
            return (Person)
            sqlMapClient.queryForObject("getPerson", id);
        } catch (SQLException e) {
            throw new DaoRuntimeException("Error getting person. Cause: " + e, e);
        }
    }
}

使用JMock对象模拟框架

public void testShouldGetPersonFromDaoWithIDofOne() {
    final Integer PERSON_ID = new Integer(1);
    Mock mock = new Mock(SqlMapClient.class);
    mock.expects(once()).method("queryForObject").with(eq("getPerson"),eq(PERSON_ID)).will(returnValue(new Person (PERSON_ID)));
    PersonDao daoSqlMap = new SqlMapPersonDao((SqlMapClient)mock.proxy());
    Person person = daoSqlMap.getPerson(PERSON_ID);
    assertNotNull("Expected non-null person instance.",person);
    assertEquals("Expected ID to be " + PERSON_ID,PERSON_ID, person.getId());
}

1.3 对DAO的消费层进行单元测试

应用程序中使用DAO的层的其他层就是DAO层的消费层。

简单的DAO接口：

public interface PersonDao extends Dao {
    Person getPerson(Integer id);
}

使用DAO接口的服务：

public class PersonService {
    private PersonDao personDao;
    public PersonService(PersonDao personDao) {
        this.personDao = personDao;
    }
    public Person getValidatedPerson(Integer personId) {
        Person person = personDao.getPerson(personId);
        validateAgainstPublicSystems(person);
        validateAgainstPrivateSystems(person);
        validateAgainstInternalSystems(person);
        return person;
    }
}

使用模拟DAO，避免访问数据库：

public void testShouldRetrieveAValidatedPerson (){
    final Integer PERSON_ID = new Integer(1);
    Mock mock = new Mock(PersonDao.class);
    mock.expects(once()).method("getPerson").with(eq(PERSON_ID)).will(returnValue(new Person(PERSON_ID)));
    PersonService service = new PersonService((PersonDao)mock.proxy());
    service.isPersonalInformationValid(new Person(new Integer(1)), new Integer(1));
    assertNotNull("Expected non-null person instance.",person);
    assertEquals("Expected ID to be " + PERSON_ID,PERSON_ID, person.getId());
    assertTrue("Expected valid person.",
    person.isValid());
}

上例也使用了JUnit和JMock。

2 管理iBATIS配置文件

2.1 将其保存在类路径上

位置透明(location transparency) 是应用程序可维护性的一个重要方面。它可以简化应用程序的测试和部署。
保持位置透明的一个方法就是：不要在应用程序中使用静态的文件路径。
使用java类路径，应用程序就可以通过使用类加载器(classloader)在内部访问它。

将映射文件存储在类路径上之后，iBATIS就可以通过Resource实用类（iBATIS提供的类）来加载这些文件。如：

Reader reader = Resources.getResourceAsReader("config/maps/SqlMapConfig.xml");

2.2 集中放置文件

应把所有的映射文件集中放置，避免分散在类路径上。千万不要把它们放置在它们所处理的类的旁边，也不要存储在单独的包中，这会使得配置变得复杂，并且很难弄清楚有哪些映射文件可用。不要和其他XML文件混淆在一起

2.3 按返回类型来组织映射文件

刚开始时，最好利用语句的返回类型以及语句接受的参数类型来组织映射文件。

3 命名规范

iBATIS有很多东西需要命名：语句、结果映射、参数映射、SQL映射文件，以及XML文件都需要命名。因此，最好有一种命名规范。

3.1 语句的命名

语句命名通常遵循编程语言中方法的命名规范，如loadPerson，getPerson。

3.2 参数映射的命名

建议使用参数映射的语句的名字后添以Param后缀作为该参数映射的名字。

<select id="getPerson" parameterMap="getPersonParam" ... >

3.3 结果映射的命名

建议添加Result后缀

<resultMap id="PersonResult" type="com.domain.Person">

3.4 XML文件的命名

iBATIS中有两类XML文件，第一类是主配置文件，第二类是SQL映射文件。
主配置文件
推荐使用SqlMapConfig.xml。如果应用程序的不同模块有不同的配置文件，那么将该模块的名字作为前缀添加到配置文件名中。如WebSqlMapConfig.xml,GuiSqlMapConfig.xml。

SQL映射文件
取决于组织方式，如果是根据映射语句的返回类型组织的，那直接使用参数命名即可，如Person.xml。
如果某些应用程序需要对同一个映射语句做多个实现以匹配不同的数据库，那可以使用OraclePerson.xml这样的命名方式。