初入Mybatis:简介及配置

2020-07-31 17:00:00 浏览数 (1)

基础知识：

  • JDBC
  • Mysql
  • Java基础
  • Maven
  • Junit

框架：是有配置文件的。最好的方式：看官网文档

1、简介

1.1 什么是MyBatis

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

1.2 如何获得MyBatis？

  • Maven仓库
代码语言：javascript复制
  <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
  <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.5.3</version>
  </dependency>
  • github：https://github.com/mybatis/mybatis-3/releases
  • 中文文档：https://mybatis.org/mybatis-3/zh/index.html

1.3 持久化

数据持久化

  • 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
  • 内存：断电即失
  • 数据库(JDBC),io文件持久化。
  • 生活：冷藏、罐头。

为什么需要持久化？

  • 有一些对象，不能让他丢掉。

1.4 持久层

Dao层、Service层、Controller层.....

  • 完成持久化工作的代码块
  • 层界限十分明显

1.5 为什么需要Mybatis？

  • 帮助程序员将数据存入到数据库中。
  • 方便
  • 传统的JDBC代码太复杂了。简化、框架、自动化。
  • 不用Mybatis也可以。更容易上手。技术没有高低之分
  • 优点：
    • 简单易学
    • 灵活
    • sql和代码的分离，提高了可维护性。
    • 提供映射标签，支持对象与数据库的orm字段关系映射
    • 提供对象关系映射标签，支持对象关系组建维护
    • 提供xml标签，支持编写动态sql。

最重要的一点：使用的人多！

Spring SpringMVC SpringBoot

2、第一个Mybatis程序

思路：搭建环境-->导入Mybatis-->编写代码-->测试！

2.1、搭建环境

搭建数据库

代码语言：javascript复制
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` (`id`,`name`,`pwd`) VALUES
(1,'狂神','123456'),
(2,'张三','123456'),
(3,'李四','123890')

新建项目

  1. 新建一个普通的maven项目
  2. 删除src目录
  3. 导入maven依赖
代码语言：javascript复制
<?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.rui</groupId>
    <artifactId>MyBatis-Study</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!--导入依赖-->
    <dependencies>
        <!--mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.17</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>
        </dependency>
    </dependencies>

</project>
代码语言：javascript复制
<!--在build中配置resources，来防止我们资源导出失败的问题-->
    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
                </includes>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>

2.2、创建一个模块

  • 编写mybatis的核心配置文件
  • mysql5.6及以下版本 <?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> <!--environments配置环境组--> <!--default默认环境--> <environments default="development"> <!--environment单个环境--> <environment id="development"> <!--transactionManager配置事务管理器--> <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=UFT-8"/> <property name="username" value="root"/> <property name="password" value="Cc105481"/> </dataSource> </environment> </environments> </configuration>
  • mysql5.7及以上
代码语言：javascript复制
  <?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>
      <!--environments配置环境组-->
      <!--default默认环境-->
      <environments default="development">
          <!--environment单个环境-->
          <environment id="development">
              <!--transactionManager配置事务管理器-->
              <transactionManager type="JDBC"/>
              <!--配置连接池-->
              <dataSource type="POOLED">
                  <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                  <property name="url" value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=UTF-8&amp;useSSL=true&amp;serverTimezone=UTC"/>
                  <property name="username" value="root"/>
                  <property name="password" value="123456"/>
              </dataSource>
          </environment>
      </environments>
      <mappers>
          <mapper resource="org/mybatis/example/BlogMapper.xml"/>
      </mappers>
  </configuration>
  • 编写mybatis工具类
代码语言：javascript复制
package com.rui.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;

//sqlSessionFactory--->SessionFactory
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 命令所需的所有方法。
    // 你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

2.3、编写代码

  • 实体类 package com.rui.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 ''' '}'; } }
  • Dao接口 package com.rui.dao; import com.rui.pojo.User; import java.util.List; public interface UserDao { List<User> getUserList(); }
  • 接口实现类由原来的UserImpl转变为一个Mapper配置文件
代码语言：javascript复制
<?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=绑定一个对应的mapper接口-->
<mapper namespace="com.rui.dao.UserDao">
    <!--select查询语句-->
   <select id="getUserList" resultType="com.rui.pojo.User">
       /*定义sql*/
       select * from mybatis.user
   </select>
</mapper>

2.4、测试

注意点：

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

MapperRegistry是什么?

核心配置文件中注册mappers

  • junit测试 package com.rui; import com.rui.dao.UserDao; import com.rui.pojo.User; import com.rui.utils.MyBatisUtils; import org.apache.ibatis.session.SqlSession; import org.junit.Test; import java.util.List; public class UserDaoTest { @Test public void test(){ //第一步：获得SqlSession对象 SqlSession sqlSession = MyBatisUtils.getSqlSession(); //执行SQL UserDao mapper = sqlSession.getMapper(UserDao.class); List<User> userList = mapper.getUserList(); for (User user : userList) { System.out.println(user); } //关闭SqlSession sqlSession.close(); } }

可能会遇到的问题：

  1. 配置文件没有注册
  2. 绑定接口错误
  3. 方法名不对
  4. 返回类型不对
  5. Maven导出资源问题

3、CRUD

1、namespace

namespace中的包名要和Dao/mapper接口的包名保持一致

2、select

选择查询语句；

  • id：就是对应的namespace中的方法名；
  • resultType：Sql语句执行的返回值！
  • parameterType：参数类型！
  1. 编写接口 package com.rui.dao; import com.rui.pojo.User; import java.util.List; public interface UserMapper { //根据id查询用户 User getUserById(int id); }
  2. 编写对应的mapper中的sql语句 <select id="getUserById" resultType="com.rui.pojo.User" parameterType="int"> /*定义sql*/ select * from mybatis.user where id = #{id}; </select>
  3. 测试 <!--增删改需要提交事务--> @Test public void getUserById(){ SqlSession sqlSession = MyBatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); User user = mapper.getUserById(1); System.out.println(user); sqlSession.close(); }

3、Insert

4、Update

5、Delete

注意点：增删改需要提交事务 sqlSession.commit();

常数类型parameterType 为int时可以不写

6、分析错误

  • 标签不要匹配错误
  • resource绑定mapper，需要使用路径！
  • 程序配置文件必须符合规范
  • NullPointerException，没有注册到资源
  • 输出的xml文件中存在中文乱码问题
  • maven资源没有导出问题

7、万能Map

假设，我们的实体类，或者数据库中的表，字段或者参数过多，我们应当考虑使用Map！

代码语言：javascript复制
//万能Map
    int addUser2(Map<String,Object> map);
代码语言：javascript复制
    <!--对象中的属性，可以直接取出来 parameterType=传递map中的key-->
    <insert id="addUser2" parameterType="map">
        insert into mybatis.user (id, name, pwd) values (#{userId},#{userName},#{password});
    </insert>
代码语言：javascript复制
//万能map
    @Test
    public void addUser2(){
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        HashMap<String, Object> map = new HashMap<>();
        map.put("userId",4);
        map.put("userName","王五");
        map.put("password","23333");
        mapper.addUser2(map);
        //提交事务
        sqlSession.commit();
        sqlSession.close();
    }

Map传递参数，直接在sql中取出key即可！【parameterType="map"】

对象传递参数，直接在sql中取对象的属性即可！【parameterType="Object"】

只有一个基本类型参数的情况下，可以直接在sql中取到！

多个参数用Map，或者注解！

8、思考

模糊查询怎么写？

  1. Java代码执行的时候传递通配符%% List<User> userList=mapper.getUserLike("%李%");
  2. 在sql拼接中使用通配符！ select * from mybatis.user where name like "%"#{value}"%"

4、配置解析

1、核心配置文件

  • mybatis-config.xml
  • MyBatis的配置文件包含了会深深影响MyBatis行为的设置和属性信息
代码语言：javascript复制
configuration（配置）
properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境配置）
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识）
mappers（映射器）

2、环境配置（environments）

MyBatis 可以配置成适应多种环境

不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。

学会使用配置多套运行环境！

MyBatis默认的事务管理器就是JDBC，连接池：POOLED

3、属性（properties）

我们可以通过properties属性来实现引用配置文件

这些属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过 properties 元素的子元素来传递。【db.properties】

编写一个配置文件

db.properties

代码语言：javascript复制
driver= com.mysql.cj.jdbc.Driver
url= jdbc:mysql://localhost:3306/project_test?characterEncoding=UTF-8&useSSL=true&serverTimezone=UTC
username= root
password= 123456

在核心配置文件中引入

代码语言：javascript复制
 <!--引入外部配置文件-->
    <properties resource="db.properties">
    
        //无效
        <property name="username" value="测试"/>
        <property name="password" value="测试"/> 
        
    </properties>
  • 可以直接引入外部文件
  • 可以在其中增加一些属性配置
  • 如果两个文件有同一字段，优先使用外部配置文件的！

4、类型别名（typeAliases）

  • 类型别名是为 Java 类型设置一个短的名字。
  • 存在的意义仅在于用来减少类完全限定名的冗余。 <!--可以给实体类起别名--> <typeAliases> <typeAlias type="com.rui.pojo.User" alias="User"/> </typeAliases>

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean,比如：

扫描实体类的包，他的默认别名就为这个类的类名，首字母小写！

代码语言：javascript复制
 <!--可以给实体类起别名-->
    <typeAliases>
        <package name="com.rui.pojo"/>
    </typeAliases>

在实体类比较少的时候，使用第一种方式。

如果实体类十分多，建议使用第二种方式。

第一种可以DIY别名.

第二种则不行，如果非要改，需要在实体类（pojo）上增加@Alias注解

代码语言：javascript复制
@Alias("author")
public class Author {
    ...
}

5、设置

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

6、生命周期和作用域

生命周期，和作用域是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder

  • 一旦创建了SqlSessionFactory，就不再需要它了
  • 局部变量

SqlSessionFactory：

  • 可以想象为：数据库连接池
  • SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。
  • 因此SqlSessionFactory的最佳作用域是应用作用域。
  • 最简单的就是使用 单例模式 或者静态单例模式

SqlSession

  • 连接到连接池的一个请求！
  • SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。
  • 用完之后需要赶紧关闭，否则会占用资源

这里的每一个Mapper，就代表一个具体的业务！

5、解决属性名和字段名不一致的问题

1、问题

数据库中的字段

新建一个项目，拷贝之前的，测试实体类字段不一致的情况。

代码语言：javascript复制
public class User {
    private int id;
    private String name;
    private String pwd;
}
代码语言：javascript复制
//select * from mybatis.user where id = #{id}
//类型处理器
//select id,name,pwd from mybatis.user where id = #{id}

解决方法：

  • 起别名
代码语言：javascript复制
select id,name,pwd as password from mybatis.user where id = #{id}

2、resultMap

结果集映射

代码语言：javascript复制
id name pwd
id name password
代码语言：javascript复制
<!--结果集映射-->
    <resultMap id="UserMap" type="User">
        <!--column数据库中的字段，property实体类中的属性-->
        <result column="    id" property="id"/>
        <result column="name" property="name"/>
        <result column="pwd" property="password"/>
    </resultMap>
    <select id="getUserById" resultMap="UserMap" parameterType="int">
       /*定义sql*/
       select * from mybatis.user where id = #{id};
   </select>
  • resultMap 元素是 MyBatis 中最重要最强大的元素
  • ResultMap 的设计思想是，对于简单的语句根本不需要配置显式的结果映射，而对于复杂一点的语句只需要描述它们的关系就行了。
  • ResultMap 最优秀的地方在于，虽然你已经对它相当了解了，但是根本就不需要显式地用到他们。
  • 如果世界总是这么简单就好了。

学习于哔哩哔哩视频 狂神

mybatis java 云数据库SQLServer jdbc sql

0 人点赞