使用MyBatis框架搭建ORM映射

一、框架介绍

MyBatis是一个基于Java的持久层框架。其本是apache的一个名为iBatis的开源项目, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAOs）。

最新版本是MyBatis 3.5.3 ，其发布时间是2019年10月20日。

MyBatis的主要功能：

  • 它支持定制化 SQL、存储过程以及高级映射。
  • MyBatis 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。
  • MyBatis 使用简单的 XML或注解用于配置和原始映射，将接口和 Java 的POJOs（Plain Ordinary Java Objects，普通的 Java对象）映射成数据库中的记录。

MyBatis的整体架构：

MyBatis的整体架构-转载自鸟哥.png

知识拓展：
持久（Persistence），即把数据（如内存中的对象）保存到可永久保存的存储设备中（如磁盘）。
持久化的主要应用是将内存中的数据存储在关系型的数据库中，当然也可以存储在磁盘文件中、XML数据文件中等等。
持久层（Persistence Layer），即专注于实现数据持久化应用领域的某个特定系统的一个逻辑层面，将数据使用者和数据实体相关联。
对象关系映射（Object Relational Mapping，简称ORM）是通过使用描述对象和数据库之间映射的元数据，将面向对象语言程序中的对象自动持久化到关系数据库中。
因此，ORM的作用就是在关系型数据库和对象之间作一个映射，使得我们在具体的操作数据库的时候，就不需要再去和复杂的SQL语句打交道，只要像平时操作对象一样操作

二、MyBatis调用的一般步骤

  1. 配置mybatis-config.xml 全局的配置文件 (1、数据源，2、外部的mapper)
  2. 创建SqlSessionFactory
  3. 通过SqlSessionFactory创建SqlSession对象
  4. 通过SqlSession操作数据库 CRUD
  5. 调用session.commit()提交事务
  6. 调用session.close()关闭会话

三、SpringBoot中应用MyBatis

1.引入MyBatis的依赖

<!-- 数据库使用MySQL，所以需要引入MySQL的驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
<!-- MyBatis是基于JDBC基础上上二次封装的，因此依赖于JDBC -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
<!--引入包含MyBatis依赖的starter，把默认配置都设定好-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>1.3.2</version>
        </dependency>

2.项目配置文件：MyBatis框架的参数配置

spring.datasource.driverClassName=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8
spring.datasource.username=root
spring.datasource.password=root
mybatis.mapper-locations: classpath:mapper/*.xml

3.创建MySQL数据表

CREATE TABLE `t_customer` (
  `id` int(32) NOT NULL AUTO_INCREMENT,
  `name` varchar(32) NOT NULL,
  `realName` varchar(32) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;

4.创建实体类Customer

package com.zhbit.domain;

import org.springframework.stereotype.Component;
 
/**
 * @Author:xiao sir
 * @Date: 2019/11/21
 * @Time: 13:56
 */
@Component
public class Customer {
    private Integer id;
    private String name;
    private String realName;
 
    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 getRealName() {
        return realName;
    }
 
    public void setRealName(String realName) {
        this.realName = realName;
    }
 
    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name+ '\'' +
                ", realName='" + realName + '\'' +
                '}';
    }
}

5.创建CustomerController控制器

在与前端页面商量好，确定好后端需要提供什么功能后，根据RESTful的规则，双方列出HTTP通信的请求路径以及请求参数明细。从而明确CustomerController需要提供哪些功能。

package com.zhbit.controller;
 
import com.zhbit.domain.Customer;
import com.zhibt.service.ICustomerService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
 
/**
 * @Author:xiao sir
 * @Date: 2019/11/21 
 * @Time: 14:22
 */
 
@RestController
@RequestMapping("/customer")
public class CustomerController {
 
    @Autowired
    private ICustomerService customerService;

    @Autowired
    private Customer customer;

    //显示顾客
    @RequestMapping("get")
    public List<Customer> getCustomer() throws Exception {
        return customerService.getCustomer();
    }
    //删除顾客
    @RequestMapping("delete/{id}")
    public String deleteCustomer(@PathVariable int id) throws Exception {
        customerService.deleteCustomer(id);
        return "你已经删掉了id为"+id+"的顾客";
    }
    //增加顾客
    @RequestMapping("add")
    public String addCustomer() throws Exception {
        customer.setuserName("阿花");
        customer.setrealName("荷花");
        customerService.addCustomer(customer);
        return "增加顾客";
    }
}

6.业务逻辑接口ICustomerService

package com.zhbit.iservice;
import com.zhbit.domain.Customer;

import java.util.List;

public interface  ICustomerService {

    //显示所有客户
    public List<Customer> getCustomer() throws Exception;
    //根据id删除客户
    public void deleteCustomer(int id) throws Exception;
    //新增客户
    public void addCustomer(Customer customer) throws Exception;

}

7.实现业务逻辑CustomerServiceImp

package com.zhbit.serviceImp

import com.zhbit.dao.CustomerMapper;
import com.zhbit.domain.Customer;
import com.zhbit.iservice.ICustomerService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class CustomerServiceImpl implements ICustomerService {

    @Autowired
    private CustomerMapper customerMapper;


    @Override
    public List<Customer> getCustomer() throws Exception {
        return customerMapper.getCustomer();
    }

    @Override
    public void deleteCustomer(int id) throws Exception {
        customerMapper.deleteCustomer(id);
    }

    @Override
    public void addCustomer(Customer customer) throws Exception {
        customerMapper.addCustomer(customer);
    }
}

8.DAL数据访问层CustomerMapper

由于使用了ORM框架，原来dao层中需要使用JDBC实现的数据库访问，都通过MyBatis框架实现映射。因此，只需根据数据表的结构及类型，创建一个与数据库表一一对应的Mapper类，并通过一个同名的xml文件配置到MyBatis框架中，框架自动实现数据映射。

package com.zhbit.dao;

import com.zhbit.domain.Customer;
import org.apache.ibatis.annotations.Mapper;
import java.util.List;

@Mapper
public interface CustomerMapper {

    //获取用户名单
    public List<Customer> getCustomer() throws Exception;
    //根据id删除用户
    public void deleteCustomer(int id)throws Exception;
    //新增用户
    public void addCustomer(Customer customer)throws Exception;

}

（对应的CustomerMapper.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.zhbit.mapper.CustomerMapper">
 
    <resultMap id="BaseResultMap" type="com.zhbit.domain.Customer">
        <result column="id" jdbcType="INTEGER" property="id" />
        <result column="name" jdbcType="VARCHAR" property="name" />
        <result column="realName" jdbcType="VARCHAR" property="realName" />
    </resultMap>
 
    <select id="getCustomer" resultType="com.zbhit.domain.Customer">
        select * from t_customer
    </select>
    <delete id="deleteCustomer" parameterType="Integer">
        delete from t_customer where id =#{id}
    </delete>
    <insert id="addCustomer" parameterType="com.zhbit.domain.Customer">
        insert into t_customer(id,name,realName)values(#{id},#{name},#{realName})
    </insert>
</mapper>

注意：所有的Mapper文件都放在静态资源resources下的mapping文件夹中。

8.项目启动文件：加入扫描所有mapping文件的注解

package com.zhbit;
 
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
 
@MapperScan("com.zhbit.mapper") //扫描的mapper
@SpringBootApplication
public class DemoApplication {
 
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

建议：把启动文件移到com.zhbit命名空间下。

参考文献

  1. MyBatis官方文档
  2. MyBatis教程
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 216,496评论 6赞 501
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 92,407评论 3赞 392
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 162,632评论 0赞 353
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 58,180评论 1赞 292
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 67,198评论 6赞 388
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 51,165评论 1赞 299
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 40,052评论 3赞 418
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,910评论 0赞 274
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 45,324评论 1赞 310
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,542评论 2赞 332
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,711评论 1赞 348
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,424评论 5赞 343
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 41,017评论 3赞 326
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,668评论 0赞 22
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,823评论 1赞 269
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,722评论 2赞 368
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,611评论 2赞 353