Mybatis

Mybatis

不与夏虫语冰，不与井蛙语海，不与凡夫语道

1 简介

• 官方网站

1.1 定义

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

1.1.1 背景

MyBatis本是apache的一个开源项目iBatis，2010年这个项目由apache software foundation迁移到了google code,并且改名为MyBatis。2013年11月迁移到Github

1.1.2 为什么使用

• 框架，自动化
• 方便存入数据库
• 技术没有高低之分
• 用的人多，有生态
• 优点

简单易学、灵活、解除sql与程序代码的耦合、提供映射标签、提供对象关系映射标签、提供xml标签

1.1.3 获取方式

• Github
• maven仓库

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.4.6</version>
</dependency>

1.2 持久化

数据持久化就是将内存中的数据模型转换为存储模型,以及将存储模型转换为内存中的数据模型的统称. 数据模型可以是任何数据结构或对象模型,存储模型可以是关系模型、XML、二进制流等。cmp和Hibernate只是对象模型到关系模型之间转换的不同实现。

1.2.1 优点

• 程序代码重用性强
• 业务逻辑代码可读性强
• 持久化技术可以自动优化，数据持久化对象的基本操作有：保存、更新、删除、查询等。

1.3 持久层

数据持久层位于领域层和基础架构层之间。由于对象范例和关系范例这两大领域之间存在“阻抗不匹配”，所以把数据持久层单独作为J2EE体系的一个层提出来的原因就是能够在对象－关系数据库之间提供一个成功的企业级映射解决方案，尽最大可能弥补这两种范例之间的差异。

• 数据持久化的代码块
• 通用的持久化

2 第一个Mybatis

搭建环境-导入包-编写代码-测试

2.1 创建一个数据库的表

create database xhr;
use xhr;
create table if not exists t_admin(
	user_id int(6) not null auto_increment COMMENT '用户ID',
	dept_id int(3) comment '部门ID',
	login_name varchar(50) DEFAULT '' comment '登录账号',
	user_name varchar(50) DEFAULT '' comment '用户名',
	email varchar(50) DEFAULT '' comment '用户邮箱',
	phone varchar(30) DEFAULT '' comment '用户手机号码',
	password varchar(50) DEFAULT '1' comment '用户密码',
	user_type varchar(2) DEFAULT 'N' comment '类型',
	user_state int(1) DEFAULT 0 comment '帐号状态',
	create_by varchar(50) DEFAULT '' comment '创建者',
	create_time timestamp DEFAULT CURRENT_TIMESTAMP comment '创建时间',
	update_by varchar(50) DEFAULT '' comment '更新者',
	update_time timestamp default CURRENT_TIMESTAMP comment '更新时间',
	primary key(user_id)
)ENGINE = INNODB AUTO_INCREMENT=000001 default charset=utf8mb4;

2.2 新建项目

2.2.1 步骤

• 普通的Maven项目
• 删除src
• 导入maven依赖

<?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>cn.xxy</groupId>
    <artifactId>mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <mybatis.version>3.2.6</mybatis.version>
        <mysql.version>5.1.30</mysql.version>
        <junit.version>4.12</junit.version>
    </properties>
    <!--导入依赖-->
    <dependencies>
        <!--mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>${mysql.version}</version>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>${mybatis.version}</version>
        </dependency>
            <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
        </dependency>
    </dependencies>
</project>

• 创建一个模块
• 编写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>
    <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://127.0.0.1:3306/temp1?useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

• 创建entity

package cn.xxy.entity;

/**
 * @author xxy
 */
public class User {
   
    private String id;
    private String name;
    private int age;

    public User() {
   
    }

    public User(String id,String name,int age) {
   
        this.id = id;
        this.name = name;
        this.age = age;
    }

    public String getId() {
   
        return id;
    }

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

    public String getName() {
   
        return name;
    }

    public void setName(String name) {
   
        this.name = name;
    }

    public int getAge() {
   
        return age;
    }

    public void setAge(int age) {
   
        this.age = age;
    }
}

• 创建mapper

package cn.xxy.mapper;

import cn.xxy.entity.User;

import java.util.List;

/**
 * @author xxy
 */
public interface UserMapper {
   
    /**
     * 查询搜所有用户
     * @return
     */
    List<User> selectAllUser();
}

<?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="cn.xxy.mapper.UserMapper">

    <select id="selectAllUser" resultType="User">
    select * from user
  </select>
</mapper>

• 测试

package cn.xxy.mappertest;

import cn.xxy.entity.User;
import cn.xxy.mapper.UserMapper;
import cn.xxy.utils.MybatisUtil;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class usertest {
   
    @Test
    public void testUser() {
   
        //获取sqlsession
        SqlSession sqlSession = MybatisUtil.getSqlSession();
        //方式一：getMapper
/*        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        List<User> userList = userMapper.selectAllUser();
        for (User user : userList) {
            System.out.println(user.toString());
        }*/
//方式二：
        List<User> userList = sqlSession.selectList("cn.xxy.mapper.UserMapper.selectAllUser");
        for (User user : userList) {
   
            System.out.println(user.toString());
        }
        //关闭sqlsession
        sqlSession.close();
    }
}

• 可能出现的问题

• 资源访问不到

    <build>
        <!-- 如果不添加此节点mybatis的mapper.xml文件都会被漏掉。 -->
        <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