初学mybatis:我的第一程序

环境说明：

jdk 8+

Mysql 5.1.47

maven-3.6.2

IDEA2021.3

学习之前需要掌握：JDBC，MySQL，Java基础，maven项目构建工具等。

什么是mybatis

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

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

MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 实体类 【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。

MyBatis 本是apache的一个开源项目ibatis, 2010年这个项目由apache 迁移到了google code，并且改名为MyBatis 。

2013年11月迁移到Github .

Mybatis官方文档 : http://www.mybatis.org/mybatis-3/zh/index.html

GitHub : https://github.com/mybatis/mybatis-3

Mybatis第一个程序

搭建环境

1，搭建实验数据库

CREATE DATABASE `mybatis`;

USE `mybatis`;

DROP TABLE IF EXISTS `user`;

CREATE TABLE `user` (
`id` int(20) NOT NULL,
`name` varchar(30) DEFAULT NULL,
`pwd` varchar(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

insert  into `user`(`id`,`name`,`pwd`) values (1,'老九','666666'),(2,'张三','abcdef'),(3,'李四','987654');

user表 

2，导入mybatis相关jar包

- maven仓库上找粘贴过来jar包

<dependency>
   <groupId>org.mybatis</groupId>
   <artifactId>mybatis</artifactId>
   <version>3.5.2</version>
</dependency>
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>5.1.47</version>
</dependency>

3，编写Mybatis核心配置文件

查看官方帮助文档：配置_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">
            <transactionManager type="JDBC"/>
            //使用pooled连接池
            <dataSource type="POOLED">
                //数据库配置信息
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        //将要操作的接口绑定到mybatis的配置文件里面
        <mapper resource="com/yss/dao/UserMapper.xml"/>
    </mappers>
</configuration>

4，编写mybatis工具类

查看帮助文档：Java API_MyBatis中文网

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

public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static {
        try {
            //加载文件的位置
            String resource="mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }


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

}

这是根据官方文档自行封装的工具类MybatisUtils。这样以后直接调用工具类进行测试就行了。由于mybatis的事务提交功能每次都要在测试代码中主动提交，因此封装在工具类中，使用openSession方法提前开启。每次调用时都会开启。这样就不用手动添加commit了。

5，创建实体类

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

实体类中的get和set方法第一次完全生成写完，以后通过IDEA的提示工具自动生成，直接鼠标右键->generate->getter and setter 和totring以及构造方法。 

6，编写Mapper接口类

package com.yss.dao;
import com.yss.pojo.User;
import java.util.List;


public interface UserMapper {
    //查询全部用户，以list的形式返回
    List<User> selectUser();
    }

7，编写Mapper.xml配置文件

namespace命名空间不要写错，很重要！这个com.yss.dao.UserMapper是你的写的接口的位置，在这个接口里面写增删改查操作。直接将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">
<mapper namespace="com.yss.dao.UserMapper">
    <select id="selectUser" resultType="com.yss.pojo.User">
        select * from user
    </select>
    
</mapper>

8，编写测试类

导入Junit包测试。通过dependency导入jar包

package com.yss.test;

import com.yss.dao.UserMapper;
import com.yss.pojo.User;
import com.yss.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;



import java.util.List;


public class MyTest {
    @Test
    public void selectUser(){
        //直接调用写好的工具类获取Session
        SqlSession session = MybatisUtils.getSession();
        //通过反射usermapper类接口来对其进行查询操作
        UserMapper mapper = session.getMapper(UserMapper.class);
        List<User> users = mapper.selectUser();
          //通过foreach循环将数据库的数据循环遍历出来
        for (User user : users) {
            System.out.println(user);
        }
        session.close();
    }
   


}

最后可以运行测试一下。

可能出现的问题说明：Maven静态资源过滤问题

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

项目目录结构图