MyBatis-入门

## 第一个MyBatis程序

学习任何东西的思路都是：

搭建环境 -> 导入依赖 -> 编写代码 -> 测试

搭建环境

首先安装数据库和数据库管理软件，这里直接使用以前的MySQL和SQLyog，

然后创建相关的数据库和数据表

-- 每个sql语句以分号结尾
CREATE DATABASE mybatis;
USE mybatis;
CREATE TABLE `user`(
 `id` INT(20) NOT NULL PRIMARY KEY,
 `name` VARCHAR(30) DEFAULT NULL,
 `pwd` VARCHAR(30) DEFAULT NULL
 )ENGINE=INNODB DEFAULT CHARSET=utf8;
 
 INSERT INTO `user` VALUES(1,'张三','111'),(2,'李四','000'),(3,'王五','666');

创建父子工程

  • 创建父Maven - 空项目

    image-20200726132328150

  • 删除src目录，父工程不写代码的，只管导入依赖

  • 配置父工程的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>com.hong</groupId>
    <artifactId>MyBatis-Study</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!--导入相关依赖-->
    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
        </dependency>
    </dependencies>
</project>

  • 创建模块 -- Maven子项目继承父项目的依赖

    image-20200726133203958

    image-20200726133506806

编写配置文件

在子项目的resources目录下创建mybatis-config.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;userUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

封装工具类

MybatisUtils.java

package com.hong.util;

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 {
            // 使用MyBatis的第一步就是获取sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * 通过工厂生产sqlSession对象
     * @return sql操作对象
     */
    public static SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }
}

编写代码

实体类

Dao接口

接口实现类

  1. pojo

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

  2. dao

    package com.hong.dao;

import com.hong.pojo.User;

import java.util.List;

/**
 * 以后的dao都写成mapper
 */
public interface UserDao {
    // 获取用户列表
    List<User> getUserList();
}

  3. 实现类由原来的UserDaoImpl转变为Mapper配置文件

    原来的实现类(对比而已，现在不用了！)

    package com.hong.dao;

import com.hong.pojo.User;

import java.util.List;

/**
 * 以前jdbc时都是写这种实现类
 * 使用MyBatis之后就用xml实现
 */
public class UserDaoImpl implements UserDao {
    public List<User> getUserList() {
        // 底层的JDBC跟数据库打交道，拿到用户列表后返回
        return null;
    }
}

    Mybatis的Mapper配置文件

    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.hong.dao.UserDao">
    <!--select查询语句 -->
    <select id="getUserList" resultType="com.hong.pojo.User">
        select * from mybatis.user
    </select>
</mapper>

    解释：在xml中不能导入包，所以要写全路径。id绑定的是接口的方法，返回结果是列表中的泛型。中间写sql语句

测试

运行出错跳转到后面看看

UserDaoTest.java

package com.hong.dao;

import com.hong.pojo.User;
import com.hong.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDaoTest {
    @Test
    public void test() {
        // 获取数据库操作对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        try {
            // 方式1 建议使用
            UserDao userDao = sqlSession.getMapper(UserDao.class);
            List<User> userList = userDao.getUserList();

            // 方式2 老版本的获取方式
            // List<User> userList = sqlSession.selectList("com.hong.dao.UserDao.getUserList");
            for (User user : userList) {
                System.out.println(user);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            sqlSession.close();
        }
    }
}

解决完报错之后的运行结果

User{id=1, name='张三', pwd='111'}
User{id=2, name='李四', pwd='000'}
User{id=3, name='王五', pwd='666'}

遇到的问题

注意点！这里有很多坑要注意啦

  • 没有注册mapper -> 绑定异常 Type interface com.hong.dao.UserDao is not known to the MapperRegistry.

    • 回到核心配置文件mybatis-config.xml中注册mapper

      <?xml version="1.0" encoding="UTF8" ?>
<!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;userUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/hong/dao/UserMapper.xml"/>
    </mappers>
</configuration>

  • 找不到资源 -> 可能是静态资源被过滤，查看target目录下有没有UserMapper.xml。也可能是路径写错了

    • 如果在target目录下找不到，则在子项目的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>
            </resource>
        </resources>
    </build>

    • 注册mapper时，路径使用斜杠分隔。com/hong/dao/UserMapper.xml

  • 版本兼容问题，报错一字节错误时，将<?xml version="1.0" encoding="UTF-8" ?>的 UTF-8 改成 UTF8

  • 建议不要在xml内出现中文，包括注释

总结

使用配置文件替代原来繁杂的JDBC操作，但思想都是一样的。

posted @ 2020-07-26 19:48  小橘子ღ  阅读(243)  评论(0)  编辑  收藏  举报