在上一篇部落格中，我們已經把所有的準備工作做好了，包括資料庫和mybatis下載等，接下我們進入一個實際的案例，來理解mybatis是如何工作的。

1、新建專案

這裡使用的軟體是IDEA，這個無關緊要，我們首先建立一個Java專案，工程最後的結構如下所示，我們將先前的mybatis的jar包（包括lib檔案下的jar包）和java連線sqlite資料庫的jar包，拷貝到lib資料夾中。

2、定義一個實體POJO

首先我們我們需要定義一個實體POJO，這個實體就是我們之前在資料庫中建立的student表。

package com.pojo;

public class Student {
    private int ID;
    private String Name;
    private String Sex;
    private float Grade;

    public int getID() {
        return ID;
    }

    public void setID(int ID) {
        this.ID = ID;
    }

    public String getName() {
        return Name;
    }

    public void setName(String name) {
        Name = name;
    }

    public String getSex() {
        return Sex;
    }

    public void setSex(String sex) {
        Sex = sex;
    }

    public float getGrade() {
        return Grade;
    }

    public void setGrade(float grade) {
        Grade = grade;
    }
}
 

3、編寫配置檔案

3.1  log4j配置檔案

這個配置檔案主要是用來輸出日誌資訊的，我們在系統目錄下新建一個log4j.properties檔案，裡面的內容如下：

log4j.rootLogger=DEBUG,stdout
log4j.logger.org.mybatis=DEBUG
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p %d %c: %m%n
 

3.2 基礎配置檔案

基礎配置檔案在mybatis專案中通常只有一個，主要用來配置一些最基本的上下文引數和執行環境，比如資料庫的基本資訊等。我們新建一個mybatis-config.xml檔案，裡面內容如下：

<?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>
    <typeAliases>
        <!--別名-->
        <typeAlias type="com.pojo.Student" alias="student"/>
    </typeAliases>
    <!--資料庫環境-->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"></transactionManager>
            <dataSource type="POOLED">
                <property name="driver" value="org.sqlite.JDBC"/>
                <property name="url" value="jdbc:sqlite:C:\\Users\\YZL\\test1.db"/>

                <!--
                由於我們使用的是sqlite資料庫，開源免費的sqlite資料庫是不需要使用者名稱和密碼的
                ，我們這裡就不需要這兩個屬性
                <property name="username" value=""/>
                <property name="password" value=""/>
                -->
            </dataSource>
        </environment>
    </environments>
    <!--對映檔案-->
    <mappers>
        <mapper resource="com/mapper/StudentMapper.xml"/>
    </mappers>
</configuration>
 

解釋一下這個基礎配置檔案：

<typeAliases> 元素的定義了一個別名student，它代表的是com.pojo.Student這個類，這樣我們在後面就可以直接使用student別名去使用這個類了。

<environments> 元素裡面描述的連線資料庫的引數。

<mapper> 元素的作用是引入那些對映器。

3.3 對映器

在編寫對映器配置檔案之前，我們首先編寫一個對映器介面StudentMapper，這個介面很簡單，就只有一個方法。

package com.mapper;

import com.pojo.Student;
public interface StudentMapper {
    public Student getStudentById(int id);
}

然後新建一個對映器檔案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="com.mapper.StudentMapper">
    <select id="getStudentById" resultType="student" parameterType="int">
        select ID,Name,Sex,Grade from student where id=#{id}
    </select>
</mapper>

對這個對映器檔案解釋一下：

<mapper> 元素的namespace屬性的值是一個java介面的全限定名。

<select> 元素裡面是一條查詢語句，id屬性標識這條sql語句，resultType表示返回結果型別，parameterType表示引數型別。這裡的student就是之前的基礎配置檔案的配置的別名。

#{id} 表示傳遞進去的引數.。

上面的基礎配置檔案引入的就是這個檔案。

4、測試 

接下來，我們就可以新建一個測試類，測試一下，首先說明一下mybatis的執行的步驟：

1. 首先利用構造器SqlSessionFactoryBuilder通過程式碼或者配置檔案的方式來生成一個SqlSessionFactory；
2. 依靠上面的SqlSessionFactory來獲取一個SqlSession；
3. 一個SqlSession既可以直接傳送sql請求，也可以通過對映器介面獲取一個Mapper介面，然後通過Mapper去傳送sql請求（我們這裡採用的是第二種方式）；

下面貼上測試的Test類程式碼

package com.main;

import com.mapper.StudentMapper;
import com.pojo.Student;
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 org.apache.log4j.Logger;


import java.io.InputStream;


public class Test {
    public static void main(String[] args) {
        Logger log=Logger.getLogger(Test.class);

        SqlSessionFactory sqlSessionFactory=null;
        String resource="mybatis-config.xml";
        InputStream inputStream;
        SqlSession sqlSession=null;
        try {
            inputStream = Resources.getResourceAsStream(resource);

            //獲取一個sqlSessionFactory
            sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
            //通過sqlSessionFactory獲取一個sqlSession
            sqlSession=sqlSessionFactory.openSession();

            //根據對映器介面獲取一個對映器
            StudentMapper studentMapper=sqlSession.getMapper(StudentMapper.class);
            //呼叫對映器中的getStudentById()方法，1為引數，返回型別是一個
            Student student=studentMapper.getStudentById(1);

            System.out.println("id: "+student.getID()+"  name: "+student.getName()+
            " sex: "+student.getSex()+" grade: "+student.getGrade());

        }catch (Exception e){
            e.printStackTrace();
        }finally {
            if(sqlSession!=null)
                sqlSession.close();
        }
    }
}

我們看一下最後的輸出結果

至此，mybatis的入門例項已經完成。