MyBatis操作資料庫步驟
MyBatis框架的核心是SqlSessionFactory物件,從SqlSessionFactory類的名稱來看,它是用來建立SqlSession物件的工廠。但SqlSessionFactory物件的建立來自於SqlSessionFactoryBuilder類,也就是使用SqlSessionFactoryBuilder類建立SqlSessionFactory物件。使用SqlSessionFactoryBuilder類建立SqlSessionFactory物件的方式可以來自於一個XML配置檔案,也可來自於一個例項化的Configuation物件。
要使用 MyBatis, 只需將 mybatis的jar檔案置於 classpath 中即可。我們用maven來構建專案,我們以3.3.0版本為例。則需將下面的 dependency 程式碼置於 pom.xml 檔案中:
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.3.0</version>
</dependency>
專案結構如下:
使用XML配置檔案建立SqlSessionFactory物件
從 XML 檔案中構建 SqlSessionFactory 的例項非常簡單,建議使用類路徑下的資原始檔進行配置。但是也可以使用任意的輸入流(InputStream)例項,包括字串形式的檔案路徑或者 file:// 的 URL 形式的檔案路徑來配置。MyBatis 包含一個名叫 Resources 的工具類,它包含一些實用方法,可使從 classpath 或其他位置載入資原始檔更加容易。XML 配置檔案(configuration XML)中包含了對 MyBatis 系統的核心設定,包含獲取資料庫連線例項的資料來源(DataSource)和決定事務作用域和控制方式的事務管理器(TransactionManager)。在專案resources下新建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>
<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://127.0.0.1:3306/sample" />
<property name="username" value="root" />
<property name="password" value="123456" />
</dataSource>
</environment>
</environments>
</configuration>
下面獲取SqlSessionFactory工廠物件
package shan_mybatis_test;
import java.io.IOException;
import java.io.InputStream;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
public class Test {
public static void main(String[] args) {
String resource = "mybatis-config.xml";
try {
InputStream resourceAsStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
System.out.println(sqlSessionFactory);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
執行程式後沒有出現異常,輸出資訊如下:
到此,SqlSessionFactory物件成功的從xml配置檔案中建立
SqlSessionFactory 和 SqlSessionFactoryBuilder類的結構
SqlSessionFactory類的結構如下
SqlSessionFactoryBuilder類的結構如下
兩者的類結構中基本全是過載方法,主要是為了獲取SqlSessionFactory物件和SqlSession物件。
使用MyBatis Generator工具逆向
在eclipse中安裝MyBatis Generator逆向工具外掛
- 安裝介紹
進入頁面找到如下install按鈕
點選install進入下個頁面找到如下區域
紅色區域介紹如何安裝外掛到eclipse,就是點選並按住滑鼠按鈕,拖動安裝按鈕圖示在Eclipse工作區,然後在工作區釋放按鈕就會彈出如下視窗
等外掛下載完以後接受安裝協議進行確認安裝。安裝完成後重啟eclipse。
重啟後新建普通java專案MybatisGeneratorJava然後選中src右擊新建一個MyBatis生成ORM檔案的配置檔案。
點選next會出現保持預設不需要修改然後finish.
此時專案中會生成一個generatorConfig.xml配置檔案,修改檔案配置如下
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN" "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
<context id="context1">
<jdbcConnection connectionURL="jdbc:mysql://localhost:3306/sample"
driverClass="com.mysql.jdbc.Driver" password="123456" userId="root" />
<javaModelGenerator targetPackage="com.user.pojo"
targetProject="MybatisGeneratorJava" />
<sqlMapGenerator targetPackage="com.user.mapper"
targetProject="MybatisGeneratorJava" />
<javaClientGenerator targetPackage="com.user.mapper"
targetProject="MybatisGeneratorJava" type="XMLMAPPER" />
<table schema="" tableName="user">
<!-- <columnOverride column="???" property="???" /> -->
</table>
</context>
</generatorConfiguration>
- 需要在逆向專案中新增sql的驅動包
這個檔案是MyBatis Generator外掛必備的檔案通過此檔案可以從資料表的結構逆向出對應的java類和mapper。在資料庫中建立user表。
準備完成後,選擇generatorConfig.xml檔案點選Generate MyBatis/iBATIS Artifacts,便會生成ORM對映檔案
專案結構如圖
把com.user包中的內容複製到專案的src目錄中,結構如下
至此,Mybatis的基礎類檔案已經準備完畢。
使用SqlSession物件在MySql資料庫中新建記錄
下面就開始把一條記錄插入user資料表中吧。在專案的resource目錄下建立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>
<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://127.0.0.1:3306/sample" />
<property name="username" value="root" />
<property name="password" value="123456" />
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/user/mapper/UserMapper.xml"/>
</mappers>
</configuration>
接下來用Junit進行一下簡單的測試,在pom檔案中引入junit的dependency,當然不要忘記引入mysql驅動的dependency。pom檔案如下
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.shan</groupId>
<artifactId>shan_mybatis_test</artifactId>
<version>0.0.1-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.3.0</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.32</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
然後在src/test/java目錄下新建com.user.test包然後新建測試類TestCase.java程式碼如下
package com.user.test;
import java.io.IOException;
import java.io.InputStream;
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.junit.Before;
import org.junit.Test;
import com.user.pojo.User;
public class TestCase {
private static SqlSession sqlSession;
@Before
public void before(){
String resource = "mybatis-config.xml";
try {
InputStream resourceAsStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
sqlSession = sqlSessionFactory.openSession();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
@Test
public void addInfo(){
User user = new User();
user.setUsername("test");
user.setPassword("123456");
sqlSession.insert("insert", user);
sqlSession.commit();
sqlSession.close();
}
}
執行junit測試方法,成功的在資料庫中填入一條資料。
注意事項
- 注意事項
- 如果使用的是sqlserver資料庫,MyBatis不能識別user表中主鍵id的自增情況,解決辦法是在用逆向工程生成程式碼的generatorConfig.xml的配置中修改如下程式碼
<table schema="" tableName="user">
<generatedKey column="id" sqlStatement="sqlserver" identity="true"></generatedKey>
<!-- <columnOverride column="???" property="???" /> -->
</table>
- 如果使用的是oracle資料庫,由於oracle資料庫使用序列來獲取ID主鍵值,因此需要在用逆向工程生成程式碼的generatorConfig.xml的配置中修改如下程式碼
<table schema="" tableName="user">
<generatedKey column="id" sqlStatement="select idauto.nextval from dual" identity="false"></generatedKey>
</table>