mybatis入门

Mybatis的准备工作

mybatis的中文文档：

https://mybatis.org/mybatis-3/zh/index.html

准备工作具体有哪些

我们用Idea的Maven项目来演示 。
思路：搭建环境----->导入Mybatis依赖----->编写代码------->测试

Mybatis的实现

1、搭建环境

搭建数据库任意数据库都可以，如：

新建项目，导入Mybatis的maven的依赖

		<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
        </dependency>

以上就是我们项目的准备工作。

2、开始模块编写代码（参考Mybatis中文文档来学习）

代码的整体结构

编写Mybatis的核心配置文件-

<?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?useSSL=false&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="exin741963"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/yyp/dao/UserMapper.xml"/>
    </mappers>
</configuration>

此代码是从Mybatis官方中文文档中拷贝过来的，其中我们需要将driver、url、username、password，四个属性的值根据自己的数据库进行配置。
最重要的是mappers这个标签 它主要的作用就是将后面我们写的xml文件在这里注册一下。之后的每一个Mapper.xml文件都需要在Mybatis核心配置文件中注册！！！！！
IDEA连接数据库的方法
首先找到database，点击左上角的加号，找到MySQL


连接上数据库之后就可以在IDEA上直接对数据库进行可视化
编写Mybatis工具类

public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;

    static {
        try {
            //使用Mybatis
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
             sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

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

}

我们通过mybatis–config.xml文件创建一个SqlSessionFactor（我们可以理解为一个工厂），通过这个SqlSessionFactor工厂我们可以得到一个sqlsession，而通过sqlsession中的getMapper方法可以加载Dao中的接口，从而可以使用Dao中的方法。

3、编写代码

实体类
实体类主要是根据自己的数据库来编写的：

public class User {
    private int id;
    private String name;
    private String pwd;

    public User() {
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", pwd='" + pwd + '\'' +
                '}';
    }

    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;
    }
}

Dao接口
我们要实现面向接口的变成，因此我们首先要写一个接口
我们的接口中包括了对数据库的增删改查的四种基本操作。

public interface UserMapper {
    //查询全部用户
    List<User> getUserList();

    //根据ID查询用户
    User getUserById(int id);

    //insert一个用户
    int addUser(User user);

    //修改用户
    int updateUser(User user);

    //删除一个用户
    int deleteUser(int id);
}

接口实现
在没有学习Mybatis的时候，我们是需要编写一个接口的实现类的，但是在mybatis中我们用一个xml文件来代替之前的接口实现。

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


<!--绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.yyp.dao.UserMapper">

    <select id="getUserList" resultType="com.yyp.pojo.User">
        select * from mybatis.user
    </select>
    
    <select id="getUserById" parameterType="int" resultType="com.yyp.pojo.User">
        select * from mybatis.user where id = #{id}
    </select>

    <insert id="addUser" parameterType="com.yyp.pojo.User">
        insert into mybatis.user (id,name,pwd) value (#{id},#{name},#{pwd})
    </insert>
    
    <update id="updateUser" parameterType="com.yyp.pojo.User">
        update mybatis.user set name=#{name},pwd=#{pwd} where id = #{id}
    </update>

    <delete id="deleteUser" parameterType="int">
        delete from mybatis.user where id = #{id}
    </delete>
</mapper>

测试

测试的基本操作都是三行代码，不同的就是调用的方法不同，在这里我们就以查询全部用户为例。

	public void test(){
        //第一步获得SQLSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //执行SQL
        UserMapper userDao = sqlSession.getMapper(UserMapper.class);
        List<User> userList = userDao.getUserList();
        for (User user : userList){
            System.out.println(user);
        }
        sqlSession.close();
    }

会遇到的一些问题

1、org.apache.ibatis.binding.BindingException: Type interface com.yyp.dao.UserMapper is not known to the MapperRegistry.

这是因为没有注册你的Mapper导致的，需要你在mybatis-config.xml文件中添加Mapper的注册内容

2、java.io.IOException: Could not find resource com/yyp/dao/UserMapper.xml

这是由于Maven的约定大于配置，导致我们遇到写的配置文件无法被导出或者生效的问题，解决方案：在maven中加入build。

	<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>

3、（小编认为最坑的一个错误）org.xml.sax.SAXParseException; lineNumber: 7; columnNumber: 5; 1 字节的 UTF-8 序列的字节 1 无效。

这个小编在遇到的时候，百度了很久，有人说是注释的问题，我刚开始不信，最后真的就是因为中文注释，文件头的encoding="UTF-8"会编译注释中的中文，导致无法识别的错误，因此有两种修改的方法，第一种直接将注释删掉，第二种将UTF-8改为UTF8就可以了。