JAVAEE框架技术之7-myBatis ORM框架入门基础CRUD

骑猪看日落 2023-09-29 17:20 15阅读 0赞

## MyBatis ##

## ORM概述 ##

在使用JDBC 的时候，我们通常将数据直接返回，但现在也会将数据封装到实体类对象中，由对象携带数据。这样操作的时候，可以通过操作对象的方式操作数据。但是手写这类代码通常是繁琐的、重复的，如果有自动完成这些功能的程序就好了。

`ORM`（Object-Relational-Mapping）：是对象关系映射的意思，它是一种思想，是指将数据库中的每一行数据用对象的形式表现出来。可以将 ORM 简单理解为上面我们提出的，可以自动将对象与数据进行映射的技术。

<table> 
 <thead> 
  <tr> 
   <th>Java</th> 
   <th>数据库</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>类</td> 
   <td>表</td> 
  </tr> 
  <tr> 
   <td>对象</td> 
   <td>一行数据（表中的某行数据）</td> 
  </tr> 
  <tr> 
   <td>属性</td> 
   <td>列（一行数据中的某个列）</td> 
  </tr> 
 </tbody> 
</table>

## 常见ORM框架 ##

**Hibernate**

**优点**

> 1.  简化了整个jdbc操作过程
> 2.  对于开发者来说不需要关心sql了，只需要去操作对象就可以了，hibernate可以帮我们自动生成所需要的sql
> 3.  代码移植性比较好，通过hibernate操作db都是通过操作对象来进行的，而hibernate会根据我们的操作和db的类型生成符合各种db要求的sql，如果我们需要切换db的类型，hibernate会自动适应，对于开发者业务代码来说不需要做任何业务代码上的调整
> 4.  开发效率比较高
> 
> 即使开发人员不知道sql，也能使用Hibernate来完成数据的CRUD的操作

**缺点**

> 1.  sql优化比较艰难，各种操作最终发给db的sql是由hibernate自动生成的，对于开发者来说如果想干预最终需要执行的sql，相对来说比较困难
> 2.  hibernate入门比较容易，但是想成为高手学习成本比较高
> 3.  对于复杂的动态sql，代码中也需要写很多判断进行组装，动态sql这块的支持比较欠缺
> 
> 如果做一些简单的系统，开发周期也比较紧急，对sql的优化要求也不是很高，可以使用hibernate。

**JdbcTemplate**

jdbctemplate是在spring框架的基础上开发的一个jdbc框架，所以对spring是有依赖的，它对jdbc做了封装，隐藏了各种重复的操作，使用时只需传入：需要执行的sql、参数以及对于结果如何解析的程序就可以了，使用起来还是很方便的，但是面对与动态sql，它也是无能为力了。整体上来说，jdbctemplate相对于纯jdbc隐藏了很多重复性的操作，**对于sql的写法和结果的组装上完全交给了开发者自己去控制**，在系统中使用也可以帮助我们节约很多时间，而且学习相当简单.

## MyBatis ##

### MyBatis简介 ###

MyBatis是一个半自动化的orm框架，为什么说是半自动化的呢，因为他需要我们自己去写sql，而他做的更好的地方就是`动态sql`的支持上面，而上面说的各种技术，面对与动态sql只能自己写很多判断去组装sql，而这些判断和组装在mybatis中实现起来就非常简单了，完全由mybatis去帮我们实现了。mybatis将sql交由开发者去控制，所以在sql的优化方面，开发者可以随心所欲，也就是说mybatis将重复性的工作优化到了极致：`操作db的过程、动态sql的拼装、结果和对象的映射`，这些mybatis都帮我们实现的很好，而让我们将更多的经历花在sql的写法和优化上面，所以毫无疑问mybatis使用人数和公司也是最多的。

### MyBatis概述 ###

> MyBatis官网地址：https://mybatis.org/mybatis-3/zh/index.html

1. mybatis是一个半自动化的持久层框架
    2. mybatis封装了jdbc的很多细节，开发者只需要关注sql本身，无需关注注册驱动 获取连接等操作
    3. mybatis使用ORM思想来对结果集一个封装

### MyBatis 优缺点 ###

*  ##### 优点 #####
    
        - 简单易学，容易上手（相比于 Hibernate ） ： 基于SQL编程
        - 消除了JDBC大量冗余的代码，不需要手动开关连接
        - 很好的与各种数据库兼容（因为 MyBatis 使用JDBC来连接数据库，所以只要JDBC 支持的数据库 MyBatis 都支持，而JDB提 供了可扩展性，所以只要这个数据库有针对Java的jar包就可以就可以与 MyBatis 兼容），开发人员不需要考虑数据库的差异性。
        - 提供了很多第三方插件（分页插件 / 逆向工程）
        - 能够与Spring很好的集成
        - 如果`使用映射文件`的话，可以让代码和配置文件完全分离。只要方法的定义没有改变，那么只需要修改配置文件就可以达到修改的目的。
 *  ##### 缺点 #####

- SQL语句的编写工作量较大，尤其是字段多、关联表多时，更是如此，对开发人员编写SQL语句的功底有一定要求。
    - SQL语句依赖于数据库，导致数据库移植性差，不能随意更换数据库

### Mybatis的工作原理 ###

![在这里插入图片描述][c50b5c124fcd4deda49a4263fd7c5ff0.png_pic_center]

## mybatis快速入门 ##

### 数据库准备 ###

CREATE TABLE `tb_user` (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `user_name` varchar(20) DEFAULT NULL,
      `sex` varchar(10) DEFAULT NULL,
      PRIMARY KEY (`id`)
    ) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8;

### 导入依赖 ###

<dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.5.6</version>
    </dependency>
    
    
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.18</version>
    </dependency>
    
    
    <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <version>1.16.18</version>
      <scope>provided</scope>
    </dependency>

### 编写全局配置文件 ###

*  **mybatis-config.xml**

![在这里插入图片描述][dcfc934af477480f97f9626222357736.png_pic_center]

### jdbc.properties文件 ###

driver=com.mysql.jdbc.Driver
    url=jdbc:mysql:///mybatis
    username=root
    password=root

### pojo实体类 ###

@Data
    public class User {
        
        private int id;
        private String userName;
        private String sex;
    }

### 实现操作 ###

> 参照官网API学习：https://mybatis.org/mybatis-3/zh/index.html

public class TestMybatis {
        
        public static void main(String[] args) throws IOException {
        
            //获取核心配置文件
            String resource = "mybatis-config.xml";
            //加载配置文件
            InputStream inputStream = Resources.getResourceAsStream(resource);
            //构建SqlSessionFactory对象
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    
            //构建SqlSession对象
            try (SqlSession session = sqlSessionFactory.openSession()) {
        
                //执行sql
                User user = (User) session.selectOne("abc.selectById", 4);
                System.out.println(user);
            }
        }
    }

### Mapper.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="abc">
    
        
        <select id="selectById" resultType="cn.yanqi.pojo.User">
            select * from tb_user where id = #{id}
          </select>
    
    </mapper>

### 加载sql映射文件 ###

*  mybatis-config.xml 加载sql映射文件（别忘了）

<mappers>
        <mapper resource="UserMapper.xml"/>
    </mappers>

### 测试 ###

![在这里插入图片描述][b0e175ee626b4110a2dbd6e86ad30e0d.png_pic_center]

### 添加日志支持 ###

> 以上虽然可以实现际，但并没有看发送的sql和参数，我们可以加入日志

*  log4j.properties

log4j.rootLogger=DEBUG,A1
    log4j.logger.org.mybatis=DEBUG
    log4j.appender.A1=org.apache.log4j.ConsoleAppender
    log4j.appender.A1.layout=org.apache.log4j.PatternLayout
    log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c]-[%p] %m%n

![在这里插入图片描述][2d9400db02b14e3db30a5a9a1f81ace0.png_pic_center]

## CRUD操作 ##

### dao层代码准备 ###

*  接口 userDao

package cn.yanqi.dao;
    import cn.yanqi.pojo.User;
    import java.util.List;
    /**
     * @Dese:  dao层接口
     */
    public interface UserDao {
        
    
        /**
         * 根据id查询用户信息
         * @param id
         * @return
         */
        public User queryUserById(int id);
        /**
         * 查询所有用户信息
         * @return
         */
        public List<User> queryAllUser();
        /**
         * 根据id删除用户信息
         * @param id
         */
        public void deleteUserById(int id);
        /**
         * 添加用户信息
         * @param user
         */
        public void addUser(User user);
        /**
         * 修改用户信息
         * @param user
         */
        public void updateUser(User user);
    
    }

*  实现类 UserDaoImpl

public class UserDaoImpl implements UserDao {
        
    
        //需要sqlsession对象，可以操作crud
        private SqlSession sqlSession;
    
        //临时解决方案
        public UserDaoImpl(SqlSession sqlSession){
        
            this.sqlSession = sqlSession;
        }
    
        //根据id来查询用户
        @Override
        public User queryUserById(int id) {
        
            return  sqlSession.selectOne("abc.queryUserById", id);
        }
    
        //查询所有
        @Override
        public List<User> queryAllUser() {
        
            return sqlSession.selectList("abc.queryAllUser");
        }
    
        //删除用户
        @Override
        public void deleteUserById(int id) {
        
            sqlSession.delete("abc.deleteUserById",id);
        }
    
        //添加用户
        @Override
        public void addUser(User user) {
        
            sqlSession.insert("abc.addUser",user);
        }
    
        //修改用户
        @Override
        public void updateUser(User user) {
        
            sqlSession.update("abc.updateUser",user);
        }
    }

### 编写User对应的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="abc">
        
        <update id="updateUser">
            UPDATE tb_user SET
            user_name = #{userName},  sex = #{sex} WHERE id = #{id};
        </update>
    
        
        <insert id="addUser">
            INSERT INTO tb_user(id, user_name, sex)
            VALUES (#{id}, #{userName}, #{sex})
        </insert>
    
        
        <delete id="deleteUserById">
            delete from tb_user where id = #{id}
        </delete>
    
        
        <select id="queryAllUser" resultType="cn.yanqi.pojo.User">
            select * from tb_user
        </select>
    
        
        <select id="queryUserById" resultType="cn.yanqi.pojo.User">
            select * from tb_user where id = #{id}
        </select>
    
        
        <select id="selectById" resultType="cn.yanqi.pojo.User">
            select * from tb_user where id = #{id}
        </select>
    
    </mapper>

### 加载sql映射文件 ###

*  在mybatis-config.xml里面引入UserMapper.xml

<mappers>
        <mapper resource="UserMapper.xml"/>
    </mappers>

### 去除xml中校验sql ###

![在这里插入图片描述][7a18ee62cd944c45b5409ddf75a3ccd3.png_pic_center]

![在这里插入图片描述][69220c1da599463caa090bd70a5edbb4.png_pic_center]

### 编写测试 ###

public class UserDaoTest {
        
    
        private UserDao userDao;
        private SqlSession sqlSession;
    
        //在执行test测试之前一定会执行Before
        @Before
        public void setUp() throws Exception {
        
            //指定核心配置文件的位置
            String resource = "mybatis-config.xml";
            //加载核心配置文件
            InputStream inputStream = Resources.getResourceAsStream(resource);
            //构建sqlSessionFactory对象
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            //获取SqlSession对象,SqlSession可以操作crud
            sqlSession = sqlSessionFactory.openSession();
            //SqlSession进行数据库操作
            userDao = new UserDaoImpl(sqlSession);
        }
    
        /**
         * 根据id进行查询
         */
        @Test
        public void queryUserById() {
        
            User user = this.userDao.queryUserById(1);
            System.out.println(user);
    
        }
        /**
         * 查询所有
         */
        @Test
        public void queryAllUser() {
        
            List<User> users = this.userDao.queryAllUser();
            for (User u : users){
        
                System.out.println(u);
            }
        }
    
        /**
         * 根据id进行删除
         */
        @Test
        public void deleteUserById() {
        
            this.userDao.deleteUserById(3);
            sqlSession.commit();//需要手动提交事务
        }
    
        /**
         * 添加
         */
        @Test
        public void addUser() {
        
            User user = new User();
            user.setId(11);
            user.setPassworld("123");
            user.setUserName("tom");
            user.setSex("男");
    
            this.userDao.addUser(user);
            sqlSession.commit();
    
        }
    
        /**
         * 修改
         */
        @Test
        public void updateUser() {
        
            User user = new User();
            user.setId(11);
            user.setPassworld("123");
            user.setUserName("yiyaniandyanqi");
            user.setSex("女男");
            this.userDao.updateUser(user);
            sqlSession.commit();
    
        }
    }

### 字段名和属性名不一致的问题 ###

> 查询数据的时候，查不到userName的信息，
> 
> 原因：数据库的字段名是user\_name pojo中的属性名字是userName

解决方案1：在sql语句中使用别名（麻烦）
    	Select  * , user_name as username  from t_user;
    解决方案2：参考驼峰匹配 --- mybatis-config.xml 的时候
    
    解决方案3： 参考后面的resultMap –mapper具体的配置的时候

### mybatis中dao层的命名规则 ###

在mybatis中dao层的接口的名字不在使用xxDao 而是修改成xxMapper
    
    例如：把UserDao，修改成UserMapper

### 思考CURD的dao中的问题 ###

> 接口->实现类->mapper.xml
> 
> 思考：能否只写UserDao接口，不书写实现类UserDaoImp，只编写Mapper.xml即可

### 名称空间 ###

> 接口的全类名 要和 sql映射文件中的namespace保持一致
> 
> 接口的方法史 要和 sql映射文件中的标签名保持一致

![在这里插入图片描述][d3635245950949bc914b64939a135d4f.png_pic_center]

### 修改测试类 ###

![在这里插入图片描述][db844b80247f454b9bfd733c9c21cb20.png_pic_center]

## mybatis-config 配置 ##

### **驼峰匹配** ###

> **开启驼峰匹配**：从经典数据库的命名规则user\_name，到经典java命名规则的映射userName
> 
> java命名规则：
> 
> 驼峰书写,大小写区分两个单词的界限。举例： userName;
> 
> 数据库经典命名规则：
> 
> 两个单词之间，使用下划线分割。举例：user\_name
> 
> 开启驼峰匹配：相当于去掉数据库名字中的下划线，然后在与java中的属性名进行对应。
> 
> 数据库中的user\_name 和java属性中的 userName 是一样的

*  mybatis-config.xml

<settings>
            <setting name="mapUnderscoreToCamelCase" value="true"/>
        </settings>

### typeAliaseso类别名 ###

*  mybatis-config.xml

<typeAliases>        
            
            <typeAlias type="cn.yanqi.pojo.User" alias="User"/>        
            
            <package name="cn.yanqi.pojo"/>        
        </typeAliases>

*  UserMapper.xml

<select id="queryAllUser" resultType="User">
            select * from tb_user
        </select>

### typeHandlers（类型处理器） ###

### environments环境 ###

> 其实我们后开发中，不止一个环境，例如：开发环境，测试环境，发布环境等
> 
> 可以在项目中设置多环境

<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>
    
            
            <environment id="dev">
                <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>

@Before
        public void setUp() throws Exception {
        
            //指定核心配置文件的位置
            String resource = "mybatis-config.xml";
            //加载核心配置文件
            InputStream inputStream = Resources.getResourceAsStream(resource);
            //构建sqlSessionFactory对象
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream,"dev");//使用指定环境
            //获取SqlSession对象,SqlSession可以操作crud
            sqlSession = sqlSessionFactory.openSession();
    
            //SqlSession进行数据库操作
            // userDao = new UserDaoImpl(sqlSession);
    
            userDao = sqlSession.getMapper(UserDao.class);
    
        }

### mappers映射器 ###

<mappers>
            
            
            
            <mapper class="cn.yanqi.mapper.UserMapper"/>
            
            <package name="cn.yanqi.mapper"/>
        </mappers>

![在这里插入图片描述][7431732992814348a804e0d4d1eed888.png_pic_center]

方式二，三：这里会报错，找不到这个类下面的方法

![在这里插入图片描述][7f6a11e9b4414bd787d5cc60e743d742.png_pic_center]

原因： 使用IDEA加载src下的xml文件会被忽略xml问题

![在这里插入图片描述][7fe24f1a89e3445fac12c686f70f74da.png_pic_center]

解决方案就是让IDEA不要忽略src目录下的xml文件，在pom.xml文件中添加代码

<build>
            <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>

## Mapper.xml映射文件 ##

### select标签 ###

select标签   发送select 语句
    
    id属性：当前名称空间下的statement的唯一标识。必须。要求id和mapper接口中的方法的名字一致。
    
    Select 标签中  
    resultType：将结果集映射为java的对象类型必须要有（和 resultMap 二选一）
    resultType使用注意：select查询出来 列名要和resultType指定的类型属性名对应，否则完成不了映射赋值。如果列名与类的属性名不一致则需要用自定义resultMap，和列名不一样的属性名要用resultMap的子标签id和result设置property、colum。
    
    parameterType：传入参数类型。可以省略，会自判断传入的是什么类型

public interface UserMapper {
        
        /**
         * 查询当前人数
         * @return
         */
        public Integer fintCount();

<select id="fintCount" resultType="Integer">
            select count(1) from tb_user;
        </select>

@Test
        public void TestFintCount(){
        
            Integer integer = userMapper.fintCount();
            System.out.println(integer);
        }

### insert标签 ###

id属性：当前名称空间下的statement的唯一标识(必须属性)；
    parameterType：传入的参数类型，可以省略。

public interface UserMapper {
        
        /**
         * 添加用户信息
         * @param user
         */
        public Integer addUser(User user);
    }

<insert id="addUser">
            INSERT INTO tb_user (id, user_name, sex)
            VALUES (#{id}, #{userName}, #{sex})
        </insert>

/**
         * 添加
         */
        @Test
        public void addUser() {
        
            User user = new User();
            user.setId(11);
            user.setUserName("tom");
            user.setSex("男");
    
            Integer integer = this.userMapper.addUser(user);
            System.out.println(integer);
            sqlSession.commit();
        }

### Update标签 ###

id属性：当前名称空间下的statement的唯一标识(必须属性)；
    parameterType：传入的参数类型，可以省略

public interface UserMapper {
        
        /**
         * 修改用户信息
         * @param user
         */
        public void updateUser(User user);
    }

<update id="updateUser">
            UPDATE tb_user SET user_name = #{userName}, sex = #{sex} WHERE id = #{id};
        </update>

/**
         * 修改
         */
        @Test
        public void updateUser() {
        
            User user = new User();
            user.setId(11);
            user.setUserName("rose");
            user.setSex("女");
            this.userMapper.updateUser(user);
            sqlSession.commit();
        }

### delete标签 ###

> \#\{ 只是表示占位可以随便写 \} 相当于 ？ 前提一定是一个变量

public interface UserMapper {
        
        /**
         * 根据id删除用户信息
         * @param id
         */
        public void deleteUserById(int id);
    }

<delete id="deleteUserById">
            delete from tb_user where id = #{id}
        </delete>

/**
     * 根据id进行删除
     */
    @Test
    public void deleteUserById() {
        
        this.userMapper.deleteUserById(4);
        sqlSession.commit();//需要手动提交事务
    }

UPDATE tb_user SET user_name = #{userName}, sex = #{sex} WHERE id = #{id};
    </update>

```java
        /**
         * 修改
         */
        @Test
        public void updateUser() {
            User user = new User();
            user.setId(11);
            user.setUserName("rose");
            user.setSex("女");
            this.userMapper.updateUser(user);
            sqlSession.commit();
        }

### delete标签 ###

> \#\{ 只是表示占位可以随便写 \} 相当于 ？ 前提一定是一个变量

public interface UserMapper {
        
        /**
         * 根据id删除用户信息
         * @param id
         */
        public void deleteUserById(int id);
    }

<delete id="deleteUserById">
            delete from tb_user where id = #{id}
        </delete>

/**
     * 根据id进行删除
     */
    @Test
    public void deleteUserById() {
        
        this.userMapper.deleteUserById(4);
        sqlSession.commit();//需要手动提交事务
    }

[c50b5c124fcd4deda49a4263fd7c5ff0.png_pic_center]: https://img-blog.csdnimg.cn/c50b5c124fcd4deda49a4263fd7c5ff0.png#pic_center
[dcfc934af477480f97f9626222357736.png_pic_center]: https://img-blog.csdnimg.cn/dcfc934af477480f97f9626222357736.png#pic_center
[b0e175ee626b4110a2dbd6e86ad30e0d.png_pic_center]: https://img-blog.csdnimg.cn/b0e175ee626b4110a2dbd6e86ad30e0d.png#pic_center
[2d9400db02b14e3db30a5a9a1f81ace0.png_pic_center]: https://img-blog.csdnimg.cn/2d9400db02b14e3db30a5a9a1f81ace0.png#pic_center
[7a18ee62cd944c45b5409ddf75a3ccd3.png_pic_center]: https://img-blog.csdnimg.cn/7a18ee62cd944c45b5409ddf75a3ccd3.png#pic_center
[69220c1da599463caa090bd70a5edbb4.png_pic_center]: https://img-blog.csdnimg.cn/69220c1da599463caa090bd70a5edbb4.png#pic_center
[d3635245950949bc914b64939a135d4f.png_pic_center]: https://img-blog.csdnimg.cn/d3635245950949bc914b64939a135d4f.png#pic_center
[db844b80247f454b9bfd733c9c21cb20.png_pic_center]: https://img-blog.csdnimg.cn/db844b80247f454b9bfd733c9c21cb20.png#pic_center
[7431732992814348a804e0d4d1eed888.png_pic_center]: https://img-blog.csdnimg.cn/7431732992814348a804e0d4d1eed888.png#pic_center
[7f6a11e9b4414bd787d5cc60e743d742.png_pic_center]: https://img-blog.csdnimg.cn/7f6a11e9b4414bd787d5cc60e743d742.png#pic_center
[7fe24f1a89e3445fac12c686f70f74da.png_pic_center]: https://img-blog.csdnimg.cn/7fe24f1a89e3445fac12c686f70f74da.png#pic_center