Mybatis学习笔记（一）：初识mybatis

Mybatis学习笔记（一）：初识mybatis

2.使用步骤

​ 根据官方文档的入门指导来进行学习是最有效的。官方文档的步骤用斜体表示，具体代码用正体表示。

2.1 安装

​ 使用 Maven 来构建项目，则需将下面的依赖代码置于 pom.xml 文件中

项目代码：

​ 创建空MAVEN项目作为父公程，删除src文件夹，导入依赖：

<dependencies>
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>5.1.47version>
        dependency>
        <dependency>
            <groupId>org.mybatisgroupId>
            <artifactId>mybatisartifactId>
            <version>3.5.2version>
        dependency>
        <dependency>
            <groupId>junitgroupId>
            <artifactId>junitartifactId>
            <version>3.8.1version>
        dependency>
    dependencies>

2.2 从 XML 中构建 SqlSessionFactory

​ 每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。

​ 从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文件进行配置。 但也可以使用任意的输入流（InputStream）实例，比如用文件路径字符串或 file:// URL 构造的输入流。MyBatis 包含一个名叫 Resources 的工具类，它包含一些实用方法，使得从类路径或其它位置加载资源文件更加容易。

String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

XML 配置文件中包含了对 MyBatis 系统的核心设置，包括获取数据库连接实例的数据源（DataSource）以及决定事务作用域和控制方式的事务管理器（TransactionManager）。后面会再探讨 XML 配置文件的详细内容，这里先给出一个简单的示例：

<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?useSSL=true&useUnicode=true&charsetEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            dataSource>
        environment>
    environments>

    
    此处先暂时注释掉，至于为何等到后面解释
    
    
configuration>

​

​ 该部分的内容就是要我们获取两个实例，他们之间存在依托关系：

SqlSession（最终需要） —依赖于—> SqlSessionFactory—依赖于—> SqlSessionFactoryBuilder —依赖于—>XML 配置文件

​ 因此我们先要在resources文件夹中创建代码如上的XML 配置文件，然后创建工具类以获取SqlSession实例。

​ 工具类代码如下：

public class MybatisUtils {
        private static SqlSessionFactory sqlSessionFactory ;
        static {
            try {
                String resource = "mybatis-config.xml";
                InputStream inputStream = Resources.getResourceAsStream(resource);
                sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

        public static SqlSession getSqlSession(){
            return sqlSessionFactory.openSession();
        }
}

2.3 映射 SQL 语句

​ MyBatis 提供的所有特性都可以利用基于 XML 的映射语言来实现，这使得 MyBatis 在过去的数年间得以流行。这里给出一个基于 XML 映射语句的示例，它应该可以满足上个示例中 SqlSession 的调用。

<mapper namespace="com.kuang.dao.UserDao">
  <select id="getUerList" resultType="com.kuang.pojo.User">
    select * from mybatis.user
  select>
mapper>

​

​ 在这个xml中，有三个参数需要我们注意：

• namespace：方法在dao层对应接口的名称；

• id：方法的名称

• resultType：返回值

  跟之前手动搭建的项目一样，也需要有dao层和数据库对应的pojo实体类。

2.4 执行

​ 在test包下的java创建对应一模一样目录的测试类。测试类格式如下：

public class UserDaoTest {
    @Test
    public void test(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        List<User> userList = mapper.getUserList();

        for (User user : userList) {
            System.out.println(user);
        }
        
        sqlSession.close();
    }
}

​

​ 但是如果直接这么就运行，那么会出现一个错误。

2.5 可能出现的错误

1. org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.

   该错误发生的原因是没有将接口在Mapper中注册，即resources中xml配置文件中被注掉的：

   <mappers>
           <mapper resource="org/westos/dao/userMapper.xml"/>
       mappers>
   

   每一个Mapper.xml都需要在mybatis核心配置文件中注册。

2. java.lang.ExceptionInInitializerError
   at com.kuang.dao.UserDaoTest.test(UserDaoTest.java:13)
   初始化失败异常，报错提醒中显示userMapper.xml不存在。

   这个错误发生的原因是存在于java目录下的userMapper.xml没有被导出。要求在pom.xml中的bulid中配置resources。

   <build>
           
           <resources>
               <resource>
                   <directory>src/main/javadirectory>
                   <includes>
                       <include>**/*.propertiesinclude>
                       <include>**/*.xmlinclude>
                   includes>
                   <filtering>falsefiltering>
               resource>
               <resource>
                   <directory>src/main/resourcesdirectory>
                   <includes>
                       <include>**/*.propertiesinclude>
                       <include>**/*.xmlinclude>
                   includes>
                   <filtering>falsefiltering>
               resource>
           resources>
   
       build>