深入淺出Mybatis系列（一）---Mybatis入門

　　最近兩年 springmvc + mybatis 的在這種搭配還是蠻火的，樓主我呢，也從來沒真正去接觸過mybatis, 趁近日得閑， 就去學習一下mybatis吧。 本次擬根據自己的學習進度，做一次關於mybatis 的一系列教程， 記錄自己的學習歷程， 同時也給還沒接觸過mybatis的朋友探一次道。本系列教程擬 由淺（使用）入深（分析mybatis源碼實現），故可能需要好長幾天才能更新完。好啦，下面就開始本次的mybatis 學習之旅啦， 本次為第一篇教程， 就先簡單地寫個demo, 一起來認識一下mybatis吧。　　

　　為了方便，我使用了maven， 至於maven怎么使用， 我就不做介紹了。沒用過maven的， 也不影響閱讀。

一、Mybatis環境搭建及簡單實例

1. 新建web項目， 添加依賴包：mybatis包、數據庫驅動包(我使用的是mysql)、日志包(我使用的是log4j)， 由於我的是maven項目， 那么添加依賴包就簡單了，直接在pom.xml添加依賴即可。

pom.xml:

<dependencies>
      <!-- 添加junit -->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
    
    <!-- 添加log4j -->
    <dependency>
        <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
        <version>1.2.16</version>
    </dependency>
    
    <!-- 添加mybatis -->
    <dependency>
        <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
        <version>3.2.6</version>
    </dependency>
    
    <!-- 添加mysql驅動 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.12</version>
    </dependency>
    
  </dependencies>

2. 配置log4j, 配置mybatis

　　在classpath建立一個用於配置log4j的配置文件log4j.properties, 再建立一個用於配置Mybatis的配置文件configuration.xml（文件可隨便命名）。log4j的配置，我就不多說，這兒主要說一下configuration.xml:

configuration.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>

  <!-- 指定properties配置文件， 我這里面配置的是數據庫相關 -->
  <properties resource="dbConfig.properties"></properties>
  
  <!-- 指定Mybatis使用log4j -->
  <settings>
     <setting name="logImpl" value="LOG4J"/>
  </settings>
      
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
          <!--
          如果上面沒有指定數據庫配置的properties文件，那么此處可以這樣直接配置 
        <property name="driver" value="com.mysql.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/test1"/>
        <property name="username" value="root"/>
        <property name="password" value="root"/>
         -->
         
         <!-- 上面指定了數據庫配置文件， 配置文件里面也是對應的這四個屬性 -->
         <property name="driver" value="${driver}"/>
         <property name="url" value="${url}"/>
         <property name="username" value="${username}"/>
         <property name="password" value="${password}"/>
         
      </dataSource>
    </environment>
  </environments>
  
  <!-- 映射文件，mybatis精髓， 后面才會細講 -->
  <mappers>
    <mapper resource="com/dy/dao/userDao-mapping.xml"/>
  </mappers>
  
</configuration>

3. 開始寫Demo

　　首先，在mysql數據庫test1建立一張表user:

　　

　　然后，開始編寫java代碼。

　　看看我的項目結構：

　　

 

先編寫一個實體類User: User類用於與User表相對應。

User:

package com.dy.entity;

public class User {

    private int id;
    private String name;
    private String password;
    private int age;
    private int deleteFlag;
    
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
    public int getDeleteFlag() {
        return deleteFlag;
    }
    public void setDeleteFlag(int deleteFlag) {
        this.deleteFlag = deleteFlag;
    }
    
}

再編寫一個UserDao 接口：

UserDao:

package com.dy.dao;

import java.util.List;

import com.dy.entity.User;

public interface UserDao {

    public void insert(User user);
    
    public User findUserById (int userId);
    
    public List<User> findAllUsers();
    
}

再編寫一個userDao-mapping.xml （可隨便命名）:

userDao-mapping.xml:

<?xml version="1.0" encoding="UTF-8" ?>   
<!DOCTYPE mapper   
PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"  
"http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd"> 
<mapper namespace="com.dy.dao.UserDao">

   <select id="findUserById" resultType="com.dy.entity.User" > 
      select * from user where id = #{id}
   </select>

</mapper>

userDao-mapping.xml相當於是UserDao的實現， 同時也將User實體類與數據表User成功關聯起來。

4. 下面編寫junit測試代碼UserDaoTest：

　UserDaoTest:

　

public class UserDaoTest {

    @Test
    public void findUserById() {
        SqlSession sqlSession = getSessionFactory().openSession();  
        UserDao userMapper = sqlSession.getMapper(UserDao.class);  
        User user = userMapper.findUserById(2);  
        Assert.assertNotNull("沒找到數據", user);
    }
    
    //Mybatis 通過SqlSessionFactory獲取SqlSession, 然后才能通過SqlSession與數據庫進行交互
    private static SqlSessionFactory getSessionFactory() {  
        SqlSessionFactory sessionFactory = null;  
        String resource = "configuration.xml";  
        try {  
            sessionFactory = new SqlSessionFactoryBuilder().build(Resources  
                    .getResourceAsReader(resource));
        } catch (IOException e) {  
            e.printStackTrace();  
        }  
        return sessionFactory;  
    }  
    
}

 

好啦，這樣一個簡單的mybatis 的demo就能成功運行啦。通過這個demo, 應該你就也能初步看出mybatis的運行機制，如果不清楚，也沒關系。從下一篇文章開始，才開始正式講解mybatis。