# MyBatis学习笔记（一）快速入门

MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以对配置和原生Map使用简单的 XML 或注解，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。—-From MyBatis官方文档

开发环境：MySQL数据库，导入Jar包 mybatis-3.1.1.jar、mysql-connector-java-5.1.22-bin.jar

1.创建数据库和表
sql脚本如下：

create database mybatis;
use mybatis;
CREATE TABLE users(
    id INT PRIMARY KEY AUTO_INCREMENT, 
    name VARCHAR(20), 
    age INT,
    address VARCHAR(200)
);

-- ----------------------------
-- Records of users
-- ----------------------------
INSERT INTO users(name, age, address)  VALUES ('张三', '30', '上海');
INSERT INTO users(name, age, address)  VALUES ('李四', '22', '北京');
INSERT INTO users(name, age, address)  VALUES ('王五', '29', 'some place');
INSERT INTO users(name, age, address)  VALUES ('lu', '28', 'some place');
INSERT INTO users(name, age, address)  VALUES ('xiaoxun', '27', 'nanjing');

2.创建项目
项目结构如图所示：

2.1实体类Users

package com.model;

/**
 *
 * @author wenjuanhenxing
 * @version Users.java 2015年12月4日 上午10:18:10
 */
public class Users {
    //实体类的属性和表的字段名称一一对应
    private int id;
    private String name;
    private int age;
    private String address;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getAddress() {
        return address;
    }

    public void setAddress(String address) {
        this.address = address;
    }

    @Override
    public String toString() {
        return "Users [id=" + id + ", name=" + name + ", age=" + age + ", address=" + address + "]";
    }

}

2.2添加Mybatis的配置文件conf.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>
    <!-- 实体类起别名,下次用到时不需要写全类名 -->
    <typeAliases>
        <typeAlias type="com.model.Users" alias="Users" />
    </typeAliases>

    <environments default="development">
         <environment id="development">
         <!-- 事务由JDBC控制 -->
         <transactionManager type="JDBC" />
          <!-- 配置数据库连接信息 ,POOLED表示可以配置JDBC连接池-->
         <dataSource type="POOLED">
             <property name="driver" value="com.mysql.jdbc.Driver" />
             <property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
             <property name="username" value="root" />
             <property name="password" value="123456" />
         </dataSource>
         </environment>
    </environments>

    <mappers>
         <!-- 注册UsersMapper.xml文件 -->
        <mapper resource="com/mapping/UsersMapper.xml"/>
    </mappers>

</configuration>

2.3定义操作users表的sql映射文件UsersMapper.xml

<?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，namespace的值
习惯上设置成包名+sql映射文件名，这样就能够保证namespace的值是唯一的 -->
<mapper namespace="com.mapping.UsersMapper">
    <!-- 在select标签中编写查询的SQL语句， 设置select标签的id属性       
        为getUser，id属性值必须是唯一的，不能够重复
        使用parameterType属性指明查询时使用的参数类型，
        resultType属性指明查询返回的结果集类型返回
        看!这里就省略了全类名，用到typeAlias了
        Users类就是users表所对应的实体类
    -->
    <!-- 根据id查询得到一个user对象     -->
    <select id="getUser" parameterType="int" resultType="Users">
        select * from users where id=#{id}
    </select>
</mapper>

2.4编写测试用例

package com.test;

import java.io.IOException;
import java.io.Reader;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import com.model.Users;

/**
 *
 * @author wenjuanhenxing
 * @version Test.java 2015年12月4日 上午10:34:26
 */
public class Test {
    public static void main(String[] args) throws IOException {
        // mybatis的配置文件
        String resource = "com/mybatis/resource/conf.xml";
        // 使用MyBatis提供的Resources类加载mybatis的配置文件（它也加载关联的映射文件）
        Reader reader = Resources.getResourceAsReader(resource);
        // 构建sqlSession的工厂
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
        // 创建能执行映射文件中sql的sqlSession
        SqlSession session = sessionFactory.openSession();
        /**
         * 映射sql的标识字符串，
         * com.mapping.UsersMapper是UsersMapper.xml文件中mapper标签的namespace属性的值，
         * getUser是select标签的id属性值，通过select标签的id属性值就可以找到要执行的SQL
         */
        String statement = "com.mapping.UsersMapper.getUser";// 映射sql的标识字符串
        // 执行查询返回一个唯一user对象的sql
        Users user = session.selectOne(statement, 1);
        System.out.println(user);
    }
}

执行结果如下：