MyBatis学习(一)

实验环境：

• JDK1.8
• MySQL5.7
• Maven3.6.1
• IDEA

回顾：

• JDBC
• MySQL
• Java基础
• Maven
• Junit

MyBatis3官方中文文档

1.简介

1.1 什么是MyBatis

• MyBatis 是一款优秀的持久层框架
• 它支持定制化 SQL、存储过程以及高级映射。
• MyBatis 避免了几乎所有的 JDBC代码和手动设置参数以及获取结果集。
• MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型、接口和 Java 的POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。
• MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。

如何获取MyBatis?

• github地址：

https://github.com/search?utf8=%E2%9C%93&q=mybatis&type=

• maven仓库：

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

• 中文文档：

https://mybatis.org/mybatis-3/zh/index.html

1.2 什么是持久化

数据持久化：

• 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
• 内存：断电即失
• 数据库(jdbc),io文件持久化。
• 生活：冷藏。罐头。

为什么需要持久化？

• 有一些对象，不能让他丢掉。
• 内存太贵了

1.3 持久层

Dao层，Service层，Controller层…

• 完成持久化的代码块
• 层界限十分明显

1.4 为什么需要MyBatis?

• 帮助程序员将数据存入到数据库中

• 方便

• 传统的JDBC代码太复杂了。简化。框架。自动化。

• 不用 MyBatis 也可以。更容易上手。技术没有高低之分

• 优点：

  • 简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
  • 灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。

• 解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。

  • 提供映射标签，支持对象与数据库的orm字段关系映射
  • 提供对象关系映射标签，支持对象关系组建维护
  • 提供xml标签，支持编写动态sql

最重要一点：使用的人多！

---

2. 第一个MyBatis程序

项目结构：

思路：搭建环境—>导入MyBatis—>编写代码—>测试！

2.1 搭建环境

2.1.1 新建数据库

CREATE DATABASE `mybatis`;

USE `mybatis`;

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

INSERT INTO `user` (`id`,`name`,`password`) VALUES
(1,'林仔1号','123456'),
(2,'林仔2号','123456'),
(3,'林仔3号','123456'),
(4,'林仔4号','123456'),
(5,'林仔5号','123456')

新建项目(maven)

1. 新建一个普通的Maven项目
   
   

2.1.2 删除src目录，将此项目作为父工程

2.1.3 导入依赖

在pom.xml文件中添加如下依赖：

<!--导入依赖-->
<dependencies>
    <!--mysql驱动-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.46</version>
    </dependency>
    <!--mybatis-->
    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.3</version>
    </dependency>
    <!--junit-->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
    <dependency>
       	<groupId>org.projectlombok</groupId>
       	<artifactId>lombok</artifactId>
       	<version>1.16.18</version>
   	</dependency>

</dependencies>

2.2 在此项目的基础上创建一个model

• 编写Mybatis的核心配置文件
  在resources目录下新建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：核心配置文件-->
<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://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="*******"/>
            </dataSource>
        </environment>
    </environments>

</configuration>

• 编写Mybatis工具类

package com.lzcu.utils;


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;

//sqlSessionFactory
public class MyBatisUtils {
	private static SqlSessionFactory sqlSessionFactory;

	static {
		try {
			//使用Mybatis第一步：获取sqlSessionFactory
			String resource = "mybatis-config.xml";
			InputStream inputStream = Resources.getResourceAsStream(resource);
			sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

	//既然有了 SqlSessionFactory，顾名思义，我们就可以从中获得 SqlSession 的实例了。
	// SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。
	public static SqlSession getSqlSession(){
		return sqlSessionFactory.openSession();
	}
}

2.3 编写代码

• 实体类

package com.lzcu.pojo;


import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
	private int id;
	private String name;
	private String password;
}

• Dao接口

package com.lzcu.dao;

import com.lzcu.pojo.User;

import java.util.List;

public interface UserDao {
	List<User> getUserList();
}

• 接口实现类:由原来的UserDaoImpl转变为一个Mapper配置文件,在com.lzcu.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">
<!--namespace=绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.lzcu.dao.UserDao">
    <select id="getUserList" resultType="com.lzcu.pojo.User">
        select * from mybatis.user
    </select>
</mapper>

2.4 测试

junit测试：

package com.lzcu.dao;

import com.lzcu.pojo.User;
import com.lzcu.utils.MyBatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;


public class UserDaoTest {

	@Test
	public void test(){
		//第一步，获取SqlSession对象
		SqlSession sqlSession = MyBatisUtils.getSqlSession();

		//执行SQL：方式 1：
		UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
		List<User> userList = userMapper.getUserList();
		for (User user : userList) {
			System.out.println(user);
		}
		//关闭SqlSession
		sqlSession.close();
	}
}

测试结果：

遇见错误1：

org.apache.ibatis.binding.BindingException: Type interface com.lzcu.dao.UserDao is not known to the MapperRegistry.

解决方案：
在resource目录下mybatis-config.xml文件中的configuration中添加以下代码：

<!--每一个Mapper.xml都需要在MyBatis核心配置文件中注册-->
<mappers>
    <!--所有的路径以斜杠结尾-->
    <mapper resource="com/lzcu/dao/UserMapper.xml"/>
</mappers>

遇见错误2：
出现文件UserMapper.xml找不到的错误
解决方案：
在pom.xml文件中添加如下代码：

<!--在build中配置resources，来防止我们资源导出失败的问题-->
<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

---

3. CRUD

crud是指在做计算处理时的增加(Create)、读取(Retrieve)、更新(Update)和删除(Delete)几个单词的首字母简写。crud主要被用在描述软件系统中数据库或者持久层的基本操作功能。

3.1 namespace

namespace中的包名和Dao/Mapper中的接口名一致！

3.2 select

选择，查询语句；

• id: 就是对应的namespace中的方法名；
• resultType: SQL语句执行的返回值！
• parameterType:参数类型

1. 编写接口

//根据id查询用户
User getUserById(int id);

2. 编写对应的mapper中的sql语句

<select id="getUserById" resultType="com.lzcu.pojo.User" parameterType="int">
    select * from mybatis.user where id = #{id}
</select>

3. 测试

@Test
public void getUserById(){
	SqlSession sqlSession = MyBatisUtils.getSqlSession();
	UserMapper mapper = sqlSession.getMapper(UserMapper.class);
	User user = mapper.getUserById(1);
	System.out.println(user);
	sqlSession.close();
}

3.3 insert

1. 编写接口

//insert一个用户
int addUser(User user);

2. 编写对应的mapper中的sql语句

<insert id="addUser" parameterType="com.lzcu.pojo.User">
    insert into mybatis.user (id, name, password) values (#{id},#{name},#{password})
</insert>

3. 测试

@Test
public void addUser(){
	SqlSession sqlSession = MyBatisUtils.getSqlSession();
	UserMapper mapper = sqlSession.getMapper(UserMapper.class);
	int res = mapper.addUser(new User(6, "林仔6号", "123456"));
	if (res>0){
		System.out.println("插入成功！");
	}
	//提交事务
	sqlSession.commit();
	sqlSession.close();
}

3.4 update

1. 编写接口

//修改一个用户
int updateUserById(User user);

2. 编写对应的mapper中的sql语句

<update id="updateUserById" parameterType="com.lzcu.pojo.User">
    update mybatis.user set name =#{name},password=#{password} where id= #{id}
</update>

3. 测试

@Test
public void updateUserById(){
	SqlSession sqlSession = MyBatisUtils.getSqlSession();
	UserMapper mapper = sqlSession.getMapper(UserMapper.class);
	int res = mapper.updateUserById(new User(4, "林仔4号", "1234567"));
	sqlSession.commit();
	sqlSession.close();
}

3.5 delete

1. 编写接口

//删除一个用户
int deleteUserById(int id);

2. 编写对应的mapper中的sql语句

<delete id="deleteUserById" parameterType="int">
    delete from mybatis.user where id=#{id}
</delete>

3. 测试

@Test
public void deleteUserById(){
	SqlSession sqlSession = MyBatisUtils.getSqlSession();
	UserMapper mapper = sqlSession.getMapper(UserMapper.class);
	int i = mapper.deleteUserById(4);
	sqlSession.commit();
	sqlSession.close();
}

注意点：增删改查需要提交事务

---

4.万能Map 以及 模糊查询

Map的使用

假设，我们的实体类，或者数据库中的表，字段或者参数过多，我们应当使用Map!

1. 编写接口

//万能的map
int addUser2(Map<String,Object> map);

2. 编写对应的mapper中的sql语句

<insert id="addUser2" parameterType="map">
    insert into mybatis.user (id, name, password) values (#{userid},#{username},#{PassWord})
</insert>

3. 测试

@Test
public void addUser2(){
	SqlSession sqlSession = MyBatisUtils.getSqlSession();
	UserMapper mapper = sqlSession.getMapper(UserMapper.class);
	Map<String, Object> map = new HashMap<String, Object>();
	map.put("userid",7);
	map.put("username","hello");
	map.put("PassWord","123456");
	int i = mapper.addUser2(map);
	sqlSession.commit();
	sqlSession.close();
}

Map传递参数，直接在SQL中取出key即可！ parameterType=“map”
对象传递参数，直接在sql中取对象的属性即可！
只有一个基本类型的参数的情况下，可以直接在sql中找到！
多个参数用Map,或者注解

模糊查询

模糊查询怎么写？

• java代码执行的时候,传递通配符%%
• 在SQL拼接中使用通配符

1. 编写接口

//模糊查询
List<User> getUserLike(String value);

2. 编写对应的mapper中的sql语句

<select id="getUserLike" resultType="com.lzcu.pojo.User">
    select * from mybatis.user where name like "%"#{value}"%";
</select>

3. 测试

@Test
public void getUserLike(){
	SqlSession sqlSession = MyBatisUtils.getSqlSession();
	UserMapper mapper = sqlSession.getMapper(UserMapper.class);
	List<User> list = mapper.getUserLike("林");
	for (User user : list) {
		System.out.println(user);
	}
	sqlSession.close();
}