首页 > 技术文章 > MyBatis框架介绍及其实操

YJzhiqianni 2019-04-09 15:55 原文

 

  一、基本概念和介绍

 


 

  数据持久化的概念

  数据持久化是将内存中的数据模型转换为存储模型,以及将存储模型转换为内存中的数据模型的统称。例如,文件的存储、数据的读取等都是数据持久化操作。数据模型可以是任何数据结构或对象模型、XML、二进制流等。

  当我们编写应用程序操作数据库,对表数据进行增删改查的操作的时候就是数据持久化的操作。

 

  Mybatis框架简介

  MyBatis框架是一个开源的数据持久层框架。它的内部封装了通过JDBC访问数据库的操作,支持普通的SQL查询、存储过程和高级映射,几乎消除了所有的JDBC代码和参数的手工设置以及结果集的检索。MyBatis作为持久层框架,其主要思想是将程序中的大量SQL语句剥离出来,配置在配置文件当中,实现SQL的灵活配置。这样做的好处是将SQL与程序代码分离,可以在不修改代码的情况下,直接在配置文件当中修改SQL。

  

  ORM

  ORM(Object/Relational Mapping)即对象关系映射,是一种数据持久化技术。它在对象模型和关系型数据库直接建立起对应关系,并且提供一种机制,通过JavaBean对象去操作数据库表的数据,如下图。

  在我们实际的开发当中,我们使用对象的技术操作数据库,而当存储数据时,使用的却是关系型数据库,这样造成了很多的不便。ORM在对象模型和关系型数据库的表之间建立了一座桥梁。有了ORM,我们就不用再使用SQL语句操作数据库中的表,使用API直接操作JavaBean对象就可以实现数据的增删改查等的操作。MyBatis通过简单的XML或者注解的方式进行配置和原始映射,将实体类和SQL语句之间建立映射关系,是一种半自动(之所以说是半自动,因为我们要自己写SQL)的ORM实现。

  


  二、MyBatis框架的优缺点及其适用的场合

  MyBatis的优点

  (1)与JDBC相比,减少了50%以上的代码量。

  (2)MyBatis是最佳的持久层框架,小巧并且简单易学。

  (3)MyBatis相当灵活,不会对应用程序或者数据库的现有设计强加任何影响,SQL写在XML文件里,从程序代码中彻底分离,降低耦合度,便于统一的管理和优化,并可重用。

  (4)提供XML标签,支持编写动态的SQL,满足不同的业务需求。

  (5)提供映射标签,支持对象与数据库的ORM字段关系映射。

  MyBatis的缺点

   (1)SQL语句的编写工作量较大,对开发人员编写SQL的能力有一定的要求。

  (2)SQL语句依赖于数据库,导致数据库不具有好的移植性,不可以随便更换数据库。

  MyBatis框架的适用场合

  MyBatis专注于SQL自身,是一个足够灵活的DAO层解决方案。对性能的要求很高,或者需求变化较多的项目,例如Web项目,那么MyBatis是不二的选择。

 

 


  三、实操(简单例子)

  目的:通过MyBatis实现对我数据库中已经存在的表进行操作,包括向表中插入、修改、查询和删除数据。

  1.准备数据库和表

  

create database if not exists my_test charset utf8;#创建数据库my_test

 

use my_test; #使用数据库

 

create table student(Id int primary key auto_increment,Name varchar(20),Age int,Gender char(10)); #创建表student

 

  可以看到现在数据库中已经有表student了,但是表示空的。

  

  2.下载MyBatis需要的jar文件

  通过github下载,下载地址是 https://github.com/mybatis/mybatis-3/releases,我选择的是3.4.5的版本,注意要根据自己的jdk来选择,可能高版本的不符合。

 下载mysql数据库驱动jar文件,下载地址是 http://central.maven.org/maven2/mysql/mysql-connector-java

  3.在Eclipse中新建JavaWeb项目,在lib目录下导入下载好的jar

   

  4.创建MyBatis的核心配置文件,mybatis-config.xml,内容如下。其中mysql.properties 文件是引入的,在该文件内配置的是数据库相关的信息,包括数据库驱动、链接数据库的url、数据库用户名和密码。

 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>
 4   <!-- 引入外部mysql配置文件 -->
 5   <properties resource="mysql.properties"></properties>
 6    
 7    <!-- 配置mybatis的log实现为log4j -->
 8    <settings>
 9        <setting name="logImpl" value="LOG4J"/>
10    </settings>
11    
12    <!-- 为JAVA Bean起类别名 -->
13    <typeAliases>
14        <!-- 别名方式,自动扫描,将JAVA类的类名作为类的类别名 -->
15          <package name="com.ydy.entiy"/> 
16    </typeAliases>
17    
18    <!-- 配置mybatis运行环境 -->
19      <environments default="development">
20         <environment id="development">
21             <!-- type="JDBC" 代表使用JDBC的事务管理 -->
22             <transactionManager type="JDBC" />
23             
24             <!-- mybatis提供了3种数据源类型,分别是:POOLED,UNPOOLED,JNDI -->
25             <!-- POOLED 表示支持JDBC数据源连接池 -->
26             <!-- UNPOOLED 表示不支持数据源连接池 -->
27             <!-- JNDI 表示支持外部数据源连接池 -->
28             <dataSource type="POOLED">
29                 <property name="driver" value="${Driver}" />
30                 <property name="url" value="${Url}" />
31                 <property name="username" value="${Username}" />
32                 <property name="password" value="${Password}" />
33             </dataSource>
34         </environment>
35     </environments> 
36 </configuration>

  

  接着,配置 mysql.properties文件,内容如下

1 Driver=com.mysql.jdbc.Driver
2 Url=jdbc:mysql:///my_test?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8&useSSL=false
3 Username=root
4 Password=root

 

  

 

  5.定义实体类,这里的变量和数据库的字段是相对应的,以及生成有参构造方法 

 1 package com.ydy.entiy;
 2 
 3 import java.io.Serializable;
 4 
 5 public class Student implements Serializable{
 6     
 7     /**
 8      * 
 9      */
10     private static final long serialVersionUID = 1L;
11     private int Id;
12     private String Name;
13     private int Age;
14     private String Gender;
15     public Student(String name, int age, String gender) {
16         super();
17         Name = name;
18         Age = age;
19         Gender = gender;
20     }
21     public Student(int id, String name, int age, String gender) {
22         super();
23         Id = id;
24         Name = name;
25         Age = age;
26         Gender = gender;
27     }
28     public String toString() {
29         return "Student [Id=" + Id + ", Name=" + Name + ", Age=" + Age + ", Gender=" + Gender + "]";
30     }
31     public int getId() {
32         return Id;
33     }
34     public void setId(int id) {
35         Id = id;
36     }
37     public String getName() {
38         return Name;
39     }
40     public void setName(String name) {
41         Name = name;
42     }
43     public int getAge() {
44         return Age;
45     }
46     public void setAge(int age) {
47         Age = age;
48     }
49     public String getGender() {
50         return Gender;
51     }
52     public void setGender(String gender) {
53         Gender = gender;
54     }
55     
56     
57 }

 

  6.定义接口方法studentMapper.java 

 1 package com.ydy.mapper;
 2 
 3 import java.util.List;
 4 
 5 import com.ydy.entiy.Student;
 6 
 7 public interface studentMapper {
 8     /**
 9      * 定义四个方法,增删改查,其中的增删改成功的话会返回1,查询的是所有,故使用List来接收
10      * @param student
11      * @return
12      * @throws Exception
13      */
14     
15     public int insertStudent(Student student)throws Exception;;
16     
17     public int updateStudent(Student student)throws Exception;;
18     
19     public List<Student> selectAllUser()throws Exception;; 
20     
21     public int deleteStudent(int id)throws Exception;;
22     
23 }

 

  7.创建SQL映射文件 studentMapper.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,namespace的值习惯上设置成包名+sql映射文件名,这样就能够保证namespace的值是唯一的
例如namespace="com.ydy.mapper.studentMapper"就是com.ydy.mapper(包名)+studentMapper(studentMapper.xml文件去除后缀)
 -->
<mapper namespace="com.ydy.mapper.studentMapper">
   <!-- 自定义返回结果集 -->
   <resultMap id="studentMap" type="Student">
        <id property="Id" column="Id" javaType="java.lang.Integer"></id>
        <result property="Name" column="Name" javaType="java.lang.String"></result>
        <result property="Age" column="Age" javaType="java.lang.Integer"></result>
        <result property="Gender" column="Gender" javaType="java.lang.String"></result>
    </resultMap>
<!-- 在各种标签中的id属性必须和接口中的方法名相同 , id属性值必须是唯一的,不能够重复使用。parameterType属性指明查询时使用的参数类型,resultType属性指明查询返回的结果集类型-->    
<!--#{}中的内容,为占位符,当参数为某个JavaBean时,表示放置该Bean对象的属性值  -->

    <!-- 向student表中插入记录 -->
    <insert id="insertStudent">
        insert into student (Name,Age,Gender) values (#{Name},#{Age},#{Gender})
    </insert>
    
    <!-- 更新student表中的记录 -->
    <update id="updateStudent" parameterType="int">
      update student set Name=#{Name},Age=#{Age},Gender=#{Gender} where Id=#{Id}
    </update>
    
    <!--查询student表中的所有记录 -->
    <select id="selectAllStudent" resultMap="studentMap">
     select * from student
    </select>
    
    <!-- 根据id删除student表中的记录 -->
    <delete id="deleteStudent" parameterType="int">
     delete from student where Id=#{Id}  
    </delete>
    
</mapper>

 

  接着,要在mybatis.config.xml里面把SQL映射文件引入

 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>
 4   <!-- 引入外部mysql配置文件 -->
 5   <properties resource="mysql.properties"></properties>
 6    
 7    <!-- 配置mybatis的log实现为log4j -->
 8    <settings>
 9        <setting name="logImpl" value="LOG4J"/>
10    </settings>
11    
12    <!-- 为JAVA Bean起类别名 -->
13    <typeAliases>
14        <!-- 别名方式,自动扫描,将JAVA类的类名作为类的类别名 -->
15          <package name="com.ydy.entiy"/> 
16    </typeAliases>
17    
18    <!-- 配置mybatis运行环境 -->
19      <environments default="development">
20         <environment id="development">
21             <!-- type="JDBC" 代表使用JDBC的事务管理 -->
22             <transactionManager type="JDBC" />
23             
24             <!-- mybatis提供了3种数据源类型,分别是:POOLED,UNPOOLED,JNDI -->
25             <!-- POOLED 表示支持JDBC数据源连接池 -->
26             <!-- UNPOOLED 表示不支持数据源连接池 -->
27             <!-- JNDI 表示支持外部数据源连接池 -->
28             <dataSource type="POOLED">
29                 <property name="driver" value="${Driver}" />
30                 <property name="url" value="${Url}" />
31                 <property name="username" value="${Username}" />
32                 <property name="password" value="${Password}" />
33             </dataSource>
34         </environment>
35     </environments> 
36     <!-- 把studentMapper文件引入 -->
37     <mappers>
38         <mapper resource="com/ydy/mapper/studentMapper.xml"/>
39     </mappers>
40 </configuration>

 

  8.新建包tools,在里面新建类myBatisTool,使用mybatis提供的对象读取全局配置文件mybatis.config.xml文件

 1 package tools;
 2 
 3 import java.io.Reader;
 4 
 5 import org.apache.ibatis.io.Resources;
 6 import org.apache.ibatis.session.SqlSession;
 7 import org.apache.ibatis.session.SqlSessionFactory;
 8 import org.apache.ibatis.session.SqlSessionFactoryBuilder;
 9 
10 import com.sun.corba.se.spi.orbutil.fsm.State;
11 
12 public class myBatisTool {
13     public static SqlSessionFactory sqlSessionFactory;
14     static{
15         
16             //使用MyBatis提供的Resources类加载mybatis的配置文件
17             try{
18                 Reader config=Resources.getResourceAsReader("mybatis.config.xml");
19             
20             //构造SqlSession的工厂
21             sqlSessionFactory = new SqlSessionFactoryBuilder().build(config);
22             }catch (Exception e){
23                 e.printStackTrace();
24             }
25     }
26         ////创建能执行映射文件中sql的sqlSession对象
27         public static SqlSession getSession(){
28             return sqlSessionFactory.openSession();
29         }
30     
31 }

 

  9.新建包service,编写测试类studentService 

 1 package service;
 2 
 3 import org.apache.ibatis.session.SqlSession;
 4 
 5 import com.ydy.entiy.Student;
 6 import com.ydy.mapper.studentMapper;
 7 
 8 import tools.myBatisTool;
 9 
10 public class studentService {
11     
12     public static void main(String[] args) {
13         insertStudent();
14         //updateStudent();
15         //selectAllStudent();
16         //deleteStudent();
17     }
18     /**
19      * 新增学生记录
20      */
21     private static void insertStudent() {
22         //利用SqlSession对象来执行SQL语句
23         SqlSession session=myBatisTool.getSession();
24         studentMapper mapper=session.getMapper(studentMapper.class);
25         Student student=new Student(1,"张三",21,"男");
26         try{
27         mapper.insertStudent(student);
28         System.out.println(student.toString());
29         session.commit();
30         }catch (Exception e){
31             e.printStackTrace();
32             
33         }finally {
34             session.close();
35         }
36     }
37     /**
38      * 查询学生记录
39      */
40     private static void selectAllStudent() {
41         // TODO Auto-generated method stub
42         
43     }
44     /**
45      * 更新学生记录
46      */
47     private static void updateStudent() {
48         // TODO Auto-generated method stub
49         
50     }
51     /**
52      * 删除学生记录
53      */
54     private static void deleteStudent() {
55         // TODO Auto-generated method stub
56         
57     }
58 }

 

   控制台的结果

  

    数据库的结果

  

  上述的是执行新增的结果,其他的功能也是类似。这里就不多说了。记录一下我遇到的问题吧。

  (1)在mybatis-config.xml文件当中标签的顺序是有要求的,不能乱写。

  (2)在mysql.properties文件当中记得加上编码方式,不然插入到数据库会乱码。

  实践是检验真理的唯一标准,本人是一个小菜鸟,欢迎各位大神指出不足之处,万分感激。

 

 

  

  

 

  

 

  

推荐阅读