Mybatis框架学习1【入门案例】

目录 

mybatis作用

mybatis的环境搭建

环境搭建中的注意事项

---

mybatis作用

mybatis是一种BLL(业务逻辑层)的框架。

平时我们都用JDBC访问数据库，除了需要自己写SQL之外，还必须操作Connection（连接数据库）, Statement（重要接口，连上数据库后，向数据库发送要执行的SQL语句。Statement对象）, ResultSet（数据库结果集的数据表，通常通过执行查询数据库的语句生成） 这些其实只是手段的辅助类。 不仅如此，访问不同的表，还会写很多雷同的代码，显得繁琐和枯燥。

那么用了Mybatis之后，只需要自己提供SQL语句，其他的工作，诸如建立连接，Statement， JDBC相关异常处理等等都交给Mybatis去做了，那些重复性的工作Mybatis也给做掉了，我们只需要关注在增删改查等操作层面上，而把技术细节都封装在了我们看不见的地方。

mybatis的环境搭建

1.创建一个maven-Java的工程（可以不用引入模板），并导入坐标

2.创建实体类和dao的接口

3.创建Mybatis的主配置文件SqlMapConfig.xml（文件名可自定义）

4.创建映射文件daoInterface.xml（文件名可自定义，其对应着dao接口）

我们以一个查询Mysql数据库中user的实例加以说明：

1）创建相关数据库表：

2） 创建Maven项目：（这是Maven项目结构）

3）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>org.example</groupId>
    <artifactId>mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>16</maven.compiler.source>
        <maven.compiler.target>16</maven.compiler.target>
    </properties>

    <!--导入mybatis-->
    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.7</version>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.25</version>
            <scope>runtime</scope>
        </dependency>

        <!-- https://mvnrepository.com/artifact/log4j/log4j -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/junit/junit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

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


</project>

 4)log4j.properties文件：

### 设置###
log4j.rootLogger = debug,stdout,D,E

### 输出信息到控制抬 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

### 输出DEBUG 级别以上的日志到=E://logs/error.log ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = E://logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG 
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 输出ERROR 级别以上的日志到=E://logs/error.log ###
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =E://logs/error.log 
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR 
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

 5）SqlMapConfig.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">
<!--mybatis的主配置文件-->
<configuration>
    <!--配置环境-->
    <environments default="mysql">
        <!--配置mysql的环境-->
        <environment id="mysql">
            <!--配置事务的类型-->
            <transactionManager type="JDBC"/>
            <!--配置数据源（连接池）-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/db_1?&amp;useSSL=false&amp;serverTimezone=UTC&amp;characterEncoding=utf8&amp;characterSetResults=utf8"/>
                <property name="username" value="你的数据库名称，也可用root账号登录"/>
                <property name="password" value="你的数据库密码"/>
            </dataSource>
        </environment>
    </environments>

    <!--指定映射配置文件的位置，映射配置文件指每个dao独立的配置文件-->
    <mappers>
        <mapper resource="com/yz/dao/UserDaoImp.xml"/>
<!--这里如果写为com.yz.dao.UserDaoImp.xml的形式会导致idea找不到相应的文件，因为在resources内文件都以目录形式存在而不是包-->
    </mappers>
</configuration>

6）UserDaoImp.xml文件（注意改文件的结构要和java包中UserDaoImp接口的结构保持一致，另外在建包要一个一个创建，如果遇到包结合不分级显示的情况，打开idea的Project栏右边的设置图标，取消勾选Compact Middle Packages即可解决）

<?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.yz.dao.UserDaoImp"><!--这里的namespace对于Dao中接口的位置-->
    <!--配置查询所有，resultType的作用就是返回封装的位置，如果你要是不写的话，最后mybatis是不知道你到底要封装到哪里，会出现错误，我这个是User表，查询的也是这个，最后返回的结果就封装在User类中-->
    <!--这里的resultType对于实体类的位置-->
    <select id="findAll" resultType="com.yz.domain.User">/*这里必须注意要指定查询结果的封装对象resultType*/
        SELECT * FROM new_user;/*定义sql语句*/
    </select>
    <!--注意在resources中，目录是一级结构，要一个一个创建，若直接创建一个名为Dao.imp的包，它只指一个目录。-->
</mapper>

7）User类：其相关变量的名称要和数据库对应，以保证类成功封装

package com.yz.domain;
import java.io.Serializable;
import java.util.Date;

public class User implements Serializable {
    private Integer id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;

    public Integer getId() {
        return id;
    }

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

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    public String getAddress() {
        return address;
    }

    public void setAddress(String address) {
        this.address = address;
    }

    @Override
    public String toString() {
        return "yz.domain.User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", birthday=" + birthday +
                ", sex='" + sex + '\'' +
                ", address='" + address + '\'' +
                '}';
    }
}

8）UserDaoImp：这里无需创建接口的实现类，mybatis会帮助我们解决

package com.yz.dao;

import com.yz.domain.User;

import java.util.List;

public interface UserDaoImp {
    
    List<User> findAll();
}

9）在test包下创建测试类：

import com.yz.dao.UserDaoImp;
import com.yz.domain.User;
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.*;
import java.util.List;

public class MybatisTest {
    
    public static void main(String[] args) throws IOException {
        //1.读取配置文件
        InputStream in= Resources.getResourceAsStream("SqlMapConfig.xml");
        //2.创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder=new SqlSessionFactoryBuilder();
        SqlSessionFactory factory=builder.build(in);
        //3.使用工程生成sqlSession对象
        SqlSession session= factory.openSession();
        //4.使用SqlSession创建Dao接口的代理对象
        UserDaoImp userDao=session.getMapper(UserDaoImp.class);
        //5.使用代理对象执行方法
        List<User> users=userDao.findAll();
        for (User user:users
             ) {
            System.out.println(user);
        }
        //6.释放资源
        session.close();
        in.close();
    }
}

10）结果展示：

环境搭建中的注意事项

1）上面提到的UseDaoImp.xml文件包结构

2）UseDaoImp.xml文件路径不能用"."而要用"/",否则会导致

Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource com/yz/dao/UserDaoImp.xml报错，原因就是无法找到UserDaoImp.xml文件路径

3）<select id="findAll" resultType="com.yz.domain.User">，每个接口方法要指定对应的封装类。