Mybatis --01. 安装使用

最新推荐文章于 2025-07-04 11:54:52 发布

sswqzx

最新推荐文章于 2025-07-04 11:54:52 发布

阅读量3.9k

点赞数 8

CC 4.0 BY-SA版权

分类专栏： Mybatis 文章标签： Mybatis安装使用 Mybatis

本文链接：https://blog.youkuaiyun.com/sswqzx/article/details/83343559

Mybatis 专栏收录该内容

10 篇文章

订阅专栏

本文介绍MyBatis框架的基本概念、环境搭建、使用步骤及基于注解的配置方式，帮助初学者快速上手MyBatis，实现数据库操作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1、概述

说明：

    mybatis是一个优秀的基于java的持久层框架，它内部封装了jdbc，使开发者只需要关注sql语句本身，
而不需要花费精力去处理加载驱动、创建连接、创建statement等繁杂的过程。
     mybatis通过xml或注解的方式将要执行的各种statement配置起来，并通过java对象和statement中
sql的动态参数进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射为java对象并返回。
      采用ORM思想解决了实体和数据库映射的问题，对jdbc进行了封装，屏蔽了jdbc api底层访问细节，使我们不用与jdbc api打交道，
就可以完成对数据库的持久化操作。

简介:

Mybatis是一款优秀的持久层框架、它支持定制化SQL、存储过程及高级映射、Mybatis避免了几乎所有的JDBC代码和手动设置参数以及获取结果集、MyBatis可以使用简单的XML或注解来配置和映射原生信息、将接口和java的POJOS(plain old java objects )普通的java对象映射成数据库中的记录

下载：下载Mybatis包或在pom.xml配置坐标

下载地址：https://github.com/mybatis

或在pom.xml里加

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

2、搭建Mybatis开发环境

项目结构图：

2.1、创建Maven工程：如图

mybatis

2.2、添加Mybatis的坐标、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.sswblog</groupId>
    <artifactId>day1_mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        //加载mybatis坐标
        <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.6</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.12</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
        </dependency>
    </dependencies>

</project>

2.3、编写User实体类、com.sswblog.domain/User

package com.sswblog.domain;

import java.io.Serializable;
import java.util.Date;

public class User implements Serializable {
    private Integer id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    public String getAddress() {
        return address;
    }

    public void setAddress(String address) {
        this.address = address;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", birthday=" + birthday +
                ", sex='" + sex + '\'' +
                ", address='" + address + '\'' +
                '}';
    }
}

2.4、编写持久层接口com.sswblog.dao/IUserDao

package com.sswblog.dao;

import com.sswblog.domain.User;
import java.util.List;

public interface IUserDao {
    //用户持久层操作

    /*
    * 查询所有用户
    * */
    public abstract List<User> findAll();
}

2.5、编写持久层接口映射文件resources/com.sswblog.dao/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="com.sswblog.dao.IUserDao">
    <!--配置查询所有-->
    <select id="findAll" resultType="com.sswblog.domain.User">
      SELECT * FROM user
    </select>
</mapper>

2.6、编写配置文件resources/SqlConfig.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">
<!-- mybatis的主配置文件 -->
<configuration>
    <!-- 配置环境 -->
    <environments default="mysql">

        <!--配置mysql的环境-->
        <environment id="mysql">

            <!--配置事务的类型-->
            <transactionManager type="JDBC"></transactionManager>

            <!--配置数据源（连接池）-->
            <dataSource type="POOLED">

                <!--配置连接数据库的4个基本信息-->
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/day01_mybatis"/>
                <property name="username" value="root" />
                <property name="password" value="sswqzx" />
            </dataSource>
        </environment>
    </environments>
    <!--指定映射配置文件的位置、映射配置文件指的是每个dao独立的配置文件-->
    <mappers>
        <mapper resource="com.sswblog.dao/IUserDao.xml" />
    </mappers>
</configuration>

2.7、数据库配置

-- 创建库、表、并插入数据、如下图：
use day01_mybatis;

CREATE TABLE `user` (
  `id` int(11) NOT NULL auto_increment,
  `username` varchar(32) NOT NULL COMMENT '用户名称',
  `birthday` datetime default NULL COMMENT '生日',
  `sex` char(1) default NULL COMMENT '性别',
  `address` varchar(256) default NULL COMMENT '地址',
  PRIMARY KEY  (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

2.8、编写测试类 test/java/MybatisTest.java

import com.sswblog.dao.IUserDao;
import com.sswblog.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.InputStream;
import java.util.List;

public class MybatisTest {
    public static void main(String[] args) throws Exception {
        //1.读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlConfig.xml");
        //2.创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory factory = builder.build(in);
        //3.使用工厂生产SqlSession对象
        SqlSession session = factory.openSession();
        //4.使用SqlSession创建Dao接口的代理对象
        IUserDao userDao = session.getMapper(IUserDao.class);
        //5.使用代理对象执行方法
        List<User> users = userDao.findAll();
        for (User user : users) {
            System.out.println(user);
        }
        //6.释放资源
        session.close();
        in.close();
    }
}

小结：

通过快速入门示例，使用mybatis是非常容易的一件事情，因为只需要编写Dao接口并且按照mybatis要求编写两个配置文件，就可以实现功能。远比我们之前的jdbc方便多了。（我们使用注解之后，将变得更为简单，只需要编写一个mybatis配置文件就够了。）但是，这里面包含了许多细节，有工厂对象（SqlSessionFactory）,有了工厂之后还要有构建者对象（SqlSessionFactoryBuilder）等等。

==============我是华丽的分格线===============

也可以省略Service层和dao层

映射文件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">
<!--映射文件的作用：用来存放sql语句
    namespace:命名空间
-->
<mapper namespace="UserMapper">
    <!--select标签：表示一条查询的sql语句
        id属性：sql语句的唯一表示，在同一namespace下唯一，通过namespace+id的形式来调用sql语句
        resultType属性：查询语句的结果类型，此处写的是全路径名
        在select标签中写查询的sql语句：#{id}表示接收参数，如果只有一个参数，参数名随便写
    -->
    <select id="findUserById" resultType="com.sswblog.domain.User">
        select * from tb_user where id = #{id}
    </select>
</mapper>

mybatis主配置文件mybatis-config.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>
    <environments default="test">
        <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/mybatis"/>
                <!-- 指定用户名 -->
                <property name="username" value="root"/>
                <!-- 指定密码 -->
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="UserMapper.xml"></mapper>
    </mappers>
</configuration>

测试类

public class TestMyBatis {

    @Test
    public void test1() {
        SqlSession sqlSession = null;
        try {
            //加载mybatis核心配置文件
            InputStream in = Resources.getResourceAsStream("mybatis-config.xml");
            //创建SqlSessionFactory
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
            //获取SqlSession
            sqlSession = sqlSessionFactory.openSession();
            /*
            执行查询语句,selectOne参数解释：
            参数1：语句的唯一标识，由namespace+id组成
            参数2：语句需要的参数
             */
            User user = sqlSession.selectOne("UserMapper.findUserById", 1L);
            System.out.println(user);
        } catch (IOException e) {
            e.printStackTrace();
        }finally {
            //关闭sqlSession
            if(sqlSession != null){
                sqlSession.close();
            }
        }

    }
}

3、基于注解的mybatis使用

3.1、修改持久层接口中添加注解

package com.sswblog.dao;

import com.sswblog.domain.User;
import org.apache.ibatis.annotations.Select;

import java.util.List;

public interface IUserDao {
    //用户持久层操作

    /*
    * 查询所有用户
    * */
    @Select("select * from user")
    public abstract List<User> findAll();
}

3.2、修改SqlConfig.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">
<!-- mybatis的主配置文件 -->
<configuration>
    <!-- 配置环境 -->
    <environments default="mysql">

        <!--配置mysql的环境-->
        <environment id="mysql">

            <!--配置事务的类型-->
            <transactionManager type="JDBC"></transactionManager>

            <!--配置数据源（连接池）-->
            <dataSource type="POOLED">

                <!--配置连接数据库的4个基本信息-->
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/day01_mybatis"/>
                <property name="username" value="root" />
                <property name="password" value="sswqzx" />
            </dataSource>
        </environment>
    </environments>
    <!--指定映射配置文件的位置、映射配置文件指的是每个dao独立的配置文件-->
    <mappers>
        <!--<mapper resource="com.sswblog.dao/IUserDao.xml" />-->
        <mapper class="com.sswblog.dao.IUserDao"/>
    </mappers>
</configuration>

3.3、测试类

import com.sswblog.dao.IUserDao;
import com.sswblog.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.InputStream;
import java.util.List;

public class MybatisTest {
    public static void main(String[] args) throws Exception {
        //1.读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlConfig.xml");
        //2.创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory factory = builder.build(in);
        //3.使用工厂生产SqlSession对象
        SqlSession session = factory.openSession();
        //4.使用SqlSession创建Dao接口的代理对象
        IUserDao userDao = session.getMapper(IUserDao.class);
        //5.使用代理对象执行方法
        List<User> users = userDao.findAll();
        for (User user : users) {
            System.out.println(user);
        }
        //6.释放资源
        session.close();
        in.close();
    }
}