如何创建一个Mybatis程序？

博主环境

• JDK1.8
• mysql 5.7
• maven 3.8.1
• IDEA

第一个Mybatis程序

思路：搭建环境–>导入mybatis–>编写代码–>测试

2.1、搭建环境

搭建数据库

DROP DATABASE IF EXISTS mybatis;
CREATE DATABASE mybatis;


CREATE TABLE `user`(
	`id` int(20) primary key not null,
	`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,'小臭臭','123456'),
(3,'小憨憨','123456')

新建项目

1.新建一个普通的maven项目

2.创建好后删掉src目录，让这个项目成为一个父工程。然后就可以在里面 新建模块，选择maven，这就是子工程。好处是只用配置父工程的pop.xml，子工程就不用再配置了，省去了每次新建一个maven都要配置的麻烦。

3.导入maven依赖

<!--导入依赖-->
    <dependencies>
        <!--mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.6</version>
        </dependency>
        <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

2.2、创建一个子模块

输入好名字mybatis-01 一直finish就ok了

编写mybatis-config.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?useUnicode=true&amp;characterEncoding=UTF-8&amp;autoReconnect=true&amp;failOverReadOnly=false&amp;serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>

</configuration>

编写mybatis工具类

//sqlSessionFactory
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 命令所需的所有方法。
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }

}

2.3、编写代码

• User类

  public class User {
      private int id;
      private String name;
      private String pwd;
  
      public User() {
      }
  
      public User(int id, String name, String pwd) {
          this.id = id;
          this.name = name;
          this.pwd = pwd;
      }
  
      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 String getPwd() {
          return pwd;
      }
  
      public void setPwd(String pwd) {
          this.pwd = pwd;
      }
  
      @Override
      public String toString() {
          return "User{" +
                  "id=" + id +
                  ", name='" + name + '\'' +
                  ", pwd='" + pwd + '\'' +
                  '}';
      }
  }
  
  

• UserDao接口类

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

• 接口实现类（mybatis实现）由原来的UserDaoImpl.java—>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">

<!--namespace:绑定一个对应的Dao接口-->
<mapper namespace="com.yong.dao.UserDao">

    <!--id：定位到该类中一个要实现的方法
        resultType:要用全类名
    -->
    <select id="getUserList" resultType="com.yong.pojo.User">
        select * from mybatis.user
    </select>

</mapper>

2.4、junit测试

package com.yong.dao;

import com.yong.pojo.User;
import com.yong.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;

public class UserDaoTest {
    @Test
    public void test(){
        //第一步：获得sqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //执行sql
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        List<User> userList = mapper.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }

        //关闭SqlSession
        sqlSession.close();
    }
}

注意点（报错解决）：

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

  该xml没有在配置核心里注册,在mybatis-config.xml里的<configuration>标签内加入该xml的全路径，用斜杠结尾

  <!--每一个Mapper.xml都需要早mybatis核心配置中注册-->
  <mappers>
      <mapper resource="com/yong/dao/UserMapper.xml"/>
  </mappers>
  

• java.lang.ExceptionInInitializerErrorCaused by: ***

  org.apache.ibatis.exceptions.PersistenceException:

  ###Error building SqlSession.

  ###The error may exist in com/yong/dao/UserMapper.xml

  因为在maven项目中，他的资源文件夹是默认的resource，在这个文件夹下的资源文件才到被识别出来。

  而我们刚才新建的UserMapper是在src路径下面的，maven扫描不到这个文件夹。

  解决：

  在maven的配置文件pom.xml中添加配置resource。防止资源导出失败问题。

  	...
  	...
  <!--添加配置resource,防止资源导出失败问题-->
      <build>
          <resources>
              <resource>
                  <directory>src/main/resource</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>
  	...
  	...
  </project>
  

  最好在父工程和子工程中都添加上面这一段。

  资源出现在target路径下，成功！
  
  运行结果
  
  可能遇到的问题：

1.配置文件没有注册

2.绑定接口不对

3.方法名不对

4.返回类型不对

5.maven导出资源