MyBatis：第一个程序

最新推荐文章于 2022-05-11 16:09:27 发布

LiuszZZ

最新推荐文章于 2022-05-11 16:09:27 发布

阅读量178

点赞数

分类专栏： MyBatis 文章标签： mybatis

本文链接：https://blog.csdn.net/qq_39720594/article/details/107030026

版权

MyBatis 专栏收录该内容

12 篇文章 0 订阅

订阅专栏

本文总结自，B站-遇见狂神说

搭建环境

1. 搭建数据库

create database `mybatis1`;

use `mybatis1`;

CREATE TABLE `user` (
  `id` INT(11) NOT NULL AUTO_INCREMENT COMMENT '用户id',
  `name` VARCHAR(30) DEFAULT NULL COMMENT '用户名',
  `pwd` VARCHAR(30) DEFAULT NULL COMMENT '密码',
  PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;

-- 添加数据
INSERT INTO 
	USER (`name`,`pwd`) 
VALUES 
	('张三',123456),
	('李四',112233),
	('王五',2233);

2. 新建maven项目（无骨架）

删除src目录（父工程）
导入maven依赖

<?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>cn.luis</groupId>
    <artifactId>Mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!--导入依赖-->
    <dependencies>
        <!--mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
        <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

3. 在父工程内创建模块

点击父工程 new - - model

优点：子模块无序在配置pom.xml文件

父工程配置文件会多出子模块：

<!--父工程-->
    <groupId>cn.luis</groupId>
    <artifactId>Mybatis</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <!--子模块：创建后自动出现！-->
    <modules>
        <module>mybatis-01</module>
    </modules>
	...

4. 编写`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 核心配置文件-->
<configuration>
    <!--配置环境，通过id选择-->
    <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/mybatis1?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

5. 编写MyBatis工具类（依照官方文档）

package 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 MyBatisUtil {

    private static SqlSessionFactory sqlSessionFactory;

    static {
        try {
            // 第一步，获取sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * 获取sqlSession实例
     * 它完全包含了面向数据库执行sql命令的所有方法
     *
     * @return
     */
    public static SqlSession getSession() {
        return sqlSessionFactory.openSession();
    }
}

6. 编写实体类

public class user {
    private int id;
    private String name;
    private String pwd;
    ...
    // 构造方法：空参 + 全参
    // get、set方法
    // toStirng方法    
}

7. 编写接口

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

8. 编写`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">

<!--namespace,命名空间，绑定一个对应的Dao接口-->
<mapper namespace="cn.luis.dao.UserMapper">

    <!--查询语句，id 方法名称，-->
    <select id="getUserList" resultType="cn.luis.pojo.User">
         select * from mybatis1.user;
    </select>
    <!--注册mapper-->
    <mappers>
        <!--三种注册方式，分隔符用` / `-->
        <mapper resource="cn/luis/dao/UserMapper.xml"></mapper>
    </mappers>
</mapper>

测试

使用junit测试

测试代码：

package cn.luis.dao;

import cn.luis.pojo.User;
import cn.luis.util.MyBatisUtil;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {
    @Test
    public void test() {
        // 获得sqlSession对象
        SqlSession sqlSession = MyBatisUtil.getSession();

        /**
         方式一：getMapper
         通过sqlSession对象，获取到接口
         （方便获取配置文件中的sql语句）
         */
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

        /**
         * 执行接口中的方法
         */
        List<User> userList = userMapper.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }
        // 释放资源
        sqlSession.close();
    }
}

结果：

user{id=1, name='张三', pwd='123456'}
user{id=2, name='李四', pwd='112233'}
user{id=3, name='王五', pwd='2233'}

可能抛出的异常

1. `Mapper`未注册异常

org.apache.ibatis.binding.BindingException: Type interface cn.luis.dao.UserMapper is not known to the MapperRegistry.

原因：

配置文件mapper未注册到核心文件！

解决：

在mybatis核心配置文件中注册mapper

<mappers>
    <!--三种注册方式，分隔符用` / `-->
    <mapper resource="cn/luis/dao/UserMapper.xml"></mapper>
</mappers>

2. 初始化异常（如，xml文件被拦截）

java.lang.ExceptionInInitializerError
	at cn.luis.dao.UserMapperTest.test(UserMapper.java:22)
    ...

原因：

Maven的约定大于配置，可能导致我们编写的配置文件无法导出或生效。

解决：

在pom.xml文件中添加配置即可！（父工程和子工程都添加）

	<build>
        <!--防止资源导出失败-->
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
            <!--java文件夹下-->
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
	</build>

3. PersistenceException

org.apache.ibatis.exceptions.PersistenceException:

原因：

核心配置文件中url的value值得useSSL设置为true会报异常！【mysql 5.7】

JDBC在与数据库连接时，JDBC与MySQL版本不兼容，MySQL的版本高一些【可能是这个原因】

<property name="url"
    value="jdbc:mysql://localhost:3306/mybatis1?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>

解决：

将值设为false即可。

拓展：MySQL在高版本需要指明是否进行SSL连接

SSL协议提供服务主要：

认证用户服务器，确保数据发送到正确的服务器；　　 .
加密数据，防止数据传输途中被窃取使用；
维护数据完整性，验证数据在传输过程中是否丢失；

易错点

配置文件未注册
绑定接口错误
方法名错误
返回类型错误

未完待续 …