保姆式Mybatis环境搭建教学——操作数据库

1.创建maven-webapp项目（IDEA2022.2.3版本）

• 创建如下文件目录结构：

说明：

        1.pojo包下就是存放所有的实体类，以后如果还有其他实体类（比如User实体类）都存放在这pojo包下。

        2.mapper包就是存放所有实体类对应的接口，可以以实体类类名+"Mapper"接口命名。

        3.util包下的SqlSessionFactoryUtils就是用来创建操作数据库的工厂类。

其中： 

• Brand类中内容(必须提供set和get方法，toString方法根据自己需要写)如下：

package com.pack.pojo;

public class Brand {
    private int id; //数据库主键id,设置自增
    private String brandName; //品牌名称
    private String companyName; //公司名称
    private int ordered; //排序
    private String description;
    private int status;

    public int getId() {
        return id;
    }

    public String getBrandName() {
        return brandName;
    }

    public String getCompanyName() {
        return companyName;
    }

    public int getOrdered() {
        return ordered;
    }

    public String getDescription() {
        return description;
    }

    public int getStatus() {
        return status;
    }

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

    public void setBrandName(String brandName) {
        this.brandName = brandName;
    }

    public void setCompanyName(String companyName) {
        this.companyName = companyName;
    }

    public void setOrdered(int ordered) {
        this.ordered = ordered;
    }

    public void setDescription(String description) {
        this.description = description;
    }

    public void setStatus(int status) {
        this.status = status;
    }

    @Override
    public String toString() {
        return "Brand{" +
                "id=" + id +
                ", brandName='" + brandName + '\'' +
                ", companyName='" + companyName + '\'' +
                ", ordered=" + ordered +
                ", description='" + description + '\'' +
                ", status=" + status +
                '}';
    }
}

•  SqlSessionFactoryUtils类中内容如下：

package com.pack.util;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

public class SqlSessionFactoryUtils {

    private static SqlSessionFactory sqlSessionFactory;

    static {
        //静态代码块会随着类的加载而自动执行，且只执行一次
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    public static SqlSessionFactory getSqlSessionFactory(){
        return sqlSessionFactory;
    }
}

2.在项目的pom.xml文件中配置依赖信息

<!--MyBatis-->
<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis</artifactId>
  <version>3.5.5</version>
</dependency>

<!--MySQL驱动-->
<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>5.1.34</version>
</dependency>

3.在Navicat中创建数据库db1

随后点击菜单栏中的“查询”-“新建查询”，接着复制以下Sql语句到里面，Ctrl+A全选，最后点击“运行已选择的”。

-- 删除tb_brand表
drop table if exists tb_brand;
-- 创建tb_brand表
create table tb_brand
(
    -- id 主键
    id           int primary key auto_increment,
    -- 品牌名称
    brand_name   varchar(20),
    -- 企业名称
    company_name varchar(20),
    -- 排序字段
    ordered      int,
    -- 描述信息
    description  varchar(100),
    -- 状态：0：禁用  1：启用
    status       int
);
-- 添加数据
insert into tb_brand (brand_name, company_name, ordered, description, status)
values ('三只松鼠', '三只松鼠股份有限公司', 5, '好吃不上火', 0),
       ('华为', '华为技术有限公司', 100, '华为致力于把数字世界带入每个人、每个家庭、每个组织，构建万物互联的智能世界', 1),
       ('小米', '小米科技有限公司', 50, 'are you ok', 1);

这样数据库db1中就创建了tb_brand表，并且表中数据如下:

4.编写Mybatis核心配置文件

可参考mybatis官网全面学习

https://mybatis.org/mybatis-3/zh/getting-started.html

1）在resources包下创建文件mybatis-config.xml，文件内容如下：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "https://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.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql:///db1?useSSL=false"/> <!---->
                <property name="username" value="root"/> <!--这里配置要操作的数据库账号 这里为root-->
                <property name="password" value="1234"/> <!--这里配置要操作的数据库密码 这里为1234-->
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <!--这里使用包扫描加载Sql映射文件 一劳永逸 以后所有mapper文件放在此路径下都能被扫描-->
        <!--路径为mapper包的路径，以.分隔-->
        <package name="com.pack.mapper"/>
    </mappers>
</configuration>

 2）右击resources包，选择“新建”-“目录”

新建目录内容为java包下的mapper包路径，必须按以"/"分隔路径的格式填写，这里为"com/pack/mapper"

3）右击resource-com-pack-mapper，如何选择"新建"-"文件"创建对应java-com-pack-mapper包下接口的xml文件

当前这里有BrandMappr接口，就在该mapper包下创建以该接口命名的.xml文件，内容为"BrandMapper.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.pack.mapper.BrandMapper">
    <!--这里面就可以开始写操作数据库的Sql语句了-->
</mapper>

说明：这里namespace="com.pack.mapper.BrandMapper" 就是对应mapper包下具体的接口所在的路径，以.分隔。

这样，操作数据库的Mybatis基础环境就搭建好了，要访问及操作数据库写相应的Sql语句就好了了。

5.简单案例实操

实操之前，可以先安装好"MyBatisX"插件

1.注解方式访问与操作数据库(仅适合写简单的Sql语句时用)

定义方法(这里定义一个用来查询所有数据的方法)

并在方法上面添加@Select注解，注解里面写相应的Sql语句用来操作数据库。

说明:

• 这里使用注解@Select(注解方法还有@Delete,@Update,@Insert等)来操作数据库。
• 使用注解的好处就是不用在BrandMapper.xml里面写Sql语句里，直接在注解的圆括号里面写Sql语句。

测试

1)在main目录下创建如下二级目录

2)然后点击“文件”-“项目结构”,在该路径中选择test目录下的java目录，然后点击“测试”，最后点击“确定”。

随后创建TestSelectAll类

接着复制以下相应的内容到相应的类或接口中去

1）修改TestSeletAll类为如下：

import com.pack.mapper.BrandMapper;
import com.pack.pojo.Brand;
import com.pack.util.SqlSessionFactoryUtils;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;

import java.util.List;

public class TestSelectAll {
    public static void main(String[] args) {
        //下面两条语句为固定写法
        SqlSessionFactory sqlSessionFactory = SqlSessionFactoryUtils.getSqlSessionFactory();
        SqlSession sqlSession = sqlSessionFactory.openSession();

        BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);//以后要操作UserMapper就写UserMapper。class

        List<Brand> brands = mapper.selectAll(); //这里用自己定义的方法，当前用的是自己定义的查询所有数据的方法

        for (Brand brand : brands) {
            System.out.println(brand.toString()); //遍历自己查询处理的数据
        }

        //*下面两条也是固定固定写法
        sqlSession.commit();
        sqlSession.close();
    }
}

2）修改BrandMapper.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.pack.mapper.BrandMapper">
    <!--这里面就可以开始写操作数据库的Sql语句了-->
    
    <resultMap id="brandResultMap" type="com.pack.pojo.Brand">
        <!--property写实体类变量名 column写数据库表名-->
        <result property="brandName" column="brand_name"></result>
        <result property="companyName" column="company_name"></result>
    </resultMap>
</mapper>

这里修改的内容是添加了<resultMap></resultMap>标签进行映射，因为实体类和数据库表中字段名不相同

在Brand实体类中

在数据库表中

可以看到这里只是brandName和brand_name，companyName和company_name不相同，其他字段名都相同，所以在BrandMapper.xml文件需要写两条<result></result>分别进行映射。  

3）修改BrandMapper接口为如下：

package com.pack.mapper;

import com.pack.pojo.Brand;
import org.apache.ibatis.annotations.ResultMap;
import org.apache.ibatis.annotations.Select;

import java.util.List;

public interface BrandMapper {
    //定义查询所有数据的方法
    @ResultMap("brandResultMap")
    @Select("select * from tb_brand")
    List<Brand> selectAll();
}

这里的修改就是添加了映射注解@ResultMap("resultMap标签中的id")

引号里面的内容写BrandMapper.xml中<resultMap id=""> </resultMap>标签中的id

4） 运行TestSelectAll，结果如下

2.常规方式访问与操作数据库

定义方法(这里定义了根据id和状态进行删除的方法)

当参数大于1时，需要为每个参数添加@Param注解

然后将光标移到方法名，按alt+enter，选择"Generate statement“(因为安装了MybatisX插件，所以有该选项),随后选择"Delete Statement"

书写Sql语句

对于使用了@Param注解,就需要中#{}来取方法中的@Param所对应的变量值。

建议sql语句用以下标签的方式书写，能避免一些空值和语句拼接问题

测试

在TestSelectAll类中运行

执行成功，删除了id为3，status为1的一条数据