Mybatis快速入门

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

使用数据库工具（本人使用SQLyog）创建mybatis数据库以及对应的user表。对应的sql语句如下所示：

CREATE DATAbase mybatis

CREATE TABLE USER(
	id INT PRIMARY KEY,
	`name` VARCHAR(20),
	pwd VARCHAR(20)
)

INSERT INTO USER
VALUES
(1,"张三","111"),
(2,"李四","222"),
(3,"王五","333")

本次博客使用 Maven 来构建项目，因此需要将下面的依赖代码置于 pom.xml 文件中：

    
        
            org.mybatis
            mybatis
            3.5.7
        

        
            mysql
            mysql-connector-java
            8.0.27
        
        
            org.projectlombok
            lombok
            1.18.22
        

        
            junit
            junit
            4.12
            test
        
        
            org.junit.jupiter
            junit-jupiter
            RELEASE
            test
        
    

里面包括mybatis，mysql，lombok(一款插件，能够用@Data简化实体类 的编写,具体可参考后序的实体类)以及junit测试。具体的介绍就不过多赘述。
这里需要注意的是，由于我们的UserMapper.xml资源文件写在java文件的目录下，所以会造成导出失败，解决方案如下：

需要在pom.xml加入一行代码，具体代码如下:

        
            
                src/main/java
                
                    ***.xml
                
                false
            
        
    

这样做的目的就是为了使java目录下的.xml和。properties文件能够顺利导出。

本次实体类以User类为例，包括id，name，pwd等属性。同时需要注意，代码中的包名需要根据自身的代码结构来自行修改。

package com.xing.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    private int id;//id
    private String name;//姓名
    private String pwd;//密码
}

每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。

简而言之，通过核心配置文件就是为了让SqlSessionFactoryBuilder来构建出SqlSessionFactory 实例的。
具体的mybatis.xml核心配置文件如下所示：

需要注意的是，上述的username和passowrd需要根据自己的连接数据库的情况而修改，配置文件中的是地址映射，目的是告诉编译器去哪里找sql语句，这里后序会介绍。

在这里创建一个UserMapper接口。具体的接口如下图所示。

package com.xing.dao;

import com.xing.pojo.User;

import java.util.List;

public interface UserMapper {
    public List selectUser();
}

该接口里面仅有一个selectUser方法，返回值是一个List集合。

接口编写完毕后，需要根据接口来撰写对应的Mapper.xml文件。具体的UserMapper.xml文件呢如下。

    
        select * from mybatis.user;
    

namespace后面书写对应的接口全限定名，id后面是对应的方法名，因为sql语句为查询语句，所以用select标签。resultType对应的是返回值类型，同样要使用全限定名，当然也可以在配置文件里面设置别名，这里设置别名省略。

测试直接在test文件中创建MyTest类，具体的名称可以指定设置。具体对应的MyTest.java文件如下所示。

import com.xing.dao.UserMapper;
import com.xing.pojo.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 org.junit.jupiter.api.Test;

import java.io.IOException;
import java.io.InputStream;
import java.util.List;

public class MyTest {
    @Test
    public void selectUser() throws IOException {
        String resources="mybatis.xml";
        InputStream inputStream = Resources.getResourceAsStream(resources);
        //创建SqlSessionFactory实例
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        //获得sqlSession实例，参数为true设置自动提交事务
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        List users = mapper.selectUser();
        for (User user : users) {
            System.out.println(user);
        }
        //关闭sqlSession
        sqlSession.close();
    }
}

在此代码中，可以将sqlSession的获取过程定义为一个工具类，这样更加方便。

在文章的最后，展示一下文章的代码结构，方便读者的快速入门。