MyBatis入门

一。MyBatis简介

MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架。

MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。

MyBatis 可以对配置和原生Map使用简单的 XML 或注解，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。 

二。Mybatis配置

    要使用Mybatis，只需要添加Mybatis的JAR包即可。如果是Maven项目，可以使用以下依赖：

<dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.3.0</version>
</dependency>

官网 http://mybatis.github.io/

下载路径：https://github.com/mybatis/mybatis-3/releases

文档：http://mybatis.github.io/mybatis-3/zh/getting-started.htm

三。从核心配置文件中构建SqlSessionFactory 

每个基于MyBatis的应用都是以一个SqlsessionFactory的实例为中心的。

SqlSessionFactory的实例可以通过SqlSessionFactoryBuilder获取。

而SqlSessionFactoryBuilder则可以从核心配置文件或者预先定制的Configuration的实例构建出该实例。

这里则演示通过配置文件获取。

XML 配置文件（configuration XML）中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）。

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>
        <!-- 
                MyBatis的核心配置文件
                        1.配置数据库的连接信息(4要素、连接池)
         -->
         <!-- 建立数据库连接4要素配置文件的路径 -->
        <properties resource="jdbc.properties">
      
        </properties>
        <environments default="development">
                <environment id="development">
                
                        <!-- 事务管理器，默认使用JDBC的事务(auto commit) -->
                        <transactionManager type="JDBC" />
                        <dataSource type="POOLED">
                                <property name="driver" value="${driverClass}" />
                                <property name="url" value="${url}" />
                                <property name="username" value="${username}" />
                                <property name="password" value="${password}" />
                        </dataSource>
                </environment>
        </environments>
</configuration>

  通过核心配置文件，获取SqlSession实例，这个实例就是用来做CRUD操作的。

// 指定核心配置文件的位置
String resource = "cn/et/lesson01/conf/MyBatis.xml";

// 读取配置文件
InputStream inputStream = Resources.getResourceAsStream(resource);

// SqlSessionFactoryBuilder构建工厂类
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(inputStream);

// 工厂类获取SqlSession实例
SqlSession session = factory.openSession();

四。配置SQL映射文件

<?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">
  
  <!--命名空间: 用于区分多个文件中相同的Id，必须要指定-->
<mapper namespace="Food">
  <select id="selectFood" resultType="java.util.Map">
    select * from food
  </select>
</mapper>

resultType：表示查询结果中每一行数据在Java中对应的数据类型，可以是Map键值对，也可以是自定义的Bean。

Bean要求属性名和每一列的列名相同。

定义好了映射文件，然后在核心配置文件的<configuration>中加上映射：

    <mappers>
            <!-- 映射文件的路径 -->
            <mapper resource="cn/et/lesson01/conf/FoodMapper.xml"/>
    </mappers>

配置文件全文：

<?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>
    <!--
        MyBatis的核心配置文件
            1.配置数据库的连接信息(4要素、连接池)
     -->
    <properties resource="jdbc.properties">
    </properties>
    <environments default="development">
        <environment id="development">
        
            <!-- 事务管理器，默认使用JDBC的事务(auto commit) -->
            <transactionManager type="JDBC" />
            <dataSource type="POOLED">
                <property name="driver" value="${driverClass}" />
                <property name="url" value="${url}" />
                <property name="username" value="${username}" />
                <property name="password" value="${password}" />
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="cn/et/lesson01/conf/FoodMapper.xml"/>
    </mappers>
</configuration>

测试方法：

/*
*  Session操作的是指向SQL语句的唯一标识符，这个标识符
*  是配置在映射文件中的。
*/
List list = session.selectList("Food.selectFood");
system.out.println(list);

查询出来的Map会自动填充到List中，直接输出到控制台：

如果返回的结果只有一行，还可以用这个方法：

Map map = (Map) session.selectOne("Food.selectFoodById");
System.out.println(map);

要确保返回值只有一个，不然会抛异常的。