06JavaEE第六章mybatis

mybatis概述

原是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation 迁移到了 Google Code，随着开发团队转投Google Code 旗下， iBatis3.x正式更名为MyBatis。

MyBatis 是一款优秀的持久层框架。

MyBatis 避免了几乎所有的 JDBC 代码手动设置参数以及手动获取结果集的操 作。

MyBatis 可以使用 XML 或注解来配置和映射,将数据库中的记录映射成Java 的 POJO(Plain Old Java Objects,普通的 Java 对象),是一种 ORM(ORM Object Relational Mapping 对象关系映射)实现.

它支持动态 SQL 以及数据缓存。

Mybatis 将基本的 JDBC 常用接口封装，对外提供操作即可。

Mybatis 中文官网 https://mybatis.org/mybatis-3/zh/getting-started.html

mybatis环境搭建

创建一张表和表对应的实体类

导入 MyBatis jar 包,mysql 数据库驱动包

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

创建 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"> 
        <dataSource type="UNPOOLED"> 
            <property name="driver" value="" /> 
            <property name="url" value="" /> 
            <property name="username" value="" />
            <property name="password" value=""/> 
        </dataSource> 
        </environment> 
    </environments> 
</configuration>

创建 sql 映射文件

<?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="命名空间"> 
    定义 sql 语句 
</mapper>

测试 MyBatis

读取配置文件

Reader reader = Resources.getResourceAsReader(“mybatis-config.xml”);

创建 SqlSessionFactory

SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);

创建 SqlSession

SqlSession sqlSession = sessionFactory.openSession();

Sqlsession 中的方法：

sqlSession.selectOne(namespace+id,参数);

sqlSession .close();关闭

API 接口说明

SqlSessionFactory 接口

使用 SqlSessionFactory 来创建 SqlSession,一旦创建 SqlSessionFactory 就会在整个应用过程中始终存在。由于创建开销较大,所以没有理由去销毁再创建它，一个应用运行中也不建议多次创建 SqlSessionFactory。

SqlSession 接口

Sqlsession 意味着创建与数据库链接会话，该接口中封装了对数据库操作的方法，与数据库会话完成后关闭会话。

Mybatis-Dao 层 Mapper 接口化开发

Mapper 接口开发方式只需要程序员编写 Mapper 接口,由 Mybatis 框架创建接口的动态代理对象,使用 sqlsession.getMapper(接口.class);获得代理对象.

Mapper 接口开发需要遵循以下规范：

1、 Mapper.xml 文件中的 namespace 与 mapper 接口的类路径相同.

2、 Mapper 接口方法名和 Mapper.xml 中定义的每个 statement 的 id 相同.

3、 Mapper 接口方法的输入参数类型和 mapper.xml 中定义的每个 sql 的parameterType 的类型相同。

4、 Mapper 接口方法的输出参数类型和 mapper.xml 中定义的每个 sql 的 resultType 的类型相同。

pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>mybatisPro</artifactId>
    <version>1.0</version>
    <name>mybatisPro</name>
    <packaging>war</packaging>

    <properties>
        <maven.compiler.target>1.8</maven.compiler.target>
        <maven.compiler.source>1.8</maven.compiler.source>
        <junit.version>5.6.2</junit.version>
    </properties>

    <dependencies>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.2</version>
        </dependency>
        <!--mysql-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.28</version>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.3.0</version>
            </plugin>
        </plugins>
    </build>
</project>

mybatis.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>
    <!--mybatis核心配置文件-->
    <!--配置与数据库连接信息-->
    <environments default="dev">
        <environment id="dev">
            <!--配置数据事物管理方式-->
            <transactionManager type="JDBC"/>
            <!--数据源配置 type="POOLED"使用数据库连接池功能-->
            <!--
              每次请求到jdbc就需要创建一个Connection对象，负责与数据库交互的
              数据库连接池技术，减少创建销毁数据库连接对象
              type="POOLED" 不使用数据库连接池
            -->
            <dataSource type="POOLED">
                <!--数据库连接条件-->
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://127.0.0.1:3306/web_db?characterEncoding=utf8&amp;useSSL=false&amp;serverTimezone=Asia/Shanghai"/>
                <property name="username" value="root"/>
                <property name="password" value="shijie"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="mapper/GradeMapper.xml"></mapper>
        <mapper resource="mapper/UserMapper.xml"></mapper>
    </mappers>
</configuration>

GradeMapper.xml
<?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">
<!--SQL映射文件  namespace唯一标识-->
<mapper namespace="com.grade">
    <!--定义sql-->
    <select id="findGrade" parameterType="int" resultType="com.ffyc.mybatispro.model.Grade">
    select * from grade where id = #{id}
  </select>
</mapper>

package com.ffyc.mybatispro.model;

public class Grade {
   
    private int id;
    private String name;

    public Grade() {
   
        System.out.println("无参构造方法");
    }

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

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

package com.ffyc.mybatispro.test;

import com.ffyc.mybatispro.model.Grade;
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 Test1 {
   
    public static void main(String[] args) throws IOException {
   
        String resource = "mybatis.xml";
        //读取mybatis配置文件
        InputStream inputStream = Resources.getResourceAsStream(resource);
        /*
           构造出一个SqlSessionFactory对象，用来创建sqlSession对象，
           在一个项目中由于SqlSessionFactory创建开销较大，一个项目中只创建一个，
         */
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        /*
           创建SqlSession对象，用来每次与数据库交互的，用完即关闭
         */
        SqlSession sqlSession = sqlSessionFactory.openSession();

        Grade grade = sqlSession.selectOne("com.grade.findGrade",1);
        System.out.println(grade);
        sqlSession.close();
    }
}

UserMapper.xml
<?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">
<!--SQL映射文件  namespace名字必须与接口的类路径一致-->
<mapper namespace="com.ffyc.mybatispro.dao.UserDao">
    <!--id名 必须与接口中的方法名相同，参数、返回值都一致-->
    <select id="findUserById" parameterType="int" resultType="com.ffyc.mybatispro.model.User">
        select id,password,account from user where id = #{id}
    </select>
</mapper>

package com.ffyc.mybatispro.util;

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 MybatisUtil {
   
    static SqlSessionFactory sqlSessionFactory;
    //在MybatisUtil第一次加载时，初始化好SqlSessionFactory
    static {
   
        String resource = "mybatis.xml";
        //读取mybatis配置文件
        InputStream inputStream = null;
        try {
   
            inputStream = Resources.getResourceAsStream(resource);
        } catch (IOException e) {
   
            e.printStackTrace();
        }
        /*
           构造出一个SqlSessionFactory对象，用来创建sqlSession对象，
           在一个项目中由于SqlSessionFactory创建开销较大，一个项目中只创建一个，
         */
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }

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

package com.ffyc.mybatispro.dao;

import com.ffyc.mybatispro.model.User;

public interface UserDao {
   
    //定义了一个功能
    User findUserById(int id);
}

package com.ffyc.mybatispro.model;

public class User {
   
    private int id;
    private String account;
    private String password;

    public int getId() {
   
        return id;
    }

    public void setId(int id) {
   
        this.id = id;
    }

    public String getAccount() {
   
        return account;
    }

    public void setAccount(String account) {
   
        this.account = account;
    }

    public String getPassword() {
   
        return password;
    }

    public void setPassword(String password) {
   
        this.password = password;
    }

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

package com.ffyc.mybatispro.test;

import com.ffyc.mybatispro.dao.UserDao;
import com.ffyc.mybatispro.model.User;
import com.ffyc.mybatispro.util.MybatisUtil;
import org.apache.ibatis.session.SqlSession;

import java.io.IOException;

public class Test2 {
   
    public static void main(String[] args) throws IOException {
   

        /*
           创建SqlSession对象，用来每次与数据库交互的，用完即关闭
         */
        SqlSession sqlSession = MybatisUtil.getSqlSession();
        /*
          生成一个接口的代理对象，由代理对象去实际调用接口中与映射文件中对应的SQL
        */
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        User user = userDao.findUserById(1);
        System.out.println(user);
        sqlSession.close();
    }
}

mybatis日志

具体选择哪个日志实现由 MyBatis 的内置日志工厂确定。它会使用最先找到的。Mybatis 内置的日志工厂提供日志功能，具体的日志实现有以下几种方式：SLF4J|LOG4J|JDK_LOGGINGCOMMONS_LOGGING|STDOUT_LOGGING

配置日志

参数传递

简单的参数形式不需要使用 parameterType 参数定义,例如:

User selectUsers(int id);

多个参数使用@Param(“id”)绑定

User selectUsers(@Param(“id”)int id,@Param(“name”)String name);

<select id