MyBatis之简介

一、简介

目录：什么是MyBatis、持久化和持久层、第一个MyBatis程序

1.什么是MyBatis？

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

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

②Github：https://github.com/mybatis/mybatis-3/releases
MyBatis中文文档：https://mybatis.org/mybatis-3/zh/index.html
3）为什么需要MyBatis？
帮助程序员将数据存入到数据库中。
方便
传统的JDBC代码太复杂，为了简化，实现自动化操作。
不用MyBatis也可以，但MyBatis更容易上手。
技术没有高低之分！
MyBatis的优点：
Ⅰ简单易学且灵活。
Ⅱsql和代码的分离，提高了可维护性。
Ⅲ提供映射标签，支持对象与数据库的orm字段关系映射。
Ⅳ提供对象关系映射标签，支持对象关系组建维护。
Ⅴ提供xml标签，支持编写动态sql。

2.持久化和持久层

1）持久化
①数据持久化
持久化就是将程序的数据在持久状态和瞬时状态转化的过程。
内存：断电即失。
数据库通过JDBC持久化，IO处理文件持久化。
②为什么需要持久化？
Ⅰ有一些对象，不能让它丢掉。
Ⅱ内存太贵。
2）持久层
①完成持久化工作的代码块。
②层界限十分明显。

3.第一个MyBatis程序

使用框架的思路：搭建环境——>导入框架——>编写代码——>测试
1）搭建环境
①搭建数据库

CREATE DATABASE `mybatis`;
USE `mybatis`;
CREATE TABLE `user`(
  `id` INT(20) NOT NULL PRIMARY KEY,
  `name` VARCHAR(30) DEFAULT NULL,
  `pwd` VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`name`,`pwd`) VALUES 
(1,'狂神','123456'),
(2,'张三','123456'),
(3,'李四','123890')

②新建项目
Ⅰ新建一个普通的Maven项目。
Ⅱ删除src目录。
Ⅲ导入依赖。

<dependencies>
  <!--mysql驱动-->
  <dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.47</version>
  </dependency>
  <!--mybatis-->
  <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.2</version>
  </dependency>
  <!--junit-->
  <dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
  </dependency>
</dependencies>

2）创建模块
①编写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核心配置文件-->
<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="123456"/>
      </dataSource>
    </environment>
  </environments>
</configuration>

②编写MyBatis工具类
官方文档提供代码：

String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

MyBatisUtils.java：

package com.ping.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——>sqlSession
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(){
    SqlSession sqlSession = sqlSessionFactory.openSession();
    return sqlSession;
  }
}

上述的三个重要作用域：
ⅠSqlSessionFactoryBuilder
一旦创建了SqlSessionFactory，就不再需要它了。
ⅡSqlSessionFactory
SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在。
最简单的就是使用单例模式或者静态单例模式。
ⅢSqlSession
SqlSession的实例不是线程安全的，因此是不能被共享的。
每次收到的HTTP请求，就可以打开一个SqlSession返回一个响应，就关闭它。这个关闭操作是很重要的，应该把这个关闭操作放到finally块中以确保每次都能执行关闭。下面的示例就是一个确保SqlSession关闭的标准模式：

try (SqlSession session = sqlSessionFactory.openSession()) {
  //应用逻辑代码
}

在所有代码中都遵循这种使用模式，来保证所有数据库资源都能被正确地关闭。
3）编写实体类
①实体类 User

package com.ping.pojo;
public class User {
  private int id;
  private String name;
  private String pwd;
  public User() {
  }
  public User(int id, String name, String pwd) {
    this.id = id;
    this.name = name;
    this.pwd = pwd;
  }
  public int getId() {
    return id;
  }
  public void setId(int id) {
    this.id = id;
  }
  public String getName() {
    return name;
  }
  public void setName(String name) {
    this.name = name;
  }
  public String getPwd() {
    return pwd;
  }
  public void setPwd(String pwd) {
    this.pwd = pwd;
  }
  @Override
  public String toString() {
    return "User{" +
              "id=" + id +
              ", name='" + name + '\'' +
              ", pwd='" + pwd + '\'' +
              '}';
  }
}

②Dao接口 UserDao.java：

package com.ping.dao;
import com.ping.pojo.User;
import java.util.List;
public interface UserDao {
  List<User> getUserList();
}

③接口实现类由以前的UserDaoImpl转变为一个Mapper配置文件。
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.kuang.dao.UserDao">
  <!--select查询语句-->
  <select id="getUserList" resultType="com.kuang.pojo.User">
    select * from mybatis.user
  </select>
</mapper>

4）测试
①注册Mappers
注意报错：org.apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to the MapperRegistry.
MapperRegistry是什么：核心配置文件中注册mappers。

<!--每一个mapper.xml都需要在MyBatis核心配置文件中注册mappers-->
<mappers>
  <mapper resource="com/ping/dao/UserMapper.xml"/>
</mappers>

②用junit测试

@Test
public void test(){
  //第一步：获得SqlSession对象
  SqlSession sqlSession = MybatisUtils.getSqlSession();
  //方式一：getMapper
  UserDao userDao = sqlSession.getMapper(UserDao.class);
  List<User> userList = userDao.getUserList();
  for (User user : userList) {
    System.out.println(user);
  }
  //关闭SqlSession
  sqlSession.close();
}

可能会遇到的问题：
①配置文件没有注册。
②绑定接口错误。
③方法名不对。
④返回类型不对。
⑤Maven导出资源问题。