走進JavaWeb技術世界14：經過項目逐步深刻了解Mybatis（一）

時間 2020-12-01

標籤前端 java mysql git 程序員 github 面試算法 spring sql 欄目 Java 简体版

原文原文鏈接

經過項目逐步深刻了解Mybatis（一）

2017-06-12/)前端

文章導航java

Mybatis 和 SpringMVC 經過訂單商品案例驅動mysql

官方中文地址：http://www.mybatis.org/mybatis-3/zh/git

官方託管地址：https://github.com/mybatis/mybatis-3程序員

本項目所有代碼地址：https://github.com/zhisheng17/mybatisgithub

若是以爲不錯的話，歡迎給個 star ，若是你想完善這個項目的話，你也能夠 fork 後修改而後推送給我。

基礎知識：

對原生態 jdbc 程序（單獨使用 jdbc 開發）問題總結

一、環境

java 環境：jdk1.8.0_77面試

開發工具： IDEA 2016.1算法

數據庫： MySQL 5.7spring

二、建立數據庫

mybatis_test.sqlsql

Tables ：items、orderdetail、orders、user

三、JDBC 程序

使用 JDBC 查詢 MySQL 數據庫中用戶表的記錄

代碼：

394041424344454647484950515253545556575859606162636465666768697071727374757677787980 package cn.zhisheng.mybatis.jdbc;/** * Created by 10412 on 2016/11/27. */import java.sql.*;/** *經過單獨的jdbc程序來總結問題 */public class JdbcTest{ public static void main(String[] args) { //數據庫鏈接 Connection connection = null; //預編譯的Statement，使用預編譯的Statement能夠提升數據庫性能 PreparedStatement preparedStatement = null; //結果集 ResultSet resultSet = null; try { //加載數據庫驅動 Class.forName("com.mysql.jdbc.Driver"); //經過驅動管理類獲取數據庫連接 connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis_test?characterEncoding=utf-8", "root", "root"); //定義sql語句 ?表示佔位符（在這裏表示username） String sql = "select * from user where username = ?"; //獲取預處理statement preparedStatement = connection.prepareStatement(sql); //設置參數，第一個參數爲sql語句中參數的序號（從1開始），第二個參數爲設置的參數值 preparedStatement.setString(1, "王五"); //向數據庫發出sql執行查詢，查詢出結果集 resultSet = preparedStatement.executeQuery(); //遍歷查詢結果集 while(resultSet.next()) { System.out.println(resultSet.getString("id")+" "+resultSet.getString("username")); } } catch (Exception e) { e.printStackTrace(); }finally{ //釋放資源 if(resultSet!=null) { try { resultSet.close(); } catch (SQLException e) { // TODO Auto-generated catch block e.printStackTrace(); } } if(preparedStatement!=null) { try { preparedStatement.close(); } catch (SQLException e) { // TODO Auto-generated catch block e.printStackTrace(); } } if(connection!=null) { try { connection.close(); } catch (SQLException e) { // TODO Auto-generated catch block e.printStackTrace(); } } } }}

四、問題總結

數據庫鏈接，使用時就建立，不使用當即釋放，對數據庫頻繁鏈接開啓和關閉，形成數據庫資源的浪費，影響數據庫性能。
解決方法：使用數據庫鏈接池管理數據庫鏈接。

將 sql 語句硬編碼到 java 代碼中，若是 sql 語句須要修改，那麼就須要從新編譯 java 代碼，不利於系統的維護。
設想：將 sql 語句配置在 xml 配置文件中，即便 sql 語句發生變化，也不須要從新編譯 java 代碼。

向 preparedStatement 中設置參數，對佔位符號位置和設置參數值，硬編碼在 java 代碼中，一樣也不利於系統的維護。
設想：將 sql 語句、佔位符、參數值配置在 xml 配置文件中。

從 resultSet 中遍歷結果集數據時，存在硬編碼，將獲取表的字段進行硬編碼，不利於系統維護。
設想：將查詢的結果集自動映射成 java 對象。

Mybatis框架原理（掌握）

一、Mybatis 是什麼？

Mybatis 是一個持久層的架構，是 appach 下的頂級項目。

Mybatis 原先是託管在 googlecode 下，再後來是託管在 Github 上。

Mybatis 讓程序員將主要的精力放在 sql 上，經過 Mybatis 提供的映射方式，自由靈活生成（半自動，大部分須要程序員編寫 sql ）知足須要 sql 語句。

Mybatis 能夠將向 preparedStatement 中的輸入參數自動進行輸入映射，將查詢結果集靈活的映射成 java 對象。（輸出映射）

二、Mybatis 框架

註解：

SqlMapConfig.xml （Mybatis的全局配置文件，名稱不定）配置了數據源、事務等 Mybatis 運行環境

Mapper.xml 映射文件（配置 sql 語句）

SqlSessionFactory （會話工廠）根據配置文件配置工廠、建立 SqlSession

SqlSession （會話）面向用戶的接口、操做數據庫（發出 sql 增刪改查）

Executor （執行器）是一個接口（基本執行器、緩存執行器）、SqlSession 內部經過執行器操做數據庫

Mapped Statement （底層封裝對象）對操做數據庫存儲封裝，包括 sql 語句、輸入參數、輸出結果類型

Mybatis入門程序

一、需求

實現如下功能：

根據用戶id查詢一個用戶信息

根據用戶名稱模糊查詢用戶信息列表

添加用戶

更新用戶

刪除用戶

二、環境

java 環境：jdk1.8.0_77

開發工具： IDEA 2016.1

數據庫： MySQL 5.7

Mybatis 運行環境（ jar 包）

MySQL 驅動包

其餘依賴包

三、 log4j.properties

在classpath下建立log4j.properties以下：

`1234567`	`# Global logging configuration#在開發環境日誌級別要設置爲DEBUG、生產環境要設置爲INFO或者ERRORlog4j.rootLogger=DEBUG, stdout# Console output...log4j.appender.stdout=org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.layout=org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n`

Mybatis默認使用log4j做爲輸出日誌信息。

四、工程結構

五、SqlMapConfig.xml

配置 Mybatis 的運行環境、數據源、事務等

1011121314151617181920 <?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_test?characterEncoding=utf-8" /> <property name="username" value="root" /> <property name="password" value="root" /> </dataSource> </environment> </environments></configuration>

六、建立 po 類

Po 類做爲 mybatis 進行 sql 映射使用，po 類一般與數據庫表對應，User.java 以下：

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657 package cn.zhisheng.mybatis.po;import java.util.Date;/** * Created by 10412 on 2016/11/28. */public class User{ private int id; private String username; // 用戶姓名 private String sex; // 性別 private Date birthday; // 生日 private String address; // 地址 //getter and setter public int getId() { return id; } public void setId(int id) { this.id = id; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public Date getBirthday() { return birthday; } public void setBirthday(Date birthday) { this.birthday = birthday; } public String getSex() { return sex; } public void setSex(String sex) { this.sex = sex; } public String getAddress() { return address; } public void setAddress(String address) { this.address = address; }}

七、根據用戶 id（主鍵）查詢用戶信息

映射文件

User.xml（原在 Ibatis 中命名）在 Mybatis 中命名規則爲 xxxmapper.xml

在映射文件中配置 sql 語句

User.xml

`123456`	`<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="test"></mapper>`

namespace ：命名空間，對 sql 進行分類化管理，用於隔離 sql 語句，後面會講另外一層很是重要的做用。

在 User.xml 中加入

23456789101112  <select id="findUserById" parameterType="int" resultType="cn.zhisheng.mybatis.po.User"> select * from user where id = #{id} </select>

User.xml 映射文件已經徹底寫好了，那接下來就須要在 SqlMapConfig.xml中加載映射文件 User.xml

`1234`	`<!--加載映射文件--> <mappers> <mapper resource="sqlmap/User.xml"/> </mappers>`

編寫程序
MybatisFirst.java

22324252627282930313233343536373839404142434445 package cn.zhisheng.mybatis.first;import cn.zhisheng.mybatis.po.User;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.Test;import java.io.IOException;import java.io.InputStream; /*** Created by 10412 on 2016/11/28.*/public class MybatisFirst{ //根據id查詢用戶信息，獲得用戶的一條記錄 @Test public void findUserByIdTest() throws IOException { //Mybatis 配置文件 String resource = "SqlMapConfig.xml"; //獲得配置文件流 InputStream inputStream = Resources.getResourceAsStream(resource); //建立會話工廠,傳入Mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //經過工廠獲得SqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //經過SqlSession操做數據庫 //第一個參數：映射文件中Statement的id，等於 = namespace + "." + Statement的id //第二個參數：指定和映射文件中所匹配的parameterType類型的參數 //sqlSession.selectOne 結果與映射文件中所匹配的resultType類型的對象 User user = sqlSession.selectOne("test.findUserById", 1); System.out.println(user); //釋放資源 sqlSession.close(); }}

而後運行一下這個測試，發現結果以下就表明能夠了：

八、根據用戶名稱模糊查詢用戶信息列表

映射文件

依舊使用 User.xml 文件，只不過要在原來的文件中加入

123456789  <select id="findUserByUsername" parameterType="java.lang.String" resultType="cn.zhisheng.mybatis.po.User"> select * from user where username like '%${value}%' </select>

編寫程序

依舊直接在剛纔那個 MybatisFirst.java 中加入測試代碼：

3141516171819202122232425262728 //根據用戶名稱模糊查詢用戶信息列表 @Test public void findUserByUsernameTest() throws IOException { //Mybatis 配置文件 String resource = "SqlMapConfig.xml"; //獲得配置文件流 InputStream inputStream = Resources.getResourceAsStream(resource); //建立會話工廠,傳入Mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //經過工廠獲得SqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //經過SqlSession操做數據庫 //第一個參數：映射文件中Statement的id，等於 = namespace + "." + Statement的id //第二個參數：指定和映射文件中所匹配的parameterType類型的參數 //selectList 查詢結果可能多條 //list中的user和映射文件中resultType所指定的類型一致 List<User> list = sqlSession.selectList("test.findUserByUsername", "小明"); System.out.println(list); //釋放資源 sqlSession.close(); }

一樣測試一下findUserByUsernameTest ，若是運行結果以下就表明沒問題：

提示：

經過這個代碼能夠發現，其中有一部分代碼是冗餘的，咱們能夠將其封裝成一個函數。

`1234567`	`public void createSqlSessionFactory() throws IOException { // 配置文件 String resource = "SqlMapConfig.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); // 使用SqlSessionFactoryBuilder從xml配置文件中建立SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); }`

注意：

一、#{ } 和 ${ } 的區別

#{ }表示一個佔位符號，經過#{ }能夠實現 preparedStatement 向佔位符中設置值，自動進行java 類型和 jdbc 類型轉換，#{ } 能夠有效防止sql注入。#{ } 能夠接收簡單類型值或 pojo 屬性值（經過 OGNL 讀取對象中的值，屬性.屬性.屬性..方式獲取對象屬性值）。若是 parameterType 傳輸單個簡單類型值，#{ }括號中能夠是 value 或其它名稱。

${ } 表示拼接 sql 串，經過${ }能夠將 parameterType 傳入的內容拼接在 sql 中且不進行 jdbc 類型轉換， ${ }能夠接收簡單類型值或 pojo 屬性值（（經過 OGNL 讀取對象中的值，屬性.屬性.屬性..方式獲取對象屬性值）），若是 parameterType 傳輸單個簡單類型值，${}括號中只能是 value。

二、parameterType 和 resultType 區別

parameterType：指定輸入參數類型，mybatis 經過 ognl 從輸入對象中獲取參數值拼接在 sql 中。

resultType：指定輸出結果類型，mybatis 將 sql 查詢結果的一行記錄數據映射爲 resultType 指定類型的對象。

三、selectOne 和 selectList 區別

selectOne 查詢一條記錄來進行映射，若是使用selectOne查詢多條記錄則拋出異常：
org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to bereturned by selectOne(), but found: 3 at

selectList 能夠查詢一條或多條記錄來進行映射。

九、添加用戶

映射文件

在 User.xml 中加入：

`12345678`	`<!-- 添加用戶 --> <insert id="insetrUser" parameterType="cn.zhisheng.mybatis.po.User" > <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer"> select LAST_INSERT_ID() </selectKey> insert into user(username, birthday, sex, address) values(#{username}, #{birthday}, #{sex}, #{address}) </insert>`

注意:

selectKey將主鍵返回，須要再返回

添加selectKey實現將主鍵返回

keyProperty:返回的主鍵存儲在pojo中的哪一個屬性

order：selectKey的執行順序，是相對與insert語句來講，因爲mysql的自增原理執行完insert語句以後纔將主鍵生成，因此這裏selectKey的執行順序爲after

resultType:返回的主鍵是什麼類型

LAST_INSERT_ID():是mysql的函數，返回auto_increment自增列新記錄id值。

而後在 MybatisFirst.java 中寫一個測試函數，代碼以下

1112131415161718192021 @Test public void insetrUser() throws IOException, ParseException { //Mybatis 配置文件 String resource = "SqlMapConfig.xml"; //獲得配置文件流 InputStream inputStream = Resources.getResourceAsStream(resource); //建立會話工廠,傳入Mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //經過工廠獲得SqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); User user = new User(); SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd"); user.setUsername("田志聲"); user.setSex("男"); user.setBirthday(sdf.parse("2016-11-29")); user.setAddress("江西南昌"); sqlSession.insert("test.insetrUser", user); sqlSession.commit(); //釋放資源 sqlSession.close(); }

而後 run 一下，若是出現的結果以下，那麼就是成功了。

同時數據庫也能查詢到剛插入的用戶信息：

十、自增主鍵返回與非自增主鍵返回

MySQL 自增主鍵：執行 insert 提交以前自動生成一個自增主鍵，經過 MySQL 函數獲取到剛插入記錄的自增主鍵： LAST_INSERT_ID() ，是在 insert 函數以後調用。

非自增主鍵返回：使用 MySQL 的 uuid() 函數生成主鍵，須要修改表中 id 字段類型爲 String ，長度設置爲 35 位，執行思路：先經過 uuid() 查詢到主鍵，將主鍵輸入到 sql 語句中；執行 uuid() 語句順序相對於 insert 語句以前執行。

剛纔那個插入用戶的地方，其實也能夠經過 uuid() 來生成主鍵，若是是這樣的話，那麼咱們就須要在 User.xml 中加入以下代碼：

123456789 <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String"> select uuid()</selectKey>insert into user(id, username, birthday, sex, address) values(#{id}, #{username}, #{birthday}, #{sex}, #{address})

Oracle 使用序列生成主鍵

首先自定義一個序列且用於生成主鍵，selectKey使用以下：

`12345678`	`<insert id="insertUser" parameterType="cn.itcast.mybatis.po.User"> <selectKey resultType="java.lang.Integer" order="BEFORE" keyProperty="id"> SELECT 自定義序列.NEXTVAL FROM DUAL </selectKey>insert into user(id,username,birthday,sex,address) values(#{id},#{username},#{birthday},#{sex},#{address})</insert>`

十一、刪除用戶

前面說了這麼多了，這裏就簡單來講明下：

在 User.xml 文件中加入以下代碼：

`1234`	`<!--刪除用戶--> <delete id="deleteUserById" parameterType="int"> delete from user where user.id = #{id} </delete>`

在 MybatisFirst.java 文件中加入以下代碼：

4151617181920212223242526272829 //刪除用戶 @Test public void deleteUserByIdTest() throws IOException { //Mybatis 配置文件 String resource = "SqlMapConfig.xml"; //獲得配置文件流 InputStream inputStream = Resources.getResourceAsStream(resource); //建立會話工廠,傳入Mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //經過工廠獲得SqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //經過SqlSession操做數據庫 //第一個參數：映射文件中Statement的id，等於 = namespace + "." + Statement的id //第二個參數：指定和映射文件中所匹配的parameterType類型的參數 sqlSession.delete("test.deleteUserById", 26); //提交事務 sqlSession.commit(); //釋放資源 sqlSession.close(); }

測試結果以下：

以前的數據庫 user 表查詢結果：

執行完測試代碼後，結果以下：

十二、更新用戶信息

在 User.xml 中加入以下代碼：

123456789 <update id="updateUserById" parameterType="cn.zhisheng.mybatis.po.User"> update user set username = #{username}, birthday = #{birthday}, sex = #{sex}, address = #{address} where user.id = #{id} </update>

而後在 MybatisFirst.java 中加入

819202122232425262728293031323334353637 //根據id更新用戶信息 @Test public void updateUserByIdTest() throws IOException, ParseException { //Mybatis 配置文件 String resource = "SqlMapConfig.xml"; //獲得配置文件流 InputStream inputStream = Resources.getResourceAsStream(resource); //建立會話工廠,傳入Mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //經過工廠獲得SqlSession SqlSession sqlSession = sqlSessionFactory.openSession(); //爲了設置生日的日期輸入 SimpleDateFormat sdf = new SimpleDateFormat ("yyyy-MM-dd"); User user = new User(); //根據id更新用戶信息 user.setId(24); user.setUsername("張四風"); user.setBirthday(sdf.parse("2015-01-12")); user.setSex("女"); user.setAddress("上海黃埔"); //經過SqlSession操做數據庫 //第一個參數：映射文件中Statement的id，等於 = namespace + "." + Statement的id //第二個參數：指定和映射文件中所匹配的parameterType類型的參數 sqlSession.update("test.updateUserById", user); //提交事務 sqlSession.commit(); //釋放資源 sqlSession.close(); }

測試結果以下：

查看數據庫，id 爲 24 的用戶信息是否更新了：

啊，是否是很爽，全部的需求都完成了。

沒錯，這只是 Mybatis 的一個簡單的入門程序，簡單的實現了對數據庫的增刪改查功能，經過這個咱們大概能夠了解這個編程方式了。

期待接下來的 Mybatis高級知識文章吧！

一位阿里 Java 工程師的技術小站。做者黃小斜，專一 Java 相關技術：SSM、SpringBoot、MySQL、分佈式、中間件、集羣、Linux、網絡、多線程，偶爾講點Docker、ELK，同時也分享技術乾貨和學習經驗，致力於Java全棧開發！（關注公衆號後回覆」Java「便可領取 Java基礎、進階、項目和架構師等免費學習資料，更有數據庫、分佈式、微服務等熱門技術學習視頻，內容豐富，兼顧原理和實踐，另外也將贈送做者原創的Java學習指南、Java程序員面試指南等乾貨資源）

微信公衆號【黃小斜】大廠程序員，互聯網行業新知，終身學習踐行者。關注後回覆「Java」、「Python」、「C++」、「大數據」、「機器學習」、「算法」、「AI」、「Android」、「前端」、「iOS」、「考研」、「BAT」、「校招」、「筆試」、「面試」、「面經」、「計算機基礎」、「LeetCode」等關鍵字能夠獲取對應的免費學習資料。