搭建第一个MyBatis程序

项目搭建

• IDEA创建一个空的maven项目
• 在父工程pom.xml中添加依赖（mysql驱动，mybatis依赖，及junit单元测试）
• 添加一个子工程，完善包结构

<dependencies>
    <!-- mysql驱动-->
       <dependency>
           <groupId>mysql</groupId>
           <artifactId>mysql-connector-java</artifactId>
           <version>8.0.25</version>
       </dependency>
    <!-- mybatis驱动-->
       <dependency>
           <groupId>org.mybatis</groupId>
           <artifactId>mybatis</artifactId>
           <version>3.5.7</version>
       </dependency>
       <!-- junit驱动-->
       <dependency>
           <groupId>junit</groupId>
           <artifactId>junit</artifactId>
           <version>4.11</version>
           <scope>test</scope>
       </dependency>
   </dependencies>

创建一个mybatis数据库

• 新建一张user表
• Idea连接到数据库

CREATE TABLE `user`(
`id` INT(30) NOT NULL PRIMARY KEY,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL
) ENGINE INNODB DEFAULT CHARSET=utf8;

INSERT INTO `user`(`id`,`name`,`pwd`)
VALUES(1,'张三','123456'),
(2,'何梦丹','666666'),
(3,'王五','42352356');

编写mybatis的核心配置文件

在resources目录下新建一个mybatis-config.xml
driver value栏填写数据库驱动
url value栏填写连接数据库的url地址
username,password分别写数据库账户与密码

<?xml version="1.0" encoding="UTF8" ?>
        <!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.cj.jdbc.Driver"/>
            <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSl=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
            <property name="username" value="root"/>
            <property name="password" value="123456"/>
        </dataSource>
    </environment>
</environments>
</configuration>

编写mybatis的工具类

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

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

 try {
            //使用mybatis第一步：获得sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
           sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }

得到sqlSessionFactory对象

然后从 SqlSessionFactory 中获取 SqlSession

完整的mybatis工具类

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

public class MybatisUtils {

    private  static SqlSessionFactory sqlSessionFactory;
    static {
        try {
            //使用mybatis第一步：获得sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
           sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    /*
    既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例。
    SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession
    实例来直接执行已映射的 SQL 语句
    */
    public static SqlSession getSqlSession(){
        return  sqlSessionFactory.openSession();

    }

编写数据库对应的实体类

接口类

public interface UserDao {
   List<User> getUserList();
}

接口实现

创建一个UserMapper.xml文件，sql代码写在了该文件里。作用是代替编写Java实现类，省略了繁琐的JDBC代码。

• namespace绑定一个对应的接口
• id对应绑定接口的方法， resultType对应实体类

<?xml version="1.0" encoding="UTF8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

       <!--namespace绑定一个对应的接口-->
<mapper namespace="com.tt.Dao.UserDao">
     <!--id对应绑定接口的方法， resultType对应实体类-->
    <select id="getUserList" resultType="com.tt.pojo.User">
        select * from mybatis.user
    </select>

</mapper>

测试

在test目录下建与src相同结构的包，编写一个测试类，添加@Test注解

public class UserDaoTest {
    @Test
  public void Test(){
      // 第一步，获取sqlSession对象
      SqlSession sqlSession = MybatisUtils.getSqlSession();
      //执行sql
      UserDao userdao = sqlSession.getMapper(UserDao.class);
      List<User> userList = userdao.getUserList();

      //第二步，遍历输出
      for (User user : userList) {
          System.out.println(user);
          System.out.println("-------------------------------");
      }
      //关闭sqlSession
      sqlSession.close();;
  }
}

运行测试会遇到下面问题：

原因是写好的实现接口的xml需要在核心配置文件中注册

<!--    每一个Mapper.xml都要在核心配置文件中注册-->
    <mappers>
        <mapper resource="com/tt/dao/UserMapper.xml"/>
    </mappers>

再测试会遇到下面问题：

原因是UserMapper.xmlJava目录下，资源无法导出导致的，解决方法是在父工程和子工程中中配置resources，来解决资源导出问题。

 <!--在build中配置resource，来防止资源导出问题-->
       <build>
           <resources>
               <resource>
                   <directory>src/main/resources</directory>
                   <includes>
                       <include>**/*.properties</include>
                       <include>**/*.xml</include>
                   </includes>
                   <filtering>true</filtering>
               </resource>
               <resource>
                   <directory>src/main/java</directory>
                   <includes>
                       <include>**/*.properties</include>
                       <include>**/*.xml</include>
                   </includes>
                   <filtering>true</filtering>
               </resource>
           </resources>
       </build>

成功：

遇到的问题

在完成上面步骤时，还是出现了以下错误：

百思不得其解，最后的解决方法是：
把xml的encoding属性值UTF-8改为UTF8，太操蛋了！