Mybatis框架学习——我的第一个Mybatis程序

Posted RAIN 7

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Mybatis框架学习——我的第一个Mybatis程序相关的知识,希望对你有一定的参考价值。

文章目录

第一个Mybatis程序

万事开头难,迈过这道坎,一切都简单!

第一个Mybatis程序一定要好好的理解执行编写代码的过程

刚开始接触一定要跟着Mybatis的官方文档入门学习,同时先不要想mybatis 和 spring的整合啥的,咱就先把mybatis单独拿出来,学习他的使用。


mybatis官方文档

https://mybatis.net.cn/


什么是Mybatis?


  咱就用自己的话说吧,学过JDBC吧,Mybatis就是JDBC的升级,是一个操作数据库的框架。jdbc繁琐的代码都不用写了,只需要写接口和对应xml文件的映射就解决了 Java代码操作数据库的操作。


(0) 搭建数据库


创建一个数据库,在该数据库中建表,并插入一条语句


create database if not exists mybatis;

use mybatis;

drop table if exists user;

create table user(
    id int primary key auto_increment,
    name varchar(30),
    pwd varchar(30)
);

insert into user values(null,"RAIN7","123456");




(1)安装Mybatis


如果使用Maven搭建项目,在pom.xml中导入 Mybatis的依赖即可,别忘记也导入数据库mysql的依赖

Mysql 8.0

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.28</version>
        </dependency>

Mybatis

        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>

(2)创建 myabtis配置核心文件


创建mybatis-config的xml配置文件,作为mybatis的核心配置文件。

为啥要创建这个配置文件呢?


(1) 构建SqlSessionFactory


官方文档在这里已经说的很清楚了,我们来总结一下



每个mybatis应用都是基于SqlSessionFactory为核心的,我们要通过xml配置文件拿到 SqlSessionFory这个实例


官方文档还给了相关的代码,从配置文件中得到SqlSessionFactory实例的过程


(2)在配置文件中填入数据库连接的必要信息



  在项目中建一个xml文件作为mybatis的核心配置文件,一般以 mybatis-config.xml 命名,放在resource目录底下


<?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.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://127.0.0.1:3306/mybatis?useUnicode=true&amp;characterEncoding=utf-8&amp;serverTimezone=GMT"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/bit/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

(3)编写代码


在上述过程中已经搭好了基本的环境配置,我们开始写代码。


1.得到sqlSession对象


根据配置文件拿到SqlSessionFactory对象,在得到SqlSession对象(重要)

官方文档给了我们如何获得Sqlsession的代码


建一个util包,存放着MybatisUtil类专门获得SqlSession对象

package com.bit.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 
// 写一个工具类,获得 sqlSession 对象,sqlSession对象里面又处理数据库相关数据的方法
    // 1.先获得 sqlSessionFactory 对象,才能创建sqlSession对象
            // 加载项目中的mybatis核心配置,记得可以写相对/绝对路径都行
//            输入流读取配置文件信息
//            获得sqlSessionFactory对象

    private static SqlSessionFactory sqlSessionFactory;

    static
        try 
        
            String resource = "mybatis-config.xml";
// 输入流读取resource文件中的mybatis核心配置文件
            InputStream inputStream = Resources.getResourceAsStream(resource);
//通过SqlSessionFactoryBuild的build方法得到SqlSessionFactory对象
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
         catch (IOException e) 
            e.printStackTrace();
        
    

    public static SqlSession getSqlSession()
    // 参数如果没有的话,默认是关闭自动提交事务的
    // 参数如果设置为true的话,默认是自动提交事务的
       return sqlSessionFactory.openSession(true);
    



2.建实体类pojo


之后的操作数据库得创建一个实体类

普及一个概念 pojo(Plain Ordinary Java Object)

简单的java对象也就是我们所说的实体类,与数据库中表的信息相对应


一定要注意,属性的名字得和表中的字段一样(重要)

package com.bit.pojo;

public class User 
    private int id;
    private String name;
    private String pwd;

    public User(int id, String name, String pwd) 
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    
    @Override
    public String toString() 
        return "User" +
                "id=" + id +
                ", name='" + name + '\\'' +
                ", 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;
    


3.使用接口+xml的方式操作数据库


  接口就相当于以前dao层里面的具体对某个对象实现增删改查,这里我们写一个接口,接口里面只提供增上改查方法的定义,我们不做实现,具体的实现让xml去完成


建一个mapper包,里面放 接口和xmk配置文件

实现接口

接口通常以mapper命名,这里建一个UserMapper 接口

package com.bit.mapper;

import com.bit.pojo.User;

import java.util.List;

public interface UserMapper 
    // 查询所有用户
    List<User> getUserList();

实现xml的配置文件

建立UserMappper.xml配置文件,与UserMapper接口搭配使用

这个xml文件是针对于这个接口的,里面用各种标签以及标签里的属性来实现具体的方法。

namespace 写的接口的全限定名(包名+类名)

  查询语句用 select标签,id写的是接口里的方法名(注意不要写错),resultType写的是返回的类型(全限定名)

<?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.bit.mapper.UserMapper">

    <select id="getUserList" resultType="com.bit.pojo.User">
        select * from mybatis.user
    </select>

</mapper>

4.注册mapper信息(重要)

把mapper标签的信息注册到核心配置文件中的mappers里面

通过这种方式 把UserMapper.xml与 mybatis-config.xml联系起来

(4)代码测试

在test目录下进行测试,路径得相同

建一个类,在这个类中写测试方法测试代码进行操作数据库

    @Test
    public void test()
        //用工具类返回 执行数据库操作的 sqlSession 对象
        SqlSession sqlSession = MybatisUtil.getSqlSession();

        //我们Java是面向接口编程的,所以只获取到 UserMapper对象,执行里面的方法就行了
        // 但是UserMapper只是一个接口,里面的方法也没有具体的实现,所以用sqlSession.getMapper(),UserMapper与数据库就有了相关的联系
//        UserMapper就可以用 UserMappper.xml文件中的标签来实现方法

        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        List<User> user = userMapper.getUserList();
        for (User user1:user) 
            System.out.println(user1);
        

        // 记得关闭 资源
        sqlSession.close();
    

(5)异常问题处理

可能会因为各种问题导致查询失败,以下有几点很重要的问题

1.xml文件中不能加中文注释(很重要)

因为这个问题就会报各种莫名其妙的异常


2.配置文件没有注册,注册的时候一定要记住路径用/分开

在核心配置文件中配置 mappers


3.绑定接口错误

mappper配置文件中一定要找对对应的接口,namespace写全限定名,写的是对应的接口。


4.标签里id方法名错误、resultType类型错误、sql语句错误,全限定名


5.Maven导出文件资源失败(重要)

因为导出文件失败,导致找不到mappper.xml 的配置文件,报错。

maven可能因为过滤信息,导致xml文件无法导入,所以在pom.xml中加 代码允许文件资源过滤。

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

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

    </build>

6.mybatis-config 中的数据库配置url要写对,jdbc驱动也要写对,mysql5.7 和8.0 还是有区别的

jdbc Diver

mysql 5.6

com.mysql.jdbc.Driver

mysql 8.0

com.mysql.cj.jdbc.Driver

一个mybatis方法的流程

核心点

1.如果用户要使用接口,那么接口得与mybatis建立联系

UserMapper userMapper = sqlSesion.getMapper(UserMapper.class)

sqlSession又通过 SqlSessionFactory 得到的

sqlSessionFactory 是通过 sqlSessionFactoryBuild.build(inputStream) 得到的


2.mapper接口方法是由对应xml文件实现的,但是xml文件也得和mybatis核心配置建立联系

在mybatis-config中注册接口xml文件中的mapper信息

以上是关于Mybatis框架学习——我的第一个Mybatis程序的主要内容,如果未能解决你的问题,请参考以下文章

我的第一个MyBatis

Java学习的第八天:基础部分差最后一节,跳出直接学的mybatis

mybatis源码学习调试mybatis的第一个程序

intellij IDEA Mybatis入门案例

mybatis学习笔记-01

mybatis学习笔记-01