MyBatis学习(一)

本文涉及的产品
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
云数据库 RDS MySQL,集群系列 2核4GB
推荐场景:
搭建个人博客
云数据库 RDS PostgreSQL,集群系列 2核4GB
简介: MyBatis学习(一)

一、MyBatis入门


1.环境搭建


步骤一:创建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>Zhongger</groupId>
    <artifactId>MyBatisDay01</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>
    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.38</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.12</version>
        </dependency>
    </dependencies>
</project>

一般而言,Mybatis框架依赖的Jar包就只需要以下两个

<dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.38</version>
        </dependency>

创建数据库中的Users数据表,SQL语句如下:


CREATE TABLE Users(
  id INT,
  user_name VARCHAR(30),
  pass_word VARCHAR(50)
);


向数据库中插入数据,查询结果如下:

2019101620085617.png

步骤二:创建实体类和Dao的接口


如图所示,项目的目录结构为:

20191016194631187.png


首先创建Dao接口(IUserDao.java)

package cn.zhongger.dao;
import cn.zhongger.domain.User;
import java.util.List;
/**
 * 用户持久层接口
 */
public interface IUserDao {
    List<User> findAll();
}

然后创建实现IUserDao接口的实体类(User.java)

package cn.zhongger.domain;
import java.io.Serializable;
public class User implements Serializable {
    private Integer id;
    private String user_name;
    private String pass_word;
    public User(Integer id, String user_name, String pass_word) {
        this.id = id;
        this.user_name = user_name;
        this.pass_word = pass_word;
    }
    public User() {
    }
    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getUser_name() {
        return user_name;
    }
    public void setUser_name(String user_name) {
        this.user_name = user_name;
    }
    public String getPass_word() {
        return pass_word;
    }
    public void setPass_word(String pass_word) {
        this.pass_word = pass_word;
    }
   @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", user_name='" + user_name + '\'' +
                ", pass_word='" + pass_word + '\'' +
                '}';
    }
}
步骤三:创建MyBatis的主配置文件SqlMapConfig.xml

一般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">

以下是完整的MyBatis主配置文件SqlMapConfig.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>
    <!--mybatis的主配置文件-->
    <environments default="mysql">
        <!--配置mysql环境-->
        <environment id="mysql">
            <!--配置事务类型-->
            <transactionManager type="JDBC">
            </transactionManager>
            <!--配置数据源(连接池)-->
            <dataSource type="POOLED">
                <!--配置连接数据库的四个基本信息-->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/zmy"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <!--指定映射配置文件的配置,映射配置文件指的是每个dao独立的配置文件-->
    <mappers>
        <mapper resource="cn/zhongger/dao/IUserDao.xml"/>
    </mappers>
</configuration>
步骤四 创建映射配置文件 IUserDao.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">

以下是完整的映射配置文件 IUserDao.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="cn.zhongger.dao.IUserDao">
    <!--配置查询所有-->
    <select id="findAll">
        select *from Users;
    </select>
</mapper>
环境搭建的注意事项:


a.创建IUserDao.xml和IUserDao.java时,这样命名是为了和我们之前的知识保持一致。在MyBatis中,它把持久层的操作接口名称和映射文件也叫做:Mapper 。故IUserDao和IUserMapper是一样的,只是命名风格不同罢了。哈哈, 我是跟着黑马的教程学的,所以这种命名风格我也一直用着~

b.在IDEA中创建目录的时候,它和包是不一样的。

包在创建时:cn.zhonger.dao是三级结构

目录在创建时:cn.zhongger.dao是一级目录

c.Mybatis的映射配置文件位置必须和Dao接口的包结构相同

d.映射配置文件的mapper标签namespace属性的取值必须是Dao接口的全限定类名

e.映射配置文件的操作配置,id属性的取值必须是Dao接口的方法名

当我们遵从了第3,4,5点后,我们在开发中就无需再写Dao接口的实现类


2.入门案例


在test/java包中新建cn.zhongger.test包,然后在该包下新建MybatisTest.java测试类
目录结构如图所示:

20191016195000423.png

编写该类的代码如下:

package cn.zhongger.test;
import cn.zhongger.dao.IUserDao;
import cn.zhongger.domain.User;
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;
import java.util.List;
public class MybatisTest {
    /**
     * 入门案例
     * @param args
     */
    public static void main(String[] args) throws IOException {
        //1.读取配置文件
        InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        //2.创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory sqlSessionFactory = builder.build(inputStream);
        //3.使用工厂生成SqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //4.使用SqlSession创建Dao接口的代理对象
        IUserDao mapper = sqlSession.getMapper(IUserDao.class);
        //5.使用代理对象执行方法
        List<User> users = mapper.findAll();
        //6.遍历users的List,并打印
        for (User user:users
             ) {
            System.out.println(user);
        }
        //6.释放资源
        sqlSession.close();
        inputStream.close();
    }
}

运行以下发现会报如下错:

Exception in thread "main" org.apache.ibatis.exceptions.PersistenceException: 
### Error querying database.  Cause: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'cn.zhongger.dao.IUserDao.findAll'.  It's likely that neither a Result Type nor a Result Map was specified.
### The error may exist in cn/zhongger/dao/IUserDao.xml
### The error may involve cn.zhongger.dao.IUserDao.findAll
### The error occurred while handling results
### SQL: select *from Users;
### Cause: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'cn.zhongger.dao.IUserDao.findAll'.  It's likely that neither a Result Type nor a Result Map was specified.
  at org.apache.ibatis.exceptions.ExceptionFactory.wrapException(ExceptionFactory.java:30)
  at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:150)
  at org.apache.ibatis.session.defaults.DefaultSqlSession.selectList(DefaultSqlSession.java:141)
  at org.apache.ibatis.binding.MapperMethod.executeForMany(MapperMethod.java:139)
  at org.apache.ibatis.binding.MapperMethod.execute(MapperMethod.java:76)
  at org.apache.ibatis.binding.MapperProxy.invoke(MapperProxy.java:59)
  at com.sun.proxy.$Proxy2.findAll(Unknown Source)
  at cn.zhongger.test.MybatisTest.main(MybatisTest.java:30)
Caused by: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'cn.zhongger.dao.IUserDao.findAll'.  It's likely that neither a Result Type nor a Result Map was specified.

报org.apache.ibatis.exceptions.PersistenceException:异常的原因很简单,就是MyBatis框架并不知道SQL语句执行的结果要封装到哪里,MyBatis框架的设计之初是会封装所有的表所有的对象,若不指明要封装的对象,则会让MyBatis无法知晓这些表或对象之间的关系,从而报错。解决的办法如下:


修改映射配置文件 IUserDao.xml,添加属性resultType ,属性值为实体类的全限定类名,在这个例子中,我的实体类的全限定类名为cn.zhongger.domain.User,下面给出修改后的配置文件IUserDao.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="cn.zhongger.dao.IUserDao">
    <!--配置查询所有-->
    <select id="findAll" resultType="cn.zhongger.domain.User">
        select *from Users;
    </select>
</mapper>

再次运行MybatisTest.java,控制台打印如下信息:


20191016200505444.png


这与数据库中的内容一致,这样我们就完成了 MyBatis的第一个入门案例的学习。


3.使用注解来进行配置(无需配置Map映射的xml)


步骤一:先移除IUserDao.xml,在IUserDao的findAll()方法上加上注解@Select(“select * from Users”)

package cn.zhongger.dao;
import cn.zhongger.domain.User;
import org.apache.ibatis.annotations.Select;
import java.util.List;
/**
 * 用户持久层接口
 */
public interface IUserDao {
    @Select("select * from Users")
    List<User> findAll();
}


步骤二:修改SqlMapConfig.xml,将resource属性修改成class属性,属性值为IUserDao的全限定类名


<mappers>
      <mapper class="cn.zhongger.dao.IUserDao"></mapper>
</mappers>


再次运行测试类代码,所得的结果与xml配置的结果一致。


总结


1.配置pron.xml文件,写完要依赖的Jar包的配置信息后,要检查项目栏中External Libraries中是否含有导入的包,若没有,证明导入失败,要重新写配置文件。

2.配置MyBatis.xml文件,最好记住这些套路,或者把一些固定的配置信息写进一个文件保存好来,方便多次重复使用。

3.配置Map映射文件,要注意到设置resultType属性和属性值,避免PersistenceException报错。

4.下面的目录结构要一致,resources下的是directory,创建的时候要分开来创建。

20191016202305891.png

5.测试类的代码中用到的几种设计模式

public class MybatisTest {
    /**
     * 入门案例
     * @param args
     */
    public static void main(String[] args) throws IOException {
        //1.读取配置文件
        InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
        //2.创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory sqlSessionFactory = builder.build(inputStream);
        //3.使用工厂生成SqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //4.使用SqlSession创建Dao接口的代理对象
        IUserDao mapper = sqlSession.getMapper(IUserDao.class);
        //5.使用代理对象执行方法
        List<User> users = mapper.findAll();
        //6.遍历users的List,并打印
        for (User user:users
             ) {
            System.out.println(user);
        }
        //6.释放资源
        sqlSession.close();
        inputStream.close();
    }
}


创建SqlSessionFactory工厂使用了构建者模式:把对象的创建细节隐藏,使得使用者直接调用方法即可拿到对象;


生产SqlSession使用了工厂模式,优势是解耦,降低类之间的依赖关系;


创建IUserDao接口使用了代理模式,优势是在不修改源码的基础上,对已有方法增强。

相关实践学习
如何快速连接云数据库RDS MySQL
本场景介绍如何通过阿里云数据管理服务DMS快速连接云数据库RDS MySQL,然后进行数据表的CRUD操作。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
相关文章
|
1月前
|
缓存 NoSQL Java
Mybatis学习:Mybatis缓存配置
MyBatis缓存配置包括一级缓存(事务级)、二级缓存(应用级)和三级缓存(如Redis,跨JVM)。一级缓存自动启用,二级缓存需在`mybatis-config.xml`中开启并配置映射文件或注解。集成Redis缓存时,需添加依赖、配置Redis参数并在映射文件中指定缓存类型。适用于查询为主的场景,减少增删改操作,适合单表操作且表间关联较少的业务。
|
4月前
|
Java 关系型数据库 MySQL
springboot学习五:springboot整合Mybatis 连接 mysql数据库
这篇文章是关于如何使用Spring Boot整合MyBatis来连接MySQL数据库,并进行基本的增删改查操作的教程。
656 0
springboot学习五:springboot整合Mybatis 连接 mysql数据库
|
5月前
|
Java 关系型数据库 数据库连接
mybatis-plus学习
MyBatis-Plus ,MyBatis 最佳搭档,只做增强不做改变,为简化开发、提高效率而生。
70 5
|
6月前
|
安全 Java 数据库连接
后端框架的学习----mybatis框架(3、配置解析)
这篇文章详细介绍了MyBatis框架的核心配置文件解析,包括环境配置、属性配置、类型别名设置、映射器注册以及SqlSessionFactory和SqlSession的生命周期和作用域管理。
后端框架的学习----mybatis框架(3、配置解析)
|
6月前
|
Java 数据库连接 mybatis
后端框架的学习----mybatis框架(9、多对一处理和一对多处理)
这篇文章介绍了在MyBatis框架中如何处理多对一和一对多的关联查询,通过定义`<resultMap>`和使用`<association>`与`<collection>`元素来实现对象间的关联映射。
|
6月前
|
Java 数据库连接 测试技术
后端框架的学习----mybatis框架(8、lombok)
这篇文章介绍了如何在MyBatis框架中使用lombok库来简化Java实体类的编写,包括在IDEA中安装Lombok插件、在项目中导入lombok依赖以及在实体类上使用Lombok提供的注解。
|
6月前
|
Java 数据库连接 数据库
后端框架的学习----mybatis框架(6、日志)
这篇文章介绍了如何在MyBatis框架中使用日志功能,包括配置MyBatis的日志实现、使用log4j作为日志工具,以及如何通过配置文件控制日志级别和输出格式。
|
6月前
|
SQL Java 数据库连接
后端框架的学习----mybatis框架(5、分页)
这篇文章介绍了如何在MyBatis框架中实现分页功能,包括使用SQL的`limit`语句进行分页和利用MyBatis的`RowBounds`对象进行分页的方法。
|
6月前
|
SQL Java 数据库连接
后端框架的学习----mybatis框架(7、使用注解开发)
这篇文章讲述了如何使用MyBatis框架的注解方式进行开发,包括在接口上使用注解定义SQL语句,并通过动态代理实现对数据库的增删改查操作,同时强调了接口需要在核心配置文件中注册绑定。
|
9月前
|
SQL Java 数据库连接
【Mybatis】深入学习MyBatis:概述、主要特性以及配置与映射
【Mybatis】深入学习MyBatis:概述、主要特性以及配置与映射
【Mybatis】深入学习MyBatis:概述、主要特性以及配置与映射