MyBaties总结

---

一、MyBaties介绍

最好的学习方式：看官网文档。

（1）什么是MyBaties?

• MyBatis 是一款优秀的持久层框架。
• 它支持定制化 SQL、存储过程以及高级映射。
• MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。
• MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJO映射成数据库中的记录。
• MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software
  foundation迁移到了google code，并且改名为MyBatis

折叠

（2）maven的引入

引入依赖包：

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.11</version>
</dependency>

3种方式都可以。

（3）持久化和持久层

• 数据持久化：
  • 持久化就是将程序数据在瞬时状态和持久状态转化的过程。
  • 内存：断电即失。
  • 持久化实例：数据库（jdbc），IO文件持久化。冰箱冷藏。
• 为什么需要持久化：
  • 有些对象，不能让它丢掉。
  • 内存太贵!
• 持久层:
  • Dao层，Service层，Controller层…
  • 持久化是一个动作，持久层是一个概念，表示完成持久化工作的代码块。 层界限非常敏感。

（4）为什么需要MyBaties?(好处)

• 框架：自动化操作。
• 传统的JDBCD代码太复杂了，框架可以简化这个过程。

在myBaties框架中，sql是写在配置文件里的，都不用写在java代码里。做到了sql和代码的分离。

（5）github中下载的步骤

在github中搜索mybatis:

第二个mybaties本身。

点击Releases:

压缩包可以直接下载，下载下来就是它的jar包。

二、第一个Mybatis程序

思路：搭建环境->导入MyBatis->编写代码->测试。
(学习一个新东西，任何东西按照这个逻辑来，不会有任何问题。)

（1）搭建环境

1.1 创建数据库和表

新建myBatis数据库,创建user表并添加数据。

1.2 新建项目

• 1.创建一个普通的maven项目
• 2.删除src目录
• 3.导入maven依赖：

    <!--导入依赖-->
    <dependencies>
<!--        mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</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>

• 4.在该项目下 新建一个模块（新建一个maven子项目）
  这样创建的好处是子项目不用每次都去导包了。

（2）导入Mybatis

1.编写mybatis的核心配置文件：

名字为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核心配置文件-->
<configuration>
<!--    Environments:多套环境，default可以选择其中一个环境作为默认的环境。-->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
<!--                在xml文件中，&不能用，需要转义&amp。-->
                <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>
    
<mappers>
<!--  注册xxxMapper.xml文件，  路径以/代替.-->
 <mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>

</configuration>

2.编写mybatis工具类MybatisUtils ：

package com.kuang.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;

//sqlSessionFactory--->sqlSession
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
    static {
//      mybatis第一步： 使用mybatis获取sqlSessionFactory对象
        try {
            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();
    }

}

（3）编写代码

1.实体类User

package com.kuang.pojo;
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 + '\'' +
                '}';
    }
}

2.Dao接口：

import com.kuang.pojo.User;
import java.util.List;
public interface UserDao {
     List<User> getUserList();
}

3.接口的实现类/对应的Mapper.xml文件:
(接口实现类由原来的UserDaolmpl转变为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=绑定一个Dao/Mapper接口,实现原理就相当于Dao对应的Impl实现了这个接口-->
<mapper namespace="com.kuang.dao.UserDao">
    <!--    select查询语句，ID对应接口中的方法名-->
    <select id="getUserList" resultType="com.kuang.pojo.User">
        <!--sql语句写在配置文件里面。-->
        select * from mybatis.user;
    </select>

</mapper>

（4）测试

import com.kuang.pojo.User;
import com.kuang.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();

//方式一:getMapper
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        List<User> userList = userDao.getUserList();
//方式二：
//        List<User> userList = sqlSession.selectList("com.kuang.dao.UserDao.getUserList");

        for (User user : userList) {
            System.out.println(user);
        }
        //关闭操作非常重要。
  sqlSession.close();

    }
}

方式二已经过时了。不用掌握，但是需要知道它存在。

第一种方式，通过mapper直接获取它的类，就可以调用类中的方法了。
方式二会根据方法的返回值去返回。

（5）可能出现的异常

初始化失败异常。

资源导出问题。无法找出.xml文件。

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

2.xxxMapper.xml配置文件没有注册：

<mappers>
<!--    路径以/代替.-->
 <mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>

3.常见问题：

（6）注意事项

1.xxxMapper.xml文件和实现类的比较：

• 只需记住这两个，type表示类型，map表示集合。即前者可以返回一个，后者可以返回多个。一般都是用ResultType。
• 返回结果要用完全限定名（全类名），因为配置文件不像java类能够去找它的关联。
• 所有的集合都只需要写集合里面泛型中的东西。

• 原来实现接口需要重写接口的方法，现在写一个标签指向要重写的方法就可以了。
• 原来要执行sql还需要连接数据库等jdbc的语句，现在在xml中只用执行sql就可以了。

2.mybatis三个核心接口：

sqlSession的关闭操作非常重要。