MyBatis學習筆記(一)——MyBatis快速入門

一、Mybatis介紹

　　

　　MyBatis是一個支持普通SQL查詢，存儲過程和高級映射的優秀持久層框架。MyBatis消除了幾乎所有的JDBC代碼和參數的手工設置以及對結果集的檢索封裝。MyBatis可以使用簡單的XML或註解用於配置和原始映射，將接口和Java的POJO（Plain Old Java Objects，普通的Java對象）映射成數據庫中的記錄。

二、mybatis快速入門

2.1、準備開發環境

 1、創建測試項目，普通java項目或者是JavaWeb項目均可，如下圖所示：

2、添加相應的jar包

　　【mybatis】

       　　mybatis-3.1.1.jar

　　【MYSQL驅動包】
　　　　mysql-connector-java-5.1.7-bin.jar

3、創建數據庫和表，針對MySQL數據庫

　　SQL腳本如下：

create database mybatis;
use mybatis;
CREATE TABLE users(id INT PRIMARY KEY AUTO_INCREMENT, NAME VARCHAR(20), age INT);
INSERT INTO users(NAME, age) VALUES('TOM', 12);
INSERT INTO users(NAME, age) VALUES('Jack', 27);

     將SQL腳本在MySQL數據庫中執行，完成創建數據庫和表的操作

     到此，前期的開發環境準備工作全部完成。

2.2、使用MyBatis查詢表中的數據

　　1、添加Mybatis的配置文件conf.xml

　　在src目錄下創建一個conf.xml文件，如下圖所示：

conf.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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC" />
            <!-- 配置數據庫連接信息 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
                <property name="username" value="root" />
                <property name="password" value="root1234" />
            </dataSource>
        </environment>
    </environments>     
</configuration>

2、定義表所對應的實體類，如下圖所示：

User代碼如下：

package com.superman.domain;

/**
 * users表所對應的實體類
 * @author Administrator
 *
 */
public class User {
	
	//實體類的屬性和表的字段名稱一一對應
	private int id;
	private String name;
	private int age;
	
	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 int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
	
	public User(int id, String name, int age) {
		super();
		this.id = id;
		this.name = name;
		this.age = age;
	}
	public User() {
		super();
	}
	
	@Override
	public String toString() {
		return "User [id=" + id + ", name=" + name + ", age=" + age + "]";
	}
	
}

3、定義操作users表的sql映射文件userMapper.xml

　　創建一個com.superman.mapping包，專門用於存放sql映射文件，在包中創建一個userMapper.xml文件，如下圖所示：

userMapper.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.superman.userMapper"就是com.superman.mapping(包名)+userMapper(userMapper.xml文件去除後綴)
 -->
<mapper namespace="com.superman.mapping.userMapper">
    <!-- 在select標籤中編寫查詢的SQL語句， 設置select標籤的id屬性爲getUser，id屬性值必須是唯一的，不能夠重複
    使用parameterType屬性指明查詢時使用的參數類型，resultType屬性指明查詢返回的結果集類型
    resultType="com.superman.domain.User"就表示將查詢結果封裝成一個User類的對象返回
    User類就是users表所對應的實體類
    -->
    <!-- 
        根據id查詢得到一個user對象
     -->
    <select id="getUser" parameterType="int" 
        resultType="com.superman.domain.User">
        select * from users where id=#{id}
    </select>
</mapper>

4、在conf.xml文件中註冊userMapper.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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC" />
            <!-- 配置數據庫連接信息 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
                <property name="username" value="root" />
                <property name="password" value="root234" />
            </dataSource>
        </environment>
    </environments>
    
    <mappers>
        <!-- 註冊userMapper.xml文件， 
        userMapper.xml位於com.superman.mapping這個包下，所以resource寫成com/superman/mapping/userMapper.xml-->
        <mapper resource="com/superman/mapping/userMapper.xml"/>
    </mappers>
    
</configuration>

5、編寫測試代碼：執行定義的select語句

創建一個Test類

編寫如下的測試代碼：

package com.superman.mapping;

import java.io.IOException;
import java.io.InputStream;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import com.superman.domain.User;

public class Test {

    public static void main(String[] args) throws IOException {
        //mybatis的配置文件
        String resource = "conf.xml";
        //使用類加載器加載mybatis的配置文件（它也加載關聯的映射文件）
        InputStream is = Test.class.getClassLoader().getResourceAsStream(resource);
        //構建sqlSession的工廠
        SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
        //使用MyBatis提供的Resources類加載mybatis的配置文件（它也加載關聯的映射文件）
        //Reader reader = Resources.getResourceAsReader(resource); 
        //構建sqlSession的工廠
        //SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
        //創建能執行映射文件中sql的sqlSession
        SqlSession session = sessionFactory.openSession();
        /**
         * 映射sql的標識字符串，
         * com.superman.mapping.userMapper是userMapper.xml文件中mapper標籤的namespace屬性的值，
         * getUser是select標籤的id屬性值，通過select標籤的id屬性值就可以找到要執行的SQL
         */
        String statement = "com.superman.mapping.userMapper.getUser";//映射sql的標識字符串
        //執行查詢返回一個唯一user對象的sql
        User user = session.selectOne(statement, 1);
        System.out.println(user);
    }
}

執行結果如下：

可以看到，數據庫中的記錄已經成功查詢出來了。