MyBatis框架介紹及實戰操作

Java_老男孩發表於2019-04-18
MyBatis框架

一、基本概念和介紹

  資料持久化的概念

  資料持久化是將記憶體中的資料模型轉換為儲存模型，以及將儲存模型轉換為記憶體中的資料模型的統稱。例如，檔案的儲存、資料的讀取等都是資料持久化操作。資料模型可以是任何資料結構或物件模型、XML、二進位制流等。

  當我們編寫應用程式運算元據庫，對錶資料進行增刪改查的操作的時候就是資料持久化的操作。

  Mybatis框架簡介

MyBatis框架是一個開源的資料持久層框架。它的內部封裝了通過JDBC訪問資料庫的操作，支援普通的SQL查詢、儲存過程和高階對映，幾乎消除了所有的JDBC程式碼和引數的手工設定以及結果集的檢索。MyBatis作為持久層框架，其主要思想是將程式中的大量SQL語句剝離出來，配置在配置檔案當中，實現SQL的靈活配置。這樣做的好處是將SQL與程式程式碼分離，可以在不修改程式碼的情況下，直接在配置檔案當中修改SQL。

  ORM

  ORM（Object/Relational Mapping）即物件關係對映，是一種資料持久化技術。它在物件模型和關係型資料庫直接建立起對應關係，並且提供一種機制，通過JavaBean物件去運算元據庫表的資料，如下圖。

MyBatis框架介紹及實戰操作

  在我們實際的開發當中，我們使用物件的技術運算元據庫，而當儲存資料時，使用的卻是關係型資料庫，這樣造成了很多的不便。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了，但是表示空的。

MyBatis框架介紹及實戰操作

  2.下載MyBatis需要的jar檔案

  通過github下載，下載地址是 github.com/mybatis/myb…，我選擇的是3.4.5的版本，注意要根據自己的jdk來選擇，可能高版本的不符合。

 下載mysql資料庫驅動jar檔案，下載地址是 central.maven.org/maven2/mysq…

  3.在Eclipse中新建JavaWeb專案，在lib目錄下匯入下載好的jar

MyBatis框架介紹及實戰操作

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> 
    <!-- 把studentMapper檔案引入 -->
    <mappers>
        <mapper resource="com/ydy/mapper/studentMapper.xml"/>
    </mappers>
</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
        
    }
}
複製程式碼

控制檯的結果

  

MyBatis框架介紹及實戰操作

  資料庫的結果

  

MyBatis框架介紹及實戰操作

 上述的是執行新增的結果，其他的功能也是類似。這裡就不多說了。記錄一下我遇到的問題吧。

  （1）在mybatis-config.xml檔案當中標籤的順序是有要求的，不能亂寫。

  （2）在mysql.properties檔案當中記得加上編碼方式，不然插入到資料庫會亂碼。

相關文章