Mybatis入门系列2--第一个Mybatis程序

Mybatis的入门我们先从一个最简单的mybatis程序开始，体会一下mybatis程序和JDBC代码的不同。好好感受一下基础的用法，后面我们会继续探究其增删改查如何实现。
主要步骤为：

1. 搭建基础环境（创建maven工程–》倒入依赖的包-）
2. 创建Mybatis核心配置文件
3. 编写Mybatis工具类
4. 编写实体类
5. 编写mapper接口
6. 创建mapper接口对应的配置文件
7. 测试效果

数据库设计

CREATE DATABASE mybatis;
USE mybatis;
CREATE TABLE user(
id INT NOT NULL PRIMARY KEY,
name VARCHAR(30) DEFAULT NULL,
pwd VARCHAR(30) DEFAULT null
)ENGINE=INNODB DEFAULT charset=utf8;

INSERT INTO user(id,name,pwd) VALUES
(1, ‘Grissom’, ‘123456’),
(2, ‘Vita’, ‘123456’),

项目结构

搭建环境

• 创建Maven项目

笔者是使用的是IDEA，创建maven项目的时候并没有使用任何模板

• 导入Maven坐标

稍微提一句，之前有人运行数据库报错，看了一下发现安装的是8版本的mysql，这边的maven坐标用的5.所以使用时请注意自己安装的mysql版本和依赖包要一致

    <dependencies>
        <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.3</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.48</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>

• 创建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 表示我们配置的环境，比如这个项目有线上版和测试版，这里可以配置多个environment，然后通过修改这个default的值，来选择我们用的配置启动拿一套。
        <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://locaohost:3306/mybatis?useSSL=true"/>
                    <property name="username" value="root"/>
                    <property name="password" value="123456"/>
                </dataSource>
            </environment>
        </environments>
    </configuration>

• 编写Mybatis工具类

public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static {
        try {
            // 使用Mybatis第一步 获取sqlSessionFactory
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    // 获取sqlSessionFactory之后，我们就可以通过工厂方法获取SqlSession的实例了
    // SqlSession 实例完全包含了面向数据库执行SQL命令的所有方法
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

• 编写实体类代码

public class User {
    private String name;
    private int id;
    private String pwd;
    public User() {
    }
    public User(String name, int id, String pwd) {
        this.name = name;
        this.id = id;
        this.pwd = pwd;
    }
    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", id=" + id +
                ", pwd='" + pwd + '\'' +
                '}';
    }
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getId() {
        return id;
    }

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

    public String getPwd() {
        return pwd;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }
}

• 编写Mapper接口

    public interface UserDao {
        List<User> getUserList();
    }

• Mapper配置文件

    <?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指定对应的接口类-->
    <mapper namespace="com.dingtone.dao.UserDao">
        <!--select 语句， 其中id对应接口方法名-->
        <!--resultType 属性表示 sql语句执行返回类型-->
        <select id="getUserList" resultType="com.dingtone.pojo.User">
            select * from mybatis.user;
        </select>
    </mapper>

• 测试

	@Test
    public void test01(){
        //第一步获取SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //mapper 相当于JDBC中DAO层的接口实现类
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        // 使用接口实现类对象调用方法获取数据库中返回值
        List<User> users = mapper.getUserList();
        for (User user: users){
            System.out.println(user);
        }
        // 一定要关闭！！
        sqlSession.close();
    }

总结

• maven 项目部署的时候导出资源文件很容易出问题，将以下这段放在pom.xml即可

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

Mapper配置文件其实跟之前的接口实现类有点像，主要作用其实也就是代替了接口实现类。读取mapper配置文件生成mapper对象，然后调用mapper对象的操作数据库方法。

• 可能遇见的报错
  // 需要使用mapper的时候。需要在核心配置文件中注册mapper.xml

 org.apache.ibatis.binding.BindingException: Type interface com.dingtone.dao.UserDao is not known to the MapperRegistry.