Java框架--MyBatis(一)

最新推荐文章于 2025-03-24 21:23:52 发布

原创最新推荐文章于 2025-03-24 21:23:52 发布 · 173 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#MyBatis

Mybatis 专栏收录该内容

2 篇文章

订阅专栏

MyBatis

1.什么是Mybatis？

如何找到mybatis？

mybatis原来不叫mybatis ， ibatis1、2；

mybatis3。被托管在github上。

github地址：https://github.com/mybatis/mybatis-3

MyBatis 是一款优秀的持久层框架

MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型、接口和 Java 的 POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

什么是持久层

持久态和瞬时态

持久化就是数据在瞬时状态和持久状态之间转化的一个过程。

内存：断电即失。 我们现在无法用技术层面来保存，内存不会断电；

将内存中的数据持久化的存储；磁盘，硬盘，等等；

持久层对应我们代码架构的哪一层：—Dao层

dao层，专注于处理数据库的操作，但是我们写一大堆JDBC的重复代码。

我们应该专注sql语句编写，获得sql的返回值即可。

持久层为什么不叫持久化模块。

我们的系统中，应该有一个单独的层面来处理这个数据库连接问题；

解耦，这个层面就应该有较为清晰的逻辑边界；

为什么需要这个框架

hibernate 全自动的ORM框架，不用编写sql语句； 黑箱操作

SSH ： Spring 、 Struct 1/2 、hibernate

mybatis 半自动的ORM框架，我们可以自定义sql语句；更加灵活； 白箱操作

所有sql语句都由我们开发人员来编写，能够定制化完成许多功能。

要求开发人员要掌握SQL语句的编写；

SSM ：Spring 、SpingMVC、MyBatis.

MyBatis的优点

不用再去编写一堆JDBC代码
简单易学，不依赖第三方的程序或者框架。官网文档强大，开源，我们可以随时分析源码’；
实现解耦，低耦合，高内聚
ORM；对象关系映射
提供XML标签；
…

2.第一个Mybatis程序

1.搭建实验环境

CREATE DATABASE /*!32312 IF NOT EXISTS*/`mybatis` /*!40100 DEFAULT CHARACTER SET utf8 */;

USE `mybatis`;

DROP TABLE IF EXISTS `user`;

CREATE TABLE `user` (
  `id` INT(20) NOT NULL,
  `name` VARCHAR(30) DEFAULT NULL,
  `pwd` VARCHAR(30) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT  INTO `user`(`id`,`name`,`pwd`) VALUES (1,'狂神','123456'),(2,'张三','abcdef'),(3,'李四','987654');

2.创建项目

创建一个普通的Maven项目

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.tulun</groupId>
    <artifactId>mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>

        <!--单元测试-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
        </dependency>

        <!--mybatis的包-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.1</version>
        </dependency>

        <!--连接数据库的驱动包-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>

    </dependencies>


    <build>
        <!--希望maven在导出项目的时候,能够将我们的配置及资源导出-->
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>

    </build>



</project>

3.编写代码

1.先创建pojo实体类

package com.tulun.domain;

public class User{
    private Integer id;
    private String name;
    private String pwd;

    public User(){}

    public User(Integer id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer 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.编写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>
    <!--配置环境，这里可以有多套环境 default代表默认的是那一套-->
    <environments default="mysql">
        <!--配置一套环境 id .环境的名字-->
        <environment id="mysql">
            <!--transactionManager:事务管理，type:jdbc-->
            <transactionManager type="JDBC"/>
            <!--dataSource 数据源-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <!--xml中不允许&符号直接出现，我们需要使用 &amp; 代替-->
                <!--mysql8.0版本中，没有了安全连接，所以，如果mysql是8.0版本的useSSL=false-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;charsetEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

3.创建工具类

目的：获得SqlSessionFactory；

package com.tulun.tools;

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;

//mybatis的工具类，重复的代码的提纯
public class MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;
    private static InputStream in;
    static {
        //在maven中，所有的资源文件一般都放在resources目录下，我们可以直接拿到。
        try {
            //创建SqlSessionFactory工厂
            SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
            in = Resources.getResourceAsStream("MybatisConfig.xml");
            sqlSessionFactory = builder.build(in);
        } catch (IOException e) {
            e.printStackTrace();
        }

    }

    //设置SqlSessionFactory公共的方法
    public static SqlSessionFactory getSqlSessionFactory(){
        return sqlSessionFactory;
    }
    
}

4.映射文件的接口，对应原来的dao接口

package com.tulun.dao;

import com.tulun.domain.User;

import java.util.List;


public interface IUserDao {
    /*查询所有操作*/
    List<User> listAll();
 }

5.编写对应的mapper映射文件

<?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.tulun.dao.IUserDao">
    <!--select标签的id对应映射接口的方法名字  resultType:返回结果的类型  中间就编写sql语句-->
    <select id="listAll" resultType="com.tulun.domain.User">
        select * from user
    </select>

</mapper>

6.在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>
    <!--配置环境，这里可以有多套环境 default代表默认的是那一套-->
    <environments default="mysql">
        <!--配置一套环境 id .环境的名字-->
        <environment id="mysql">
            <!--transactionManager:事务管理，type:jdbc-->
            <transactionManager type="JDBC"/>
            <!--dataSource 数据源-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <!--xml中不允许&符号直接出现，我们需要使用 &amp; 代替-->
                <!--mysql8.0版本中，没有了安全连接，所以，如果mysql是8.0版本的useSSL=false-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;charsetEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>

    <!--关联映射文件-->
   <!-- 指定映射配置文件的位置，映射配置文件指的是每个DAO独立的配置文件 -->
    <mappers>
        <mapper resource="com/tulun/dao/IUserDao.xml"/>
    </mappers>

</configuration>

4.测试一下

在maven的test文件夹下编写对应的测试类

package com.tulun.test;

import com.tulun.dao.IUserDao;
import com.tulun.domain.User;
import com.tulun.tools.MyBatisUtil;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.junit.Test;

import java.util.HashMap;
import java.util.List;
import java.util.Map;


import java.util.List;

public class UserMapperTest {
    @Test
    public void selectUser(){

        //1.拿到sqlSessionFactory对象
       SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
        //2.使用工厂生产SqlSession对象
        SqlSession session = sqlSessionFactory.openSession();
        //3.使用SqlSession创建Dao接口的代理对象
        IUserDao userDao = session.getMapper(IUserDao.class);
        //4.使用代理对象执行方法
        List<User> users = userDao.listAll();
        for (User user:users) {
            System.out.println(user);
        }
    }
}

5.结果展示

在这里插入图片描述

6.项目结构

在这里插入图片描述

3.CRUD操作

增删改查

Mapper接口本质就是原来的Dao接口，只是为了方便我们的书写。一个mapper接口对应一个mapper映射文件。

将UserMapper更名为UserDao，说明本质

修改对应的mapper映射文件的namespace属性，对应上接口。

编写接口

package com.tulun.dao;

import com.tulun.domain.User;

import java.util.List;

public interface IUserDao {
    /*查询所有操作*/
    List<User> listAll();
    //根据id查询用户
    User getUserById(int id);
    //增加一个用户
    int add(User user);
    //根据id删除一个用户
    int deleteUserById(int id);
    //更改用户信息
    int update(User user);
}

对应的mapper语句编写

<?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.tulun.dao.IUserDao">
    <!-- 配置查询所有 id为Dao类中的方法名称 -->
    <select id="listAll" resultType="com.tulun.domain.User">
        select * from user
    </select>

    <select id="getUserById" resultType="com.tulun.domain.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    <!--如果返回值是基本数据类型，可以不写-->
    <insert id="add">
        INSERT INTO user (id,name,pwd) VALUES (#{id},#{name},#{pwd})
    </insert>

    <delete id="deleteUserById">
        DELETE FROM user WHERE id = #{id}
    </delete>

    <update id="update">
        UPDATE user SET name = #{name},pwd = #{pwd} WHERE id = #{id}
    </update>

    <select id="listUserLimeit" parameterType="Map" resultType="user">
        SELECT * FROM user limit #{startIndex},#{pageSize}
    </select>

</mapper>

测试类

package com.tulun.test;

import com.tulun.dao.IUserDao;
import com.tulun.domain.User;
import com.tulun.tools.MyBatisUtil;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {
    @Test
    public void listAll() {

        //1.拿到sqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = MyBatisUtils.getSqlSessionFactory();
        //2.通过sqlSessionFactory对象openSession()创建一个sqlSession。
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //3.通过sqlSession获得mapper对象 ， 参数为映射文件对应的接口类的class对象
        UserDao mapper = sqlSession.getMapper(IUserDao.class);
        //4.通过mapper对象来执行操作；
        List<User> users = mapper.listAll();

        //获得结果集
        for (User user : users) {
            System.out.println(user);
        }

        sqlSession.close(); //关闭sqlSession

    }


    @Test
    public void selectUserById(){
        SqlSessionFactory sqlSessionFactory = MyBatisUtils.getSqlSessionFactory();
        SqlSession sqlSession = sqlSessionFactory.openSession();
        UserDao mapper = sqlSession.getMapper(IUserDao.class);
        //接口  对象名  = new  接口实现类
        User user = mapper.getUserById(1);
        System.out.println(user);

        sqlSession.close(); //关闭sqlSession
    }

    @Test
    public void addUser(){
        User user = new User(4,"qinjiang","123456");

        SqlSessionFactory sqlSessionFactory = MyBatisUtils.getSqlSessionFactory();
        SqlSession sqlSession = sqlSessionFactory.openSession();
        UserDao mapper = sqlSession.getMapper(IUserDao.class);

        int i = mapper.add(user);

        //没有插入成功的原因：没有提交事务；
        sqlSession.commit(); //提交事务
        sqlSession.close(); //关闭sqlSession

        if (i>0){
            System.out.println("插入成功！");
        }

    }

    @Test
    public void deleteUserByID(){
        SqlSession sqlSession = MyBatisUtils.getSqlSessionFactory().openSession();
        UserDao mapper = sqlSession.getMapper(IUserDao.class);
        int i = mapper.deleteUserById(4);

        //记得提交事务，否则删除不成功！
        sqlSession.commit();//提交事务
        sqlSession.close();//关闭

        if (i>0){
            System.out.println(i);
        }
    }

    @Test
    public void updateUser(){
        SqlSession sqlSession = MyBatisUtils.getSqlSessionFactory().openSession();
        UserDao mapper = sqlSession.getMapper(IUserDao.class);
        User user = new User(1,"秦疆","qinjiang");
        mapper.update(user);

        sqlSession.commit();
        sqlSession.close();

    }


}

总结CRUD注意点

1、事务

增，改，删需要提交事务！

2、乱码

如果出现乱码，先在sql中进行测试，sql没问题，就检查配置文件

//mysql8.0以上版本useSSL=false！！！
"jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=utf-8"

3、参数问题

如果是基本数据类型，可以省略，但建议写上

引用类型必须写指定的包名+类名。