mybatis环境搭建

环境搭建

新建一个mvn项目,然后删除src文件夹

添加mvn依赖包

    <dependencies>
<!--        导入mysql包-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.46</version>
        </dependency>
<!--        导入mybatis包-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
<!--        导入junit包-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

然后再项目上右击新建一个子mvn项目

然后这个子mvn项目的pom.xml文件,会自动加载父项目的mvn包,这样就避免了每次都是加载mvn包 :

配置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:3307"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

编写MybatisUtils.java工具类

为什么要编写mybatis工具类?

因为这部的内容比较固定,先是从xml文件中获取SqlSessionFactory实例,然后从获取从 SqlSessionFactory 中获取 SqlSession实例

代码示例

代码流程示意图

package com.zhuo.utils;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

public class MybatisUtils {
    static SqlSessionFactory sqlSessionFactory = null;
    static{
//        从 XML 中构建 SqlSessionFactory
        String resource = "mybatis-config.xml";
        InputStream inputStream = null;

        try {
            inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
//    从 SqlSessionFactory 中获取 SqlSession
    static public SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }

}

创建一个UserDao.java层的接口

package com.zhuo.dao;

import com.zhuo.pojo.User;

import java.util.List;

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

创建上面接口的配置文件UserMapper.xml

这个配置文件其实就是相当于上面接口的实现类.

命名空间namespace

命名空间绑定的是上面的接口,这里使用的qualified name:

id绑定的接口的方法

resultType返回值类型绑定是List中的泛型

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

<mapper namespace="com.zhuo.dao.UserDao">
    <select id="getUserInfo" resultType="com.zhuo.pojo.User">
        select * from test.mybatis
    </select>
</mapper>

将UserMapper.xml文件注册到mybatis-config.xml文件中

虽然说,我配置了这个接口的xml文件,但是无法加载到mybatis框架中去,必须将其注册到mybatis-config.xml文件中去才能够有效.

<mappers>
        <mapper resource="com/zhuo/dao/UserMapper.xml"/>
  </mappers>

提示:这个路径可以直接拷贝:

maven工程中pom.xml配置资源导出

为了防止资源文件和配置信息存放不规范，使我们的资源配置文件读取失败，从而导致我们的项目报错出现异常，所以在pom文件中加入如下的代码:

<!--静态资源导出-->
    <build>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
    </build>

反正我是父工程和子工程两个pom文件里面都加了:

编写test文件

建议test文件的目录和源代码目录一一对应:

测试代码

相当于这个接口的实现类

这个mapper对象就是相当于这个接口实现类的实例

package com.zhuo.dao;

import com.zhuo.pojo.User;
import com.zhuo.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDao {


    @Test
    public void test(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        List<User> userInfo = mapper.getUserInfo();
        for (User user: userInfo) {
            System.out.println(user);

        }

    }
}

常见的错误

BindingException绑定异常

org.apache.ibatis.binding.BindingException: Type class com.zhuo.dao.UserDao is not known to the MapperRegistry.

错误原因分析

接口的名字要和xml的名字一样,仅仅只是后缀不同: