【MyBatis学习】01、第一个mybatis程序

思路: 搭建环境-->导入MyBatis-->编写代码-->测试

一、搭建环境

1.创建数据库 (mysql)

CREATE DATABASE `mybatis`;

USE `mybatis`;

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

2.新建项目

　　(1) 新建一个普通的maven项目

　　(2) 导入maven依赖 (mysql-connector-java、mybatis、junit)

二、创建一个模块

　　   (基于mybatis官方文档)

• 编写mybatis的核心配置文件 (src/main/resources/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?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

• 编写mybatis工具类

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

二、编写代码

• 实体类

　　User类(private、constructor、setter&&getter、tostring)

• Dao接口

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

• 接口实现Mapper配置文件

<?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绑定一个对应的UserMapper接口-->
<mapper namespace="com.wcl.dao.UserMapper">
    <!--select查询语句-->
    <!--id 相当于重写的方法-->
    <!--resultType 为方法返回类型的泛型-->
    <select id="getUserList" resultType="com.wcl.pojo.User">
        select * from mybatis.user;
    </select>
</mapper>

三、测试

可能出现的错误

（1）BindingException: Type interface com.wcl.dao.UserMapper is not known to the MapperRegistry.

　　原因:未在Mybatis配置文件中注册Mapper.xml

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

 

(2)Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. 
Cause: java.io.IOException: Could not find resource com/wcl/dao/UserMapper.xml
　原因:Maven默认资源文件配置在resources目录下，但我们写的xml放在java目录下，此目录下导出不了，需要手动导出　

 <build>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.xml</include>
                    <include>**/*.properties</include>
                </includes>
                <filtering>true</filtering>
            </resource>

            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.xml</include>
                    <include>**/*.properties</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>

(3)Cause: org.xml.sax.SAXParseException； lineNumber: 6； columnNumber: 5； 1 字节的 UTF-8 序列的字节 1 无效

将mybatis的xml文件的

 

<?xml version="1.0" encoding="UTF-8" ?>

 

改为

<?xml version="1.0" encoding="UTF8" ?>　

 

Cause: org.xml.sax.SAXParseException； lineNumber: 6； columnNumber: 5； 1 字节的 UTF-8 序列的字节 1 无效