MyBatis——入门及第一个小程序

川长思鸟来 2022-12-12 15:26 330阅读 0赞

MyBatis 简介

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis，是一个基于Java的持久化框架。

  • 持久化： 可以将业务数据存储到磁盘，具备长期存储能力，只要磁盘不损坏，在断电或者其他情况下，重新开启系统仍然可以读取到这些数据。

优点：

  • 简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
  • 灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。
    sql写在xml里，便于统一管理和优化。通过sql基本上可以实现我们不使用数据访问框架可以实现的所有功能，或许更多。
  • 解除sql与程序代码的耦合：通过提供DAL层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
  • 提供映射标签，支持对象与数据库的orm字段关系映射
  • 提供对象关系映射标签，支持对象关系组建维护
  • 提供xml标签，支持编写动态sql。

缺点：

  • 编写SQL语句时工作量很大，尤其是字段多、关联表多时，更是如此。
  • SQL语句依赖于数据库，导致数据库移植性差，不能更换数据库。
  • 框架还是比较简陋，功能尚有缺失，虽然简化了数据绑定代码，但是整个底层数据库查询实际还是要自己写的，工作量也比较大，而且不太容易适应快速数据库修改。
  • 二级缓存机制不佳

Mybatis官方文档： https://mybatis.org/mybatis-3/zh/getting-started.html

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

MYbatis快速入门

一、IDEA新建maven工程mybatis_1,pom文件中添加相关依赖包：

在这里插入图片描述

  1. <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
  2.         <dependency>
  3.             <groupId>org.mybatis</groupId>
  4.             <artifactId>mybatis</artifactId>
  5.             <version>3.5.4</version>
  6.         </dependency>
  7.         <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
  8.         <dependency>
  9.             <groupId>mysql</groupId>
  10.             <artifactId>mysql-connector-java</artifactId>
  11.             <version>8.0.15</version>
  12.         </dependency>
  13.         <!--junit-->
  14.         <dependency>
  15.             <groupId>junit</groupId>
  16.             <artifactId>junit</artifactId>
  17.             <version>4.12</version>
  18.         </dependency>

DEA 默认是不支持 MyBatis 开发的，需要自己下载第三方插件来支持，自己学习的话free mybatis plugin即可。

在这里插入图片描述
注意：需要重启IDEA

二、数据准备工作

创建一个数据库test_w，编码方式设置为 UTF-8，然后再创建一个名为user的表，插入几行数据：

  1. drop database if exists test_w;
  2. create database test_w default CHARACTER  set utf8；
  3. use test_w;
  4. create table user
  5.  (
  6.      id int auto_increment primary key,
  7.      username varchar(20) not null,
  8.      password varchar(20) not null
  9. );
  10. insert into user values(1,'wanwei','1234');
  11. insert into user values(2,'wanwei2','1234');
  12. insert into user values(3,'wanwei3','1234');
  13. insert into user values(4,'wanwei4','1234');
  14. commit;

三、创建user实体类

  1. package com.ftj.dao;
  3. public class User { 
  4.     private int id;
  5.     private String username;
  6.     private String password;
  8.     public User(int id, String username, String password) { 
  9.         this.id = id;
  10.         this.username = username;
  11.         this.password = password;
  12.     }
  14.     public User() { 
  15.     }
  17.     public int getId() { 
  18.         return id;
  19.     }
  21.     public void setId(int id) { 
  22.         this.id = id;
  23.     }
  25.     public String getUsername() { 
  26.         return username;
  27.     }
  29.     public void setUsername(String username) { 
  30.         this.username = username;
  31.     }
  33.     public String getPassword() { 
  34.         return password;
  35.     }
  37.     public void setPassword(String password) { 
  38.         this.password = password;
  39.     }
  41.     @Override
  42.     public String toString() { 
  43.         return "User{" +
  44.                 "id=" + id +
  45.                 ", username='" + username + "'" +
  46.                 ", password='" + password + "'" +
  47.                 "}";
  48.     }
  49. }

四、配置文件 mybatis-config.xml

主要作用是提供连接数据库用的驱动，数据名称，编码方式，账号密码等

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
  3. <configuration>
  5.     <!-- 别名 -->
  6.     <typeAliases>
  7.         <package name="com.ftj.dao"/>
  8.     </typeAliases>
  9.     <!-- 数据库环境 -->
  10.     <environments default="development">
  11.         <environment id="development">
  12.             <transactionManager type="JDBC"/>
  13.             <dataSource type="POOLED">
  14.                 <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
  15.                 <property name="url" value="jdbc:mysql://localhost:3306/test_w?serverTimezone=UTC&characterEncoding=utf-8&useSSL=false"/>
  16.                 <property name="username" value="root"/>
  17.                 <property name="password" value=""/>
  18.             </dataSource>
  19.         </environment>
  20.     </environments>
  21.     <!-- 映射文件 -->
  22.     <mappers>
  23.         <mapper resource="User.xml"/>
  24.     </mappers>
  26. </configuration>

六、配置文件 User.xml

编写一个mybatis的工具类（可以查看中文文档来创建：目的就是读取配置文件，用SqlSessionFactory（工厂模式）来创建SessionFactory，这里可以用静态代码块来加载配置文件 ）

  1. package com.ftj.utils;
  3. import org.apache.ibatis.io.Resources;
  4. import org.apache.ibatis.session.SqlSession;
  5. import org.apache.ibatis.session.SqlSessionFactory;
  6. import org.apache.ibatis.session.SqlSessionFactoryBuilder;
  8. import java.io.IOException;
  9. import java.io.InputStream;
  11. public class MybatisUtils { 
  12.     private static SqlSessionFactory sqlSessionFactory;
  14.     static { 
  15.         try { 
  16.             //使用Mybatis第一步：获取SqlSessionFactory对象
  17.             String resource = "mybatis-config.xml";
  18.             InputStream is = Resources.getResourceAsStream(resource);
  19.             sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
  20.         } catch (IOException e) { 
  21.             e.printStackTrace();
  22.         }
  23.     }
  24.     //有了SqlSessionFactory，我们就可以获取SqlSession的实例了
  25.     public static SqlSession getSqlSession(){ 
  26.         return sqlSessionFactory.openSession();
  27.     }
  29. }

七、配置文件 User.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
  4. <mapper namespace="com.ftj.dao">
  5.     <select id="getUserList" resultType="User">
  6.         select * from  user
  7.     </select>
  9.     <select id="findUserById" resultType="User">
  10.         select * from  user where id = #{id}
  11.     </select>
  13.     <delete id="deleteUser">
  14.         delete from user where id =#{id}
  15.     </delete>
  16.     <update id="updateUser">
  17.         update user set username=#{username},password=#{password}
  18.             where id =#{id}
  19.     </update>
  20.     <insert id="insertUSer" >
  21.         insert into user(id,username,password)
  22.         values(#{id},#{username},#{password})
  24.         <selectKey resultType="int" keyProperty="id" order="AFTER">
  25.             select last_insert_id();
  26.         </selectKey>
  27.     </insert>
  28. </mapper>

八、编写测试类

  1. package com.ftj.dao;
  3. import com.ftj.utils.MybatisUtils;
  4. import org.apache.ibatis.session.SqlSession;
  5. import org.junit.Test;
  7. import java.io.IOException;
  8. import java.util.List;
  10. public class UserDaoTest { 
  12.     @Test
  13.     public void selectAllTest() throws IOException { 
  14.         //获取SqlSession对象
  15. // SqlSession sqlSession = MybatisUtils.getSqlSession();
  16.         //方式1：getMapper 执行SQL
  17.         //UserDao userDao = sqlSession.getMapper(UserDao.class);//反射
  18.         //List<User> userList = userDao.getUserList();
  20.         //方式2：
  21.         // 根据 mybatis-config.xml 配置的信息得到 sqlSessionFactory
  22. // String resource = "mybatis-config.xml";
  23. // InputStream inputStream = Resources.getResourceAsStream(resource);
  24. // SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
  25.         // 然后根据 sqlSessionFactory 得到 session
  26.         SqlSession session = MybatisUtils.getSqlSession();
  27.         // 最后通过 session 的 selectList() 方法调用 sql 语句 listStudent
  28.         List<User> userList = session.selectList("getUserList");
  30.         //delete
  33.         for (User user : userList) { 
  34.             System.out.println(user);
  35.         }
  36.         //关闭SqlSession
  37.         session.close();
  38.     }
  40.     @Test
  41.     public void insertTest() { 
  42.         SqlSession session = MybatisUtils.getSqlSession();
  43.         User user = new User();
  44. // user.setId(5);
  45.         user.setUsername("zhangsan");
  46.         user.setPassword("Huawei1234");
  47.         session.insert("insertUSer", user);
  48.         session.commit();
  49.         session.close();
  50.     }
  52.     @Test
  53.     public void deleteTest() { 
  54.         SqlSession session = MybatisUtils.getSqlSession();
  55.         session.delete("deleteUser",5);
  56.         session.commit();
  57.         session.close();
  58.     }
  60.     @Test
  61.     public void findUserById(){ 
  62.         SqlSession session = MybatisUtils.getSqlSession();
  63.         List<User> userlist = session.selectList("findUserById", 6);
  65.         for(User user : userlist){ 
  66.             System.out.println(user);
  67.         }
  69.         session.close();
  70.     }
  71. }

遇到的问题

1、可能会遇到的问题就是：maven造成的 .xml文件导出问题（在target目录中没法找到这份文件，从而导致缺少映射的关系，报错，解决办法：就是在pom.xml中增加下面的代码：）

  1. <!--在build中配置resources，来防止我们资源导出失败的问题-->
  2.     <build>
  3.         <resources>
  4.             <resource>
  5.                 <directory>src/main/resources</directory>
  6.                 <includes>
  7.                     <include>**/*.properties</include>
  8.                     <include>**/*.xml</include>
  9.                 </includes>
  10.                 <filtering>false</filtering>
  11.             </resource>
  12.             <resource>
  13.                 <directory>src/main/java</directory>
  14.                 <includes>
  15.                     <include>**/*.properties</include>
  16.                     <include>**/*.xml</include>
  17.                 </includes>
  18.                 <filtering>false</filtering>
  19.             </resource>
  20.         </resources>
  21.     </build>

2、 java.sql.SQLException: The server time zone value ‘Öйú±ê׼ʱ¼ä’ is unrecognized

mybatis-config.xml中数据库连接url没有指定时区

  1. <property name="url" value="jdbc:mysql://localhost:3306/test_w?serverTimezone=UTC&characterEncoding=utf-8&useSSL=false"/>

发表评论

表情：
评论列表 （有 0 条评论，330人围观）

还没有评论，来说两句吧...

相关阅读