学习MyBatis笔记

MyBatis持久层框架

Maven Repository: MyBatis (mvnrepository.com)

本是apache的开源项目iBatis，2010年迁移到google code，并改名MyBatis，2013年迁移到GitHub

数据持久化，即将程序的数据在持久状态和瞬时状态转化的过程

内存：断电即失

为什么使用？

1.方便，传统JDBC代码过于复杂，帮助程序员将数据存入到数据库

2.Sql和代码的分离，提供可维护性

3.提供映射标签，支持对象与数据库orm字段关系映射

4.提供对象关系映射标签，支持对象关系组建维护

5.提供xml标签，支持编写动态sql

mybatis – MyBatis 3 | 入门

使用案例

1. 创建Maven项目父工程，删除src包，导入mysql、mybatis、junit的依赖
2. 创建Module-Maven
3. 子工程中的resource中创建xml核心配置文件，即连接数据库以及对Mapper.xml的映射，构建SqlSessionFactory
4. 创建实体类POJO（User）
5. 创建工具类，从SqlSessionFactory中获取SqlSession(即操作数据库的对象)

         6.创建UserMapper接口

 

        7.如果是JDBC即继续创建实现类实现接口的方法，mybatis使用xml（即UserMapper.xml）实现

 

类名和方法名一定要和接口保持一致！！        

        8.编写测试类：

 

• 首先使用工具类的getSqlSession返回SqlSession类型的操作数据库的对象
• UserMapper mapper = sqlSession.getMapper(UserMapper.class);
• 调用mapper的自己编写的操作数据库的方法（这些方法由xml文件编写的sql语进行执行）

可能遇到的问题（即注意点）

1.配置文件没有注册

2.绑定接口错误

解决方法：在mybatis-config.xml中，mapper不能去掉

每一个Mapper.xml（即实现Mapper接口的xml文件【里面即对数据库的操作方法】）都需要在Mybatis核心配置文件中注册

3.方法名不对

即Mapper接口和对应的xml文件中的id一定要一致

 

 

4.Maven导出资源问题

一般来说我们创建的xml文件放入resource文件夹中，但是该项目中，我们将UserMapper.xml放入src中

 

 Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource com/wang/dao/UserMapper.xml

导致出现无法找到该UserMapper.xml(配置文件中写了映射，但是未找到该文件)

于是在父pom.xml依赖中写上，在build中配置resource，来防止我们资源到处失败的问题

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

5.xml注解格式错误

Cause: org.apache.ibatis.builder.BuilderException: Error creating document instance.  Cause: com.sun.org.apache.xerces.internal.impl.io.MalformedByteSequenceException: 1 字节的 UTF-8 序列的字节 1 无效。

由于我们从Mybatis的官网入门文档中复制xml文件格式是

 

我们将中文注解全部删除或者，将编码改为GBK或者UTF8即可

作用域

1. SqlSessionFactoryBuilder：该类可以被实例化、使用和丢弃，一旦创建SqlSessionFactory就不再需要它。最佳作用域是方法作用域

1. SqlSessionFactory：一旦被创建就也应该在应用的运行期间一直存在，没有任何理由丢弃或重新创建另一个实例。最简单的方式就是单例模式或者静态单例模式，最佳作用域是应用作用域

1. SqlSession，每个线程都应该有自己的SqlSession实例，不是线程安全的因此不能被共享，最佳作用域是请求或方法作用域，绝不可以将其实例引用放入类的静态域或者一个类的实例变量。每次收到HTTP请求就可以打开一个SqlSession返回一个响应然后关闭，关闭操作很重要！

增删改查的实现

有了以上例子，增删改查的功能很简单即可实现，只需要动接口类和实现接口的xml文件

public interface UserMapper {
    List<User> getAllUser();
    User getUserById(int id);
    int addUser(User user);
    int updateUser(User user);
    int deleteUser(int id);
}

<?xml version="1.0" encoding="GBK" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace绑定一个Dao接口-->
<mapper namespace="com.wang.dao.UserMapper">
<!--    查询语句-->
    <select id="getAllUser" resultType="com.wang.pojo.User">
        select * from user
    </select>
    <select id="getUserById" resultType="com.wang.pojo.User" parameterType="int">
        select * from user where id=#{id}
    </select>
    <insert id="addUser" parameterType="com.wang.pojo.User">
        insert into User(id,name,pwd) values (#{id},#{name},#{pwd})
    </insert>
    <update id="updateUser" parameterType="com.wang.pojo.User">
        update user set name=#{name},pwd=#{pwd} where id=#{id}
    </update>
    <delete id="deleteUser" parameterType="int">
        delete from user where id=#{id}
    </delete>
</mapper>

package com.wang.dao;

import com.wang.pojo.User;
import com.wang.utils.MyBatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserTest {
    @Test
    public void test(){
        //获得操作数据库的对象
        //执行sql语句
        try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            List<User> user = mapper.getAllUser();
            for (User u : user
            ) {
                System.out.println(u);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    @Test
    public void test2(){
        //获得操作数据库的对象
        //执行sql语句
        try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            System.out.println(mapper.getUserById(1));
        } catch (Exception e) {
            e.printStackTrace();
        }
        //关闭
    }
    @Test
    public void addTest(){
        //获得操作数据库的对象
        //执行sql语句
        try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            User user1 = new User(4,"lu","123456");
            System.out.println(mapper.addUser(user1));
            sqlSession.commit();
        } catch (Exception e) {
            e.printStackTrace();
        }
        //关闭
    }
    @Test
    public void updateTest(){
        //获得操作数据库的对象
        //执行sql语句
        try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            User user1 = new User(5,"wangwang","123456");
            if(mapper.getUserById(user1.getId())!=null){
                System.out.println(mapper.updateUser(user1));
                sqlSession.commit();
            }else System.out.println("用户不存在");
        } catch (Exception e) {
            e.printStackTrace();
        }
        //关闭
    }
    @Test
    public void deleteTest(){
        //获得操作数据库的对象
        //执行sql语句
        try (SqlSession sqlSession = MyBatisUtils.getSqlSession()) {
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            if(mapper.getUserById(4)!=null){
                System.out.println(mapper.deleteUser(4));
                sqlSession.commit();
            }else System.out.println("用户不存在");
        } catch (Exception e) {
            e.printStackTrace();
        }
        //关闭
    }
}