MyBatis框架介绍及其实操

 

　　一、基本概念和介绍

 

---

 

　　数据持久化的概念

　　数据持久化是将内存中的数据模型转换为存储模型，以及将存储模型转换为内存中的数据模型的统称。例如，文件的存储、数据的读取等都是数据持久化操作。数据模型可以是任何数据结构或对象模型、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、数据库用户名和密码。

<?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>
  <!-- 引入外部mysql配置文件 -->
  <properties resource="mysql.properties"></properties>
   
   <!-- 配置mybatis的log实现为log4j -->
   <settings>
       <setting name="logImpl" value="LOG4J"/>
   </settings>
   
   <!-- 为JAVA Bean起类别名 -->
   <typeAliases>
       <!-- 别名方式，自动扫描，将JAVA类的类名作为类的类别名 -->
         <package name="com.ydy.entiy"/> 
   </typeAliases>
   
   <!-- 配置mybatis运行环境 -->
     <environments default="development">
        <environment id="development">
            <!-- type="JDBC" 代表使用JDBC的事务管理 -->
            <transactionManager type="JDBC" />
            
            <!-- mybatis提供了3种数据源类型，分别是：POOLED,UNPOOLED,JNDI -->
            <!-- POOLED 表示支持JDBC数据源连接池 -->
            <!-- UNPOOLED 表示不支持数据源连接池 -->
            <!-- JNDI 表示支持外部数据源连接池 -->
            <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> 
</configuration>

　　

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

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

 

　　

 

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

package com.ydy.entiy;

import java.io.Serializable;

public class Student implements Serializable{
    
    /**
     * 
     */
    private static final long serialVersionUID = 1L;
    private int Id;
    private String Name;
    private int Age;
    private String Gender;
    public Student(String name, int age, String gender) {
        super();
        Name = name;
        Age = age;
        Gender = gender;
    }
    public Student(int id, String name, int age, String gender) {
        super();
        Id = id;
        Name = name;
        Age = age;
        Gender = gender;
    }
    public String toString() {
        return "Student [Id=" + Id + ", Name=" + Name + ", Age=" + Age + ", Gender=" + Gender + "]";
    }
    public int getId() {
        return Id;
    }
    public void setId(int id) {
        Id = id;
    }
    public String getName() {
        return Name;
    }
    public void setName(String name) {
        Name = name;
    }
    public int getAge() {
        return Age;
    }
    public void setAge(int age) {
        Age = age;
    }
    public String getGender() {
        return Gender;
    }
    public void setGender(String gender) {
        Gender = gender;
    }
    
    
}

 

　　6.定义接口方法studentMapper.java　

package com.ydy.mapper;

import java.util.List;

import com.ydy.entiy.Student;

public interface studentMapper {
    /**
     * 定义四个方法，增删改查，其中的增删改成功的话会返回1，查询的是所有，故使用List来接收
     * @param student
     * @return
     * @throws Exception
     */
    
    public int insertStudent(Student student)throws Exception;;
    
    public int updateStudent(Student student)throws Exception;;
    
    public List<Student> selectAllUser()throws Exception;; 
    
    public int deleteStudent(int id)throws Exception;;
    
}

 

　　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映射文件引入

<?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>
  <!-- 引入外部mysql配置文件 -->
  <properties resource="mysql.properties"></properties>
   
   <!-- 配置mybatis的log实现为log4j -->
   <settings>
       <setting name="logImpl" value="LOG4J"/>
   </settings>
   
   <!-- 为JAVA Bean起类别名 -->
   <typeAliases>
       <!-- 别名方式，自动扫描，将JAVA类的类名作为类的类别名 -->
         <package name="com.ydy.entiy"/> 
   </typeAliases>
   
   <!-- 配置mybatis运行环境 -->
     <environments default="development">
        <environment id="development">
            <!-- type="JDBC" 代表使用JDBC的事务管理 -->
            <transactionManager type="JDBC" />
            
            <!-- mybatis提供了3种数据源类型，分别是：POOLED,UNPOOLED,JNDI -->
            <!-- POOLED 表示支持JDBC数据源连接池 -->
            <!-- UNPOOLED 表示不支持数据源连接池 -->
            <!-- JNDI 表示支持外部数据源连接池 -->
            <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> 
    <!-- 把studentMapper文件引入 -->
    <mappers>
        <mapper resource="com/ydy/mapper/studentMapper.xml"/>
    </mappers>
</configuration>

 

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

package tools;

import java.io.Reader;

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 com.sun.corba.se.spi.orbutil.fsm.State;

public class myBatisTool {
    public static SqlSessionFactory sqlSessionFactory;
    static{
        
            //使用MyBatis提供的Resources类加载mybatis的配置文件
            try{
                Reader config=Resources.getResourceAsReader("mybatis.config.xml");
            
            //构造SqlSession的工厂
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(config);
            }catch (Exception e){
                e.printStackTrace();
            }
    }
        ////创建能执行映射文件中sql的sqlSession对象
        public static SqlSession getSession(){
            return sqlSessionFactory.openSession();
        }
    
}

 

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

package service;

import org.apache.ibatis.session.SqlSession;

import com.ydy.entiy.Student;
import com.ydy.mapper.studentMapper;

import tools.myBatisTool;

public class studentService {
    
    public static void main(String[] args) {
        insertStudent();
        //updateStudent();
        //selectAllStudent();
        //deleteStudent();
    }
    /**
     * 新增学生记录
     */
    private static void insertStudent() {
        //利用SqlSession对象来执行SQL语句
        SqlSession session=myBatisTool.getSession();
        studentMapper mapper=session.getMapper(studentMapper.class);
        Student student=new Student(1,"张三",21,"男");
        try{
        mapper.insertStudent(student);
        System.out.println(student.toString());
        session.commit();
        }catch (Exception e){
            e.printStackTrace();
            
        }finally {
            session.close();
        }
    }
    /**
     * 查询学生记录
     */
    private static void selectAllStudent() {
        // TODO Auto-generated method stub
        
    }
    /**
     * 更新学生记录
     */
    private static void updateStudent() {
        // TODO Auto-generated method stub
        
    }
    /**
     * 删除学生记录
     */
    private static void deleteStudent() {
        // TODO Auto-generated method stub
        
    }
}

　

　　　控制台的结果

　　

　　　　数据库的结果

　　

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

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

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

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