Mybatis入门学习(一)

一、MyBatis简介

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。

需要在Github上下载！地址：https://github.com/mybatis/mybatis-3

当前的最新版本是MyBatis 3.5.4！

我们可以在其官网上查看文档进行学习！地址：https://mybatis.org/mybatis-3/

特性：

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

二、编写第一个程序

1、准备一个数据库mybatis，创建一个user表，插入四条数据

CREATE DATABASE `mybatis`;

USE `mybatis`;

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,'张三','123456'),(2,'李四','zxcvbn'),(3,'王五','123456'),(4,'赵六','123456');

2、创建Maven项目添加依赖导入jar包

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.4</version>
</dependency>
<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.47</version>
</dependency>

3、配置文件编写mybatis0config.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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <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>
</configuration>

4、编写一个工具类操作数据库

package com.star.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();
        }
    }

    //使用openSession()方法获取sqlSession的连接
    public static SqlSession getSession(){
        return sqlSessionFactory.openSession();
    }
}

5、配置一个实体类与数据库对应(可以使用Lombok，比较方便)

package com.star.pojo;

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

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    private int id;
    private String name;
    private String pwd;
}

6、编写持久层的操作接口

package com.star.mapper;

import com.star.pojo.User;

import java.util.List;

// 操作用户的接口类
public interface UserMapper {

    //获得所有的用户的方法
    List<User> getUserList();

}

7、之前我们需要编写接口的实现类，使用了MyBatis之后，我们可以专注编写SQL语句，使用配置文件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.star.mapper.UserMapper">

    <select id="getUserList" resultType="com.star.pojo.User">
        select * from user;
    </select>

</mapper>

注意：

namesqace绑定对应的接口，在哪个包下要写上；
具体操作（CRUD）的标签（select、delete..）对应的 id 为接口中的方法名；
resultType对应放回置类型，方法虽然放回的是List，但是，每一个都是User对象，所有这里对应的是User，要写包名。

8、这个配置文件一定要注册到MyBatis的配置文件mybatis-config.xml中,写在configuration标签后

<mappers>
    <mapper resource="com/star/mapper/UserMapper.xml"/>
</mappers>

这里是接口配置文件对应的路径；

9、编写一个测试类运行

import com.star.mapper.UserMapper;
import com.star.pojo.User;
import com.star.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;

import java.util.List;

public class Test {
    public static void main(String[] args) {

        //获取SqlSession，执行sql使用的
        SqlSession session = MybatisUtils.getSession();

        //通过session。getMapper（Class对象）获得接口
        UserMapper mapper = session.getMapper(UserMapper.class);

        List<User> userList = mapper.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }
    }
}

测试结果：

这是对应的目录层级，防止读取不到配置文件的，显示问题，包要一级一级的创建！