MyBatis学习【二】CRUD测试

既然Mybatis也是一种ORM框架，所以，肯定也有两类配置文件。第一类，用来配置MyBatis环境，比如数据库连接等。第二类，用来配置对象到数据库表的映射。在MyBatis中，不光要配置对象到数据库表的映射，包括对应的SQL，也需要自己来完成（相当于自己来完成hibernate生成对象CRUDsql的过程要自己来完成）。在学习mybatis的过程当中，要对比着hibernate来思考，可以更容易的理解。而且，mybatis在ibatis的基础上面，更多的吸收了标准ORM的一些思想，所以，在API的设计上面和Hibernate还是有相似的地方，可以辅助学习。
    首先任意创建一个对象User：

---

package cd.itcast.mybatis.domain;
    public class User {
        private Long id;
        private String name;
        private Date hireDate;
    //getter & setter
    }

---

下面就使用Mybatis完成对这个对象的CRUD的测试。
    首先创建一个Mybatis的配置文件，我们在classpath下面创建一个xml文件，任意起名为mybatis-config.xml，并加入以下内容：

---

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
    <configuration>
        <environments default="default">
            <environment id="default">
                <transactionManager type="JDBC" />
                <dataSource type="POOLED">
                    <property name="driver" value="com.mysql.jdbc.Driver"/>
                    <property name="url" value="jdbc:mysql:///mybatis"/>
                    <property name="username" value="root"/>
                    <property name="password" value="admin"/>
                </dataSource>
            </environment>
        </environments>
    </configuration>

---

这就是mybatis的一个典型的配置文件。在这个配置文件中，我们可以清楚得看到一些关键信息。第一，有一个environments这个元素，在这个元素里面配置的是一个一个的environment元素，每一个environment元素有一个id做为名字，而environments元素上面有一个default属性，引用environment元素的名称，很容易想象出他们之间的关系。在environments里面可以定义多个enviroment元素，使用default属性指定一个默认的environment。而在environment里面，定义了一组数据库相关的东西，包括transactionManager,这个元素代表着怎么去管理事务，后面还会详细讲到。而下面的dataSource就很明显了，代表连接数据库的相关信息。在这里，dataSource有一个属性type，这里我们写的是POOLED，很明显，使用连接池来做mybatis的连接提供。在        dataSource里面，配置了四个属性，做为数据库连接信息配置。
    接下来，就是为我们的User对象完成映射了。前面说了，在mybatis中，需要自己去控制sql，所以，我们的配置文件会像下面这样。在User的同级包下，添加一个XML文件，起名为UserMapper.xml，代表这个文件是User对象的映射文件：

---

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <mapper namespace="cd.itcast.mybatis.domain.UserMapper">
        <insert id="save" keyProperty="id" parameterType="cd.itcast.mybatis.domain.User"useGeneratedKeys="true">
            INSERT INTO user(name,hiredate) values (#{name},#{hireDate})
        </insert>
    </mapper>

---

Mapper：代表这是一个对象的映射关系
    namespace：为当前映射关系创建的命名空间，要引用这个映射关系里面定义的东西，需要带上这个命名空间。还有其他非常重要的作用，之后会看到。

---

    insert：代表定义了一个插入操作（即SQL的insert操作）
    id：为这个插入操作起一个名字，以后要保存user这个对象，其实就是要调用这个插入操作。
    keyProperty：代表主键对应对象的属性名称。有点像hibernate里面那个id元素。
    parameterType：mybatis里面非常重要的一个元素，代表这个insert操作对应的方法需要传入一个什么类型的对象。这里，我们就是要把User这个对象保存到数据库中，所以，我们这个插入方法的参数就是一个User类型的对象实例。
    useGeneratedKeys：代表告诉mybatis，使用autoGeneratedKey来获取数据库帮我们自动生成的ID。（这个方法在jdbc中讲过）
    INSERT INTO user(name,hiredate) values (#{name},#{hireDate})：非常重要的东西。这就是一条完整的把USER对象插入到user表的SQL语句。但是在这个SQL语句里面，最重要的就是#{name},#{hireDate}这两个占位参数。这两个参数的意思就是：使用传入对象（parameterType）中的name，hireDate两个属性的值来填充这两个参数内容。
完成映射文件之后，在mybatis-config.xml中加入映射文件：

---

<mappers>
        <mapper resource="cd/itcast/mybatis/domain/UserMapper.xml"/>
    </mappers>

---

插入操作的测试。1，首先创建一个USER表：

---

CREATE TABLE `user` (
        `id` bigint(11) NOT NULL AUTO_INCREMENT,
        `name` varchar(50) DEFAULT NULL,
        `hiredate` date DEFAULT NULL,
        PRIMARY KEY (`id`)
    )

---

然后创建一个UserTest类：

---

@Test
    public void testSave() throws Exception{
        SqlSessionFactory factory= new SqlSessionFactoryBuilder().build(Resources .getResourceAsStream("mybatis-config.xml"));
        SqlSession session = factory.openSession();
        try {
            User u = new User();
            u.setName("itcasT");
            u.setHireDate(new Date());
            session.insert("cd.itcast.mybatis.domain.UserMapper.save", u);
            session.commit();
        } finally {
            session.close();
        }
    }

---

1，Resources .getResourceAsStream("mybatis-config.xml")：使用Reources类的静态方法getResourceAsStream，从classpath:mybatis-config.xml位置读入配置文件，并装成inputStream。
    2，SqlSessionFactory factory= new SqlSessionFactoryBuilder().build(inputStream)：使用读入的流，创建SqlSessionFactory。可以从名字上类比hibernate。
    3，SqlSession session = factory.openSession();使用factory开启一个SqlSession。SqlSession即是在mybatis中操作实体对象的主要的类了。
    4，User u = new User();创建一个需要保存的实体类。
    5，session.insert("cd.itcast.mybatis.domain.UserMapper.save", u)：非常重要的方法，使用session的insert方法，对比上面的映射文件，即告诉mybatis现在调用的是一个标记到insert元素中的SQL语句，接着传入cd.itcast.mybatis.domain.UserMapper.save，很明显这个就是namespace+id拼成的，意思就是我要调用的是定义在cd.itcast.mybatis.domain.UserMapper这个映射关系中的名字为save的insert语句。这个语句需要传入一个cd.itcast.mybatis.domain.User对象实例做为参数，所以把创建的User实体做为参数传入。
    6，session.commit()：很明显，即提交事务。
    7，session.close()：和hibernate一样，使用完后，都必须要关闭session。
    从整个代码上面可以很明显的猜测到mybatis的创建过程。执行测试，保存成功。但是看不到mybatis执行的sql，怎么办？日志：
    在classpath中建立一个名叫log4j.properties的文件，内容如下：

---

# Global logging configuration
    log4j.rootLogger=ERROR, stdout
    # MyBatis logging configuration...
    log4j.logger.cd.itcast.mybatis=TRACE
    # Console output...
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

---

很明显，log4j.logger.cd.itcast.mybatis意思就是要监控cd.itcast.mybatis包下面的所有mapper的动作。再次运行：

---

DEBUG [main] - ooo Using Connection [com.mysql.jdbc.JDBC4Connection@79a2e7]
    DEBUG [main] - ==>  Preparing: INSERT INTO user(name,hiredate) values (?,?) 
    DEBUG [main] - ==> Parameters: itcasT(String), 2012-09-12 15:10:16.812(Timestamp)

---

可以很清楚的看到执行的sql和执行sql使用的参数。

http://url.cn/NdQlYr