数据库学习记录 Day4（Mybatis入门）

Day 4

2019年7月23日。
这是我学习数据库的第四天。
这一天，我学到了以下的知识。

什么是MyBatis

如何找到MyBatis?
mybatis原来不叫mybatis，叫ibatis1/2
mybatis3，被托管到github上

github地址
https://github.com/mybatis/mybatis-3

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

什么是持久层

持久态和瞬时态
持久化就是数据在瞬时状态和持久状态之间转化的一个过程。

内存：断电即失。我们现在无法用技术层面来保存，内存不会断电。
将内存中的数据持久化的存储；磁盘，硬盘，等待;

持久层对应代码架构的哪一层——Dao层
dao层，专注于处理数据库的操作，但是需要写一大堆的JDBC的重复代码。我们应该专注Sql语句编写，获得Sql的返回值即可。

持久层为什么不叫持久化模块
我们的系统中，应该有一个单独的层面来处理这个数据库连接问题。
为了解耦，这个层面就应该有较为清晰的逻辑边界。

为什么需要这个框架

hibernate：全自动的ORM框架，不用编写sql语句；黑箱操作，用于SSH框架（Spring、Struct 1/2、hibernate）
mybatis：半自动的ORM框架，可以自定义sql语句，更加灵活；白箱操作，所有sql语句都由开发人员来编写，能够定制化完成许多功能，所以就要求开发人员掌握sql语句的编写，用于SSM框架（Spring、Spring MVC、MyBatis）

MyBatis的优点

• 不用再去编写大量的JDBC代码
• 简单易学，不依赖第三方的程序或者框架
• 官方文档强大：http://www.mybatis.org/mybatis-3/zh/index.html
• 开源，可以随时分析源码
• 实现解耦，低耦合，高内聚
• ORM：对象关系映射
• 提供XML标签
• …

第一个MyBatis程序

1. 搭建实验环境。创建一个数据库，sql语句如下：

CREATE DATABASE /*!32312 IF NOT EXISTS*/`mybatis` /*!40100 DEFAULT CHARACTER SET utf8 */;

USE `mybatis`;

DROP TABLE IF EXISTS `user`;

CREATE TABLE `user` (
  `id` int(20) NOT NULL,
  `name` varchar(30) DEFAULT NULL,
  `pwd` varchar(30) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

insert  into `user`(`id`,`name`,`pwd`) values (1,'狂神','123456'),(2,'张三','abcdef'),(3,'李四','987654');

2. 在IDEA中创建一个普通的Maven项目，并在pom.xml中导入相关的包，代码如下：

<?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>moxitao</groupId>
    <artifactId>moxitao</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>

    <dependencies>

        <!--单元测试-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
        </dependency>

        <!--mybatis的包-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.1</version>
        </dependency>

        <!--连接数据库的驱动包-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>

    </dependencies>


    <build>
        <!--希望maven在导出项目的时候,能够将我们的配置及资源导出-->
        <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>
            </resource>
        </resources>

    </build>



</project>

3. 编写代码

   1. 先创建pojo包，并在包下创建User实体类，代码如下：

   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 + '\'' +
               '}';
     }
   }
   

   2. 创建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>
   <!--配置环境，这里可以有多套环境 default代表默认的是那一套-->
   <environments default="development">
       <!--配置一套环境 id .环境的名字-->
       <environment id="development">
           <!--transactionManager:事务管理，type:jdbc-->
           <transactionManager type="JDBC"/>
           <!--dataSource 数据源-->
           <dataSource type="POOLED">
               <property name="driver" value="com.mysql.jdbc.Driver"/>
               <!--xml中不允许&符号直接出现，我们需要使用 &amp; 代替-->
               <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;charsetEncoding=UTF-8"/>
               <property name="username" value="root"/>
               <property name="password" value="123456"/>
           </dataSource>
       </environment>
   </environments>
   </configuration>
   

   3. 创建utils包，并在包下创建MyBatisUtils工具类，用于获取SqlSessionFactory，代码如下：

   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;
   
   //mybatis的工具类，重复的代码的提纯
   public class MyBatisUtils {
   
   //类变量不需要设置默认值；
   private static SqlSessionFactory sqlSessionFactory;
   
   static {
   
       //在maven中，所有的资源文件一般都放在resources目录下，我们可以直接拿到。
       try {
           String resource = "mybatis-config.xml";
           InputStream inputStream = Resources.getResourceAsStream(resource);
           sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
       } catch (IOException e) {
           e.printStackTrace();
       }
   
   }
   
   //设置SqlSessionFactory公共的方法
   public static SqlSessionFactory getSqlSessionFactory(){
       return sqlSessionFactory;
   }
   
   
   }
   

   4. 创建dao包，并在包下创建UserMapper接口，用于对应原来的dao接口，代码如下：

   import java.util.List;
   
   public interface UserMapper {
   //获取全部的用户
   List<User> selectUser();
   }
   

   5. 在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">
   
   <!--mapper标签的namespace对应Mapper接口的类-->
   <mapper namespace="dao.UserMapper">
   <!--select标签的id对应映射接口的方法名字  resultType:返回结果的类型  中间就编写sql语句-->
   <select id="selectUser" resultType="pojo.User">
       select * from user
   </select>
   
   </mapper>
   

   6. 在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>
   <!--配置环境，这里可以有多套环境 default代表默认的是那一套-->
   <environments default="development">
       <!--配置一套环境 id .环境的名字-->
       <environment id="development">
           <!--transactionManager:事务管理，type:jdbc-->
           <transactionManager type="JDBC"/>
           <!--dataSource 数据源-->
           <dataSource type="POOLED">
               <property name="driver" value="com.mysql.jdbc.Driver"/>
               <!--xml中不允许&符号直接出现，我们需要使用 &amp; 代替-->
               <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;charsetEncoding=UTF-8"/>
               <property name="username" value="root"/>
               <property name="password" value="123456"/>
           </dataSource>
       </environment>
   </environments>
   
   <!--关联映射文件-->
   <mappers>
       <mapper resource="dao/userMapper.xml"/>
   </mappers>
   
   </configuration>
   

4.测试一下
在Maven项目下的test文件夹下编写对应的测试类，代码如下：

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {
    @Test
    public void selectUser(){

        //1.拿到sqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = MyBatisUtils.getSqlSessionFactory();
        //2.通过sqlSessionFactory对象openSession()创建一个sqlSession。
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //3.通过sqlSession获得mapper对象 ， 参数为映射文件对应的接口类的class对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //4.通过mapper对象来执行操作；
        List<User> users = mapper.selectUser();

        //获得结果集
        for (User user : users) {
            System.out.println(user);
        }


    }
}

5.结果

6.项目结构

CRUD操作

Mapper接口本章就是原来的Dao接口，只是为了方便书写，一个mapper接口对应一个映射文件。

1. 将UserMapper更名为UserDao，说明本质
   修改对应的mapper映射文件的namespace属性，对应上接口，代码如下：

   import java.util.List;
   
   public interface UserDao {
   //获取全部的用户
   List<User> selectUser();
   
   //根据id查找用户
   User selectUserById(int id);
   
   //添加一个用户
   int addUser(User user);
   
   //删除用户
   int deleteUserByID(int id);
   
   //修改用户
   int updateUser(User user);
   
   }
   

2. 编写接口对应的mapper语句，代码如下：

   <?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对应Mapper接口的类，	包名+类名-->
   <mapper namespace="dao.UserDao">
   <!--select标签的id对应映射接口的方法名字；resultType：返回结果的类型 中间就编写sql语句-->
   <select id="selectUser" resultType="pojo.User">
     select * from user
   </select>
   
   <select id="selectUserById" resultType="pojo.User">
     select * from user where id = #{id}
   </select>
   
   <!--
   我们需要接受一个自定义的对象（引用对象），需要设置parameterType，为参数类型
   接受这个对象的值，直接使用 #{对象字段名}
   -->
   <insert id="addUser" parameterType="pojo.User">
        insert into user (id,name,pwd) values (#{id},#{name},#{pwd})
   </insert>
   
   <delete id="delUserByID" parameterType="int">
       delete from user where id = #{delid}
   </delete>
   
   <update id="updateUser" parameterType="pojo.User">
       update user set name = #{name} , pwd = #{pwd}  where id = #{id}
   </update>
   
   </mapper>
   

3. 编写测试类，代码如下：

   import org.apache.ibatis.session.SqlSession;
   import org.apache.ibatis.session.SqlSessionFactory;
   import org.junit.Test;
   
   import java.util.List;
   
   public class UserMapperTest {
   @Test
   public void selectUser() {
   
       //1.拿到sqlSessionFactory对象
       SqlSessionFactory sqlSessionFactory = MyBatisUtils.getSqlSessionFactory();
       //2.通过sqlSessionFactory对象openSession()创建一个sqlSession。
       SqlSession sqlSession = sqlSessionFactory.openSession();
       //3.通过sqlSession获得mapper对象 ， 参数为映射文件对应的接口类的class对象
       UserDao mapper = sqlSession.getMapper(UserDao.class);
       //4.通过mapper对象来执行操作；
       List<User> users = mapper.selectUser();
   
       //获得结果集
       for (User user : users) {
           System.out.println(user);
       }
   
       sqlSession.close(); //关闭sqlSession
   
   }
   
   
   @Test
   public void selectUserById(){
       SqlSessionFactory sqlSessionFactory = MyBatisUtils.getSqlSessionFactory();
       SqlSession sqlSession = sqlSessionFactory.openSession();
       UserDao mapper = sqlSession.getMapper(UserDao.class);
       //接口  对象名  = new  接口实现类
       User user = mapper.selectUserById(1);
       System.out.println(user);
   
       sqlSession.close(); //关闭sqlSession
   }
   
   @Test
   public void addUser(){
       User user = new User(4,"abc","123456");
   
       SqlSessionFactory sqlSessionFactory = MyBatisUtils.getSqlSessionFactory();
       SqlSession sqlSession = sqlSessionFactory.openSession();
       UserDao mapper = sqlSession.getMapper(UserDao.class);
   
       int i = mapper.addUser(user);
   
       //没有插入成功的原因：没有提交事务；
       sqlSession.commit(); //提交事务
       sqlSession.close(); //关闭sqlSession
   
       if (i>0){
           System.out.println("插入成功！");
       }
   
   }
   
   @Test
   public void deleteUserByID(){
       SqlSession sqlSession = MyBatisUtils.getSqlSessionFactory().openSession();
       UserDao mapper = sqlSession.getMapper(UserDao.class);
       int i = mapper.deleteUserByID(4);
   
       //记得提交事务，否则删除不成功！
       sqlSession.commit();//提交事务
       sqlSession.close();//关闭
   
       if (i>0){
           System.out.println(i);
       }
   }
   
   @Test
   public void updateUser(){
       SqlSession sqlSession = MyBatisUtils.getSqlSessionFactory().openSession();
       UserDao mapper = sqlSession.getMapper(UserDao.class);
       User user = new User(1,"abc","1234");
       mapper.updateUser(user);
   
       sqlSession.commit();
       sqlSession.close();
   
   }
   
   
   }
   

4. CRUD操作的注意点如下：

   1. 事务：增，改，删需要提交事务！
   2. 乱码：如果出现乱码，先在sql中进行测试，sql没问题，就检查配置文件

   jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf-8"
   

   3. 参数问题：如果是基本数据类型，可以省略，但建议写上，引用类型必须写指定的 包名+类名。

配置文件的详解

mybatis-config文件解析

<?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 配置
	properties   配置文件
    settings     mybatis设置
    typeAliases   为Java类起别名
    typeHandlers  类处理器
    objectFactory  对象工厂 
    plugins   插件
    environments  环境
		transactionManager : 事务管理
		dataSource ： 数据源
	mappers 映射器

优化代码

优化配置文件

1. 在 resources目录下创建一个database.properties，代码如下：

   driver = com.mysql.jdbc.Driver
   url = jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true;characterEncoding=utf-8
   username = root
   password = 123456
   

2. 在mybatis核心配置文件中引入properties配置文件，并用${}表达式引入其中的值，代码如下：

   <configuration>
   
   <!--配置文件修改-->
   <properties resource="database.properties"/>
   
   <environments default="development">
       <environment id="development">
           <transactionManager type="JDBC"/>
           <dataSource type="POOLED">
               <property name="driver" value="${driver}"/>
               <property name="url" value="${url}"/>
               <property name="username" value="${username}"/>
               <property name="password" value="${password}"/>
           </dataSource>
       </environment>
   </environments>
   
   <mappers>
       <mapper resource="dao/userMapper.xml"/>
   </mappers>
   
   </configuration>
   

优化别名

1. 在mybatis核心配置文件中可以添加别名，注意位置需要对应，代码如下：

<!--配置别名-->
<typeAliases>

    <!--配置指定类的别名-->
    <typeAlias type="pojo.User" alias="User"/>

    <!--
        可以为一个包的所有类指定别名，这个别名为类名
        pojo.User    -  >  User
        pojo.Student   -  >  Student

        -->
    <package name="com.kuang.pojo"/>

</typeAliases>

2. 别名配置完毕后在mapper映射文件中就可以使用别名了，代码如下：

<?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对应Mapper接口的类,包名+类名-->
<mapper namespace="dao.UserDao">

    <!--select标签的id对应映射接口的方法名字  resultType:返回结果的类型  中间就编写sql语句-->
    <select id="selectUser" resultType="User">
    select * from user
    </select>

    <select id="selectUserById" resultType="User">
        select * from user where id = #{id}
    </select>

    <!--
    我们需要接受一个自定义的对象（引用对象），需要设置parameterType，为参数类型
    接受这个对象的值，直接使用 #{对象字段名}
    -->
    <insert id="addUser" parameterType="User">
        insert into user(id ,name, pwd) values (#{id},#{name},#{pwd})
    </insert>

    <delete id="deleteUserByID" parameterType="int">
        delete from user where id = #{id}
    </delete>

    <update id="updateUser" parameterType="User">
        update user set name =#{name},pwd = #{pwd} where id = #{id}
    </update>

</mapper>

环境配置

<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="${driver}"/>
            <property name="url" value="${url}"/>
            <property name="username" value="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>
</environments>

映射器
可以通过四种方式来创建映射器：

• resource 【推荐】
• url
• class
• package

这里使用推荐使用的resource方式来创建映射器，代码如下：

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

解决属性和字段名不一致

假设：

字段名	属性名
数据库	实体类
id	id
name	name
pwd	password

在这里，最后一个字段名（pwd）和属性名（password）不一致，照这个表格修改后的运行结果为：

由图可见，password为null值。

分析
select * from user 等价于 select id，name，pwd from user

mybatis会根据数据库的字段名去找对应的实体类的属性名，（它会将所有列名转换为小写，然后去找实体类中对应的 set方法 ，set方法后面的字段就对应数据库的字段名；如果不一样就会返回null）

解决方案

1. 修改set方法名字【不推荐使用】
   

2. 给sql语句取别名【字段少的时候推荐使用】
   

3. 使用结果集映射ResultMap 【最推荐的方式】，代码如下：

   <!--设置结果的映射类型-->
   <resultMap id="UserMap" type="User">
   <!--
   一般通过id标签来映射主键
   column = 数据库的列名
   property = 结果集对应的数据库列名的映射名
   -->
   <id column="id" property="id"/>
   <result column="name" property="name"/>
   <result column="pwd" property="password"/>
   </resultMap>
   
   
   <select id="selectUser" resultMap="UserMap">
     select * from user
   </select>