一篇文章带你搭建 Mybatis 环境

第一步：创建maven工程
第二步：导入坐标
第三步：编写必要代码（实体类和持久层接口）
第四步：编写SqlMapConfig.xml
第五步：编写映射配置文件
第六步：编写测试类

一、创建 Maven 工程并添加 Mybatis3.4.5 的坐标

官网 找到 Mybatis 的坐标格式：

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis-spring</artifactId>
  <version>3.4.5</version>
</dependency>

在pom.xml 中添加 Mybatis 的坐标即可

<dependencies>
        <!--导入Mybatis的坐标-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>
        <!--导入测试jar包-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
            <scope>test</scope>
        </dependency>
        <!--导入 Mysql 驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
        </dependency>
        <!--导入日志 jar 包-->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.12</version>
        </dependency>
</dependencies>

二、创建实体类和dao 的接口

三、创建Mybatis的主配置文件 SqlMapConfig.xml

核心配置文件中表情必须按照固定的顺序：

properties,settings,typeAliases,typeHandlers,objectFactory,objectWrapperFactory,
reflectorFactory,plugins,environments,databaseIdProvider,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">
<!-- mybatis的主配置文件 -->
<configuration>
    <!-- 配置环境 -->
    <!--environments：设置多个连接数据库的环境 属性： default：设置默认使用的环境的id -->
    <environments default="mysql">
        <!-- 配置mysql的环境-->
        <!--environment：设置具体的连接数据库的环境信息 
        属性： id：设置环境的唯一标识，可通过environments标签中的default设置某一个环境的id， 表示默认使用的环境 -->
        <environment id="mysql">
            <!-- 配置事务的类型-->
            <!--transactionManager：设置事务管理方式 
            属性：type：设置事务管理方式，type="JDBC|MANAGED" 
            type="JDBC"：设置当前环境的事务管理都必须手动处理 
            type="MANAGED"：设置事务被管理，例如spring中的AOP -->
            <transactionManager type="JDBC"></transactionManager>
            <!-- 配置数据源（连接池） -->
            <!--dataSource：设置数据源 
            属性： type：设置数据源的类型，
            type="POOLED|UNPOOLED|JNDI" 
            type="POOLED"：使用数据库连接池，即会将创建的连接进行缓存，下次使用可以从 缓存中直接获取，不需要重新创建
            type="UNPOOLED"：不使用数据库连接池，即每次使用连接都需要重新创建 
            type="JNDI"：调用上下文中的数据源 -->
            <dataSource type="POOLED">
                <!-- 配置连接数据库的4个基本信息 -->
                <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="root"/>
            </dataSource>
        </environment>
    </environments>

    <!-- 指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件 -->
    <mappers>
        <mapper resource="mybatis/dao/UserDao.xml"/>
    </mappers>
</configuration>

四、properties 标签

如果要数据库配置信息从properties中引入，则需要配置文件加入：

<!--引入properties文件，此时就可以${属性名}的方式访问属性值--> 
<properties resource="jdbc.properties"></properties>

此时对应的数据库连接信息

<?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> 
	<!--引入properties文件，此时就可以${属性名}的方式访问属性值--> 
	<properties resource="jdbc.properties"></properties> 
	<environments default="mysql_test"> 
		<environment id="mysql_test"> 
			<transactionManager type="JDBC"/> 
			<dataSource type="POOLED"> 
				<property name="driver" value="${jdbc.driver}"/> 
				<property name="url" value="${jdbc.url}"/> 
				<property name="username" value="${jdbc.username}"/> 
				<property name="password" value="${jdbc.password}"/> 
			</dataSource> 
		</environment> 
	</environments> 
	<mappers> 
		<mapper resource="UserMapper.xml"/> 		
		<package name="com.atguigu.mybatis.mapper"/> 
	</mappers> 
</configuration>

五、typeAlias 标签

typeAlias：设置某个具体的类型的别名 
属性： 
	type：需要设置别名的类型的全类名 
	alias：设置此类型的别名，若不设置此属性，该类型拥有默认的别名，即类名且不区分大小 写 
若设置此属性，此时该类型的别名只能使用alias所设置的值

<typeAliases> 
	<typeAlias type="com.atguigu.mybatis.bean.User"></typeAlias>
	<typeAlias type="com.atguigu.mybatis.bean.User" alias="abc"> </typeAlias>
	<!--以包为单位，设置改包下所有的类型都拥有默认的别名，即类名且不区分大小写--> 
	<package name="com.atguigu.mybatis.bean"/> 
</typeAliases>

五、创建映射配置文件 UserDao.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="mybatis.dao.UserDao">
    <!--配置查询所有-->
    <select id="findAll" resultType="mybatis.domain.User">
        select * from user
    </select>
</mapper>

六、注意事项

（1）创建UserDao.xml 和 UserDao.java时名称是为了和我们之前的知识保持一致

在Mybatis中它把持久层的操作接口名称和映射文件也叫做：Mapper
所以：UserDao 和 UserMapper是一样的

（2）在idea中创建目录的时候，它和包是不一样的

包在创建时：mybatis.dao它是二级结构
目录在创建时：mybatis.dao是一级目录

所以应该分层创建，先创建mybatis，然后创建在其中创建 dao

（3）mybatis的映射配置文件位置必须和dao接口的包结构相同
比如这里dao接口结构：mybatis/dao/userDao.java
所以映射配置文件在resources的结构为：mybatis/dao/userDao.xml

（4）映射配置文件的mapper标签namespace属性的取值必须是dao接口的全限定类名
映射配置文件的操作配置（select），id属性的取值必须是dao接口的方法名
也就是注意这里的namespace 和 resultType 的取值和 UserDao 的位置 mybatis/dao/UserDao 和 mybatis/domain/User 一致
这里的 id 属性就是 dao 接口内的方法
resultType 指定查询的对象封装到哪里


（5） SqlMapConfig.xml 中注意 指定映射配置文件的位置

当我们遵从了第三，四，五点之后，我们在开发中就无须再写dao的实现类

七、编写测试类

package mybatis;

import mybatis.dao.UserDao;
import mybatis.domain.User;
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 java.io.InputStream;
import java.util.List;

/**
 * 测试 mybatis 的环境
 */
public class MybatisTest {
    public static void main(String[] args) throws Exception {
//        1.读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
//        2.创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory factory = builder.build(in);
//        3.使用工厂生产SqlSession对象
        SqlSession session = factory.openSession();
//        4.使用SqlSession创建Dao接口的代理对象
        UserDao userDao = session.getMapper(UserDao.class);
//        5.使用代理对象执行方法
        List<User> users = userDao.findAll();
        for (User user :
                users) {
            System.out.println(user);
        }
//        6.释放资源
        session.close();
        in.close();
    }
    public void Test(){

    }
}