一步步学Mybatis-实现单表情况下的CRUD操作 （3）

今天这一章要紧接上一讲中的东西，本章中创建基于单表操作的CRUD与GetList操作，此示例中以Visitor表为范例，为了创建一点测试数据我们先弄个Add方法吧

继续在上次的IVisitorOperation接口类中添加add，delete，update，query与getList接口方法，如下所示：

    /*
     * 基础查询
     */
    public Visitor basicQuery(int id);

    /*
     * 添加访问者
     */
    public int add(Visitor visitor);
    
    /*
     * 删除访问者
     */
    public int delete(int id);
    
    /*
     * 更新访问者
     */
    public int update(Visitor visitor);
    
    /*
     * 查询访问者
     */
    public Visitor query(int id);
    
    /*
     * 查询访问者List
     */
    public List<Visitor> getList();

对于相应的CRUD操作，在VisitorMapper.xml的<mapper>节点下分别对应insert，update，delete，select节点，具体配置详情参数说明课参照官网 http://mybatis.github.io/mybatis-3/sqlmap-xml.html
这个示例中要的配置如下，传递的参数用#{parameter_name}，当然也可直接用${parameter_name}，

前者的方式，Mybatis会把它转化为参数化的形式例如 insert into table (name) values (#{name}) => insert into table (name) values ( ? ) (Mysql情况下)

后者的方式，Mybatis会原封不动的不做任何操作把参数传过来，例如  insert into table (name) values (${name}) => insert into table (name) values ( [你所传的值] )，传aa，这里就是aa，传'aa'这里就是'aa'。

<?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="david.mybatis.demo.IVisitorOperation">
    <!-- 
        useGeneratedKeys="true"代表是否使用自增长序列, 
        keyProperty="Id"指定自增长列是哪一列, 
        parameterType="Visitor"指定IVisitorOperation接口类中定义中所传的相应类型
        resultType 表示返回的类型，例如query中的visitor
        resultMap 自定义的返回类型，是返回复杂类型是的最佳首选，也是mybatis里最强大的武器
     -->
    <insert id="add" parameterType="Visitor" useGeneratedKeys="true"
        keyProperty="Id">
        insert into Visitor (Name, Email, Status, CreateTime)
        values (#{name}, #{email}, #{status}, #{createTime})
    </insert>
    <delete id="delete" parameterType="int">
        delete from Visitor where
        status>0 and id = #{id}
    </delete>
    <update id="update" parameterType="Visitor">
        update Visitor set Name =
        #{name}, Email=#{email}, Status=#{status} where id=#{id} and Status>0;
    </update>
    <select id="query" parameterType="int" resultType="Visitor">
        select Id,
        Name, Email, Status, CreateTime from visitor where id=#{id} and
        Status>0 order by Id
    </select>
    <select id="basicQuery" parameterType="int" resultType="Visitor">
        select * from visitor where id=#{id} and
        Status>0 order by Id
    </select>
    <select id="getList" resultMap="visitorRs">
        <include refid="getListSql" />
    </select>
    <resultMap type="Visitor" id="visitorRs">
        <id column="Id" property="id" />
        <result column="Name" property="name" />
        <result column="Email" property="email" />
        <result column="Status" property="status" />
        <result column="CreateTime" property="createTime" />
    </resultMap>
    <sql id="getListSql">
        select * from Visitor where
        status>0
    </sql>
</mapper>

此处注意的一点是：操作节点中的ID要对应接口定义中的接口名字,参数类型也要相应对应，例如接口里是add（Visitor visitor），那么在配置insert节点的时候id="add"，parameterType="Visitor"

否则会报相应的异常，例如id节点不对应接口名称会出现如下异常：

大家可以注意到在VisitorMapper.xml这个配置文件中在获取list的时候，使用的是resultMap，使用resultMap的情况下你可以指定你自己的sql语句与哪些字段相映射，因为有时候你可以不需要那么多列，那你在配置映射的时候也不需要配置那么多映射，或者说你的列有起过别名，那么就不能直接使用resultType="Visitor"的方式进行映射，因为Mybatis默认映射方式是通过Javabean的属性名与表的字段是否一致来匹配的，也可以通过配置<configuration>节点下的<settings>属性值来控制是否映射的时候以Javabean中的驼峰命名方式配置如下。

<settings>
    <setting name="mapUnderscoreToCamelCase" value="false" />
</settings>

具体其他修改Mapper的其他配置可以通过 http://mybatis.github.io/mybatis-3/configuration.html#settings 查看。
对于Visitor的Mapper类如下：

<mapper namespace="david.mybatis.demo.IVisitorOperation">
    <sql id="getListSql">
        select id as visitor_id, name, email, status, createtime from Visitor where
        status>0
    </sql>
    <select id="getList" resultMap="visitorRs">
        <include refid="getListSql" />
    </select>
    <!-- 
        这里指的注意的地方是property属性，里面的字段一定要和你在实体里面定义的属性一样，此处区分大小写
        否则会出现默认setter为属性赋值的时候找不到相应属性的异常，大家可以试下
        column属性对应于查询语句返回结果集的名字，如果有为相应字段起过别名例如吧id变为了visitor_id
        那么相应的column名字也要对应上
    -->
    <resultMap type="Visitor" id="visitorRs">
        <id column="visitor_id" property="id" />
        <result column="Name" property="name" />
        <result column="Email" property="email" />
        <result column="Status" property="status" />
        <result column="CreateTime" property="createTime" />
    </resultMap>
</mapper>

这里要大家还会注意到有一个节点<sql>节点，这个的用处就是提取公用的sql语句或者说字段，以便其他地方复用，其他详细说明用法可以参照 http://mybatis.github.io/mybatis-3/sqlmap-xml.html。
剩下的就是和刚刚一样的操作了，大家可以在demo程序里建立一个DemoRun的类存放各类测试方法，如下：

package david.mybatis.demo;

import java.util.Arrays;
import java.util.List;
import org.apache.ibatis.session.SqlSession;
import david.mybatis.model.BasicQueryArgs;
import david.mybatis.model.CRUD_Enum;
import david.mybatis.model.Channel;
import david.mybatis.model.PagenateArgs;
import david.mybatis.model.Visitor;
import david.mybatis.model.Website;

public class DemoRun {

    public static void testBasicQuery(int id) {
        SqlSession session = MybatisUtils.getSqlSession();
        try {
            /*
             * 此处的david.mybatis.demo.IVisitorOperation.basicQuery必须和下图中配置里面的namespace对应
             */
            Visitor visitor = (Visitor) session.selectOne("david.mybatis.demo.IVisitorOperation.basicQuery", id);
            MybatisUtils.closeSession(session);
            System.out.println(visitor);
        } catch (Exception e) {
            // TODO: handle exception
            e.printStackTrace();
        }
    }
    
    public static void testBasicQueryByInterfaceWay(int id) {
        SqlSession session = MybatisUtils.getSqlSession();
        try {
            IVisitorOperation vOperation = session.getMapper(IVisitorOperation.class);
            Visitor visitor = vOperation.basicQuery(id);
            MybatisUtils.closeSession(session);
            System.out.println(visitor);
        } catch (Exception e) {
            // TODO: handle exception
            e.printStackTrace();
        }
    }

    /*
     * 批量添加访问者记录
     */
    public static void addVisitors() {
        SqlSession session = MybatisUtils.getSqlSession();
        List<Visitor> visitors = Arrays.asList(new Visitor[] { new Visitor("mongodb", "mongodb@gmail.com"),
                new Visitor("redis", "redis@gmail.com"), new Visitor("memcached", "memcached@gmail.com"),
                new Visitor("CouchDB", "CouchDB@gmail.com"), new Visitor("HBase", "HBase@gmail.com"),
                new Visitor("Bigtable", "Bigtable@gmail.com"), new Visitor("Hive", "Hive@gmail.com"),
                new Visitor("MapReduce", "MapReduce@gmail.com"), });

        for (Visitor visitor : visitors) {
            addVisitor(visitor, session);
        }
        MybatisUtils.closeSession(session);
        MybatisUtils.showMessages(CRUD_Enum.List, visitors.size());
    }

    /*
     * 添加访问者信息
     */
    @SuppressWarnings("unused")
    private static void addVisitor(Visitor visitor, SqlSession session) {
        if (session == null)
            session = MybatisUtils.getSqlSession();
        IVisitorOperation vOperation = session.getMapper(IVisitorOperation.class);
        int recordCount = vOperation.add(visitor);
        session.commit();
        if (session == null)
            MybatisUtils.closeSession(session);
        MybatisUtils.showMessages(CRUD_Enum.Add, recordCount);
    }

    /*
     * 重载添加访问者
     */
    public static void addVisitor(Visitor visitor) {
        addVisitor(visitor, null);
    }

    /*
     * 删除访问者信息
     */
    public static void deleteVisitor(int id) {
        SqlSession session = MybatisUtils.getSqlSession();
        IVisitorOperation vOperation = session.getMapper(IVisitorOperation.class);
        int recordCount = vOperation.delete(id);
        session.commit();
        MybatisUtils.closeSession(session);
        MybatisUtils.showMessages(CRUD_Enum.Delete, recordCount);
    }

    /*
     * 更新访问者信息
     */
    public static void updateVisitor(int id) {
        SqlSession session = MybatisUtils.getSqlSession();
        IVisitorOperation vOperation = session.getMapper(IVisitorOperation.class);
        Visitor visitor = vOperation.query(id);
        System.out.println("原始对象：" + visitor);
        String name = visitor.getName();
        if (name.contains("updated")) {
            visitor.setName(name.substring(0, name.indexOf("updated")));
        } else {
            visitor.setName(name + "updated");
        }
        int recordCount = vOperation.update(visitor);
        session.commit();
        MybatisUtils.closeSession(session);
        MybatisUtils.showMessages(CRUD_Enum.Update, recordCount);
        System.out.println("更新后对象：" + visitor);
    }

    /*
     * 查询访问者信息
     */
    public static void queryVisitor(int id) {
        SqlSession session = MybatisUtils.getSqlSession();
        IVisitorOperation vOperation = session.getMapper(IVisitorOperation.class);
        Visitor visitor = vOperation.query(id);
        MybatisUtils.closeSession(session);
        MybatisUtils.showMessages(CRUD_Enum.Query, 1);
        System.out.println(visitor);
    }

    /*
     * 查询访问者列表
     */
    public static void queryVisitorList() {
        SqlSession session = MybatisUtils.getSqlSession();
        IVisitorOperation vOperation = session.getMapper(IVisitorOperation.class);
        List<Visitor> visitors = vOperation.getList();
        for (Visitor visitor : visitors) {
            System.out.println(visitor);
        }
        MybatisUtils.closeSession(session);
        MybatisUtils.showMessages(CRUD_Enum.List, visitors.size());
    }    
}

运行一下后一个简单的基于单表CRUD，DEMO就完成啦

下一章会讲述基于多表联合查询下的Mybatis用法~^0^