MyBatis入门学习（一）

一、MyBatis入门简要介绍（百科）

　　MyBatis 是支持普通 SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML或注解用于配置和原始映射，将接口和 Java 的POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。
　　每个MyBatis应用程序主要都是使用SqlSessionFactory实例的，一个SqlSessionFactory实例可以通过SqlSessionFactoryBuilder获得。SqlSessionFactoryBuilder可以从一个xml配置文件或者一个预定义的配置类的实例获得。
　　用xml文件构建SqlSessionFactory实例是非常简单的事情。推荐在这个配置中使用类路径资源（classpath resource)，但你可以使用任何Reader实例，包括用文件路径或file://开头的url创建的实例。MyBatis有一个实用类----Resources，它有很多方法，可以方便地从类路径及其它位置加载资源。

二、MaBatis入门测试小项目

2.1、项目准备工作

1、因为该项目不需要与web相关，所以创建java项目即可，项目结构如下图所示：

　　　　

2、引入项目响应的jar包（两个）

　　在myeclipse创建一个名为jar的Folder文件夹，下载jar包引入,不要忘记build path 将jar包引入到当前项目中来。

　　【mybatis】

       　　mybatis-3.1.1.jar  　　下载地址（可能有变动）：http://download.csdn.net/detail/dqsweet/4534353

　　【MYSQL驱动包】（连接mysql数据库驱动包）
　　　　 mysql-connector-java-5.1.7-bin.jar 　　下载地址（可能有变动）：http://download.csdn.net/detail/yangs_1235/5049404

3、建立相对应的数据库和表，使用的是MySQL数据库

create database mybatis;

use mybatis;

CREATE TABLE users(id INT PRIMARY KEY AUTO_INCREMENT, NAME VARCHAR(20), age INT);

INSERT INTO users(NAME, age) VALUES('久伴1', 24); 

INSERT INTO users(NAME, age) VALUES('久伴2', 24);

2.2、通过MyBatis框架查询表中的数据

　　　　　1、在src目录下创建一个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>

    <environments default="development">
        <environment id="development">
            <transactionManager type="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>
        <!-- 注册userMapper.xml文件， 
        userMapper.xml位于com.murong.mapping这个包下，所以resource写成com/murong/mapping/userMapper.xml-->
        <mapper resource="com/murong/mapping/userMapper.xml"/>
    </mappers>
</configuration>

 　　　　　2、定义实体类User，如下：

package com.murong.domain;
/**
 * 实体类User
 * @author yzy
 *
 */
public class User {
    //实体类的属性需与表字段对应
    private int id;
    private String name;
    private int age;
    
    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;
    }
}

　　　　3、定义操作users表的sql映射文件userMapper.xml　　创建一个com.murongl.mapping包，专门用于存放sql映射文件，在包中创建一个userMapper.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的值习惯上设置成包名+映射文件名
    例如namespace="com.murong.mapping.userMapper"
    就是com.murong.mapping(包名)+userMapper(userMapper.xml文件去除后缀)
 -->
<mapper namespace="com.murong.mapping.userMapper">

    <!-- 
        在select标签中编写查询的SQL语句， 设置select标签的id属性为getUser，id属性值必须是唯一的，不能够重复
                 使用parameterType属性指明查询时使用的参数类型，resultType属性指明查询返回的结果集类型
        resultType="com.murong.domain.User"表示将查询结果封装成一个User类的对象返回
        User类就是数据库users表所对应的实体类
    -->
    
    <!-- 
        根据id查询返回一个user对象
     -->
    <select id="getUser" parameterType="int" 
         resultType="com.murong.domain.User">
         select * from users where id=#{id}
     </select>
     
     
</mapper>

 　　　　4、在conf.xml文件中注册userMapper.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="development">
        <environment id="development">
            <transactionManager type="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>
        <!-- 注册userMapper.xml文件， 
        userMapper.xml位于com.murong.mapping这个包下，所以resource写成com/murong/mapping/userMapper.xml-->
        <mapper resource="com/murong/mapping/userMapper.xml"/>
    </mappers>
</configuration>

 　　　　5、编写测试代码App类：执行定义的select语句，测试代码如下：

package com.murong.client;
import com.murong.domain.User;
import java.io.IOException;
import java.io.InputStream;
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;

public class App {

    public static void main(String[] args) throws IOException {
        //mybatis的配置文件，位于src路径下
        String resource = "conf.xml";
        
        //使用类加载器加载mybatis的配置文件（它也加载关联的映射文件）（获取方式一）
        //InputStream is = App.class.getClassLoader().getResourceAsStream(resource);
        //构建sqlSession的工厂
        //SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
        
        //使用MyBatis提供的Resources类加载mybatis的配置文件（它也加载关联的映射文件）（获取方式二）
        Reader reader = Resources.getResourceAsReader(resource); 
        //构建sqlSession的工厂
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
        
        
        //创建能执行映射文件中sql的sqlSession
        SqlSession session = sessionFactory.openSession();
        /**
         * 映射sql的标识字符串，
         * com.murong.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，
         * getUser是select标签的id属性值，通过select标签的id属性值就可以找到要执行的SQL
         */
        String statement = "com.murong.mapping.userMapper.getUser";//映射sql的标识字符串
        //执行查询返回一个唯一user对象的sql
        User user = session.selectOne(statement, 1);
        System.out.println(user);
    }
}

　　　　6、执行结果如下所示：