Mybatis入門及第一個Mybatis程式

y浴血發表於2020-11-29

MyBatis

Mybatis筆記整理

所需要的基礎知識

JDBC

Mysql

Java基礎

Maven

Junit

框架：是有配置檔案的。最好的方式：看官網文件

1、簡介

1.1、什麼是MyBatis

簡介
什麼是 MyBatis？

MyBatis 是一款優秀的持久層框架
它支援定製化 SQL、儲存過程以及高階對映。
MyBatis 避免了幾乎所有的 JDBC 程式碼和手動設定引數以及獲取結果集。
MyBatis 可以使用簡單的 XML 或註解來配置和對映原生型別、介面和 Java 的 POJO（Plain Old Java Objects，普通老式 Java 物件）為資料庫中的記錄。

如何獲得MyBatis？

Maven倉庫

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.3</version>
</dependency>

github：https://github.com/mybatis/mybatis-3/releases

中文文件：https://mybatis.org/mybatis-3/zh/index.html

1.2、持久化

資料持久化

持久化就是將程式的資料在持久狀態和瞬時狀態轉化的過程
記憶體：斷電即失
資料庫(JDBC),io檔案持久化。
生活中：冷藏、罐頭。

為什麼需要持久化？

有一些物件，不能讓他丟掉。

1.3、持久層

Dao層、Service層、Controller層…

完成持久化工作的程式碼塊
層界限十分明顯

1.4、為什麼需要Mybatis？

幫助程式設計師將資料存入到資料庫中。

方便

傳統的JDBC程式碼太複雜了。簡化、框架、自動化。

不用Mybatis也可以。更容易上手。技術沒有高低之分

優點：
    簡單易學
    靈活
    sql和程式碼的分離，提高了可維護性。
    提供對映標籤，支援物件與資料庫的orm欄位關係對映
    提供物件關係對映標籤，支援物件關係組建維護
    提供xml標籤，支援編寫動態sql。

最重要的一點：使用的人多！

Spring

SpringMVC

SpringBoot

2、第一個Mybatis程式

思路：搭建環境–>匯入Mybatis–>編寫程式碼–>測試！

2.1、搭建環境

搭建資料庫

CREATE DATABASE mybatis;
use mybatis;
CREATE TABLE user(
id INT(20) not null PRIMARY KEY,
name VARCHAR(30) DEFAULT NULL,
pwd VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT INTO user (id,name,pwd) VALUES
(1,'浴血','123456'),
(2,'張三','123456'),
(3,'李四','123890')

新建專案

新建一個普通的maven專案
刪除src目錄
匯入maven依賴

之後建立maven的父工程與子工程

<?xml version="1.0" encoding="UTF-8"?>
<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.yuxue</groupId>
    <artifactId>Mybatis-study</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>mybatis-01</module>
    </modules>
    <!--匯入依賴-->
    <dependencies>
        <!--mysql驅動-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>
        <!--mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
        <!--junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
        <!--log4j-->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    </dependencies>

子工程

<?xml version="1.0" encoding="UTF-8"?>
<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">
    <parent>
        <artifactId>Mybatis-study</artifactId>
        <groupId>com.yuxue</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>mybatis-01</artifactId>

2.2、建立一個模組

首先在main/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核心配置檔案-->
<configuration>
    <!--environments配置環境組-->
    <!--default預設環境-->
    <environments default="development">
        <!--environment單個環境-->
        <environment id="development">
            <!--transactionManager配置事務管理器-->
            <transactionManager type="JDBC"/>
            <!--配置連線池-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false&amp;serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

之後編寫mybatis的工具類utils，目錄為main/java新建package:com.yuxue.utils

package com.yuxue.utils;

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 java.io.IOException;
import java.io.InputStream;

/**
 * @author yuxue
 * sqlSessionFactory --> sqlSession
 */
public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;

    static {
            try{
                //使用mybatis第一步、獲取sqlSessionFactory物件
                String resource = "mybatis-config.xml";
                InputStream inputStream = Resources.getResourceAsStream(resource);
                sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            }catch(IOException e) {
                e.printStackTrace();
            }
    }

    //既然有了 SqlSessionFactory，顧名思義，我們就可以從中獲得 SqlSession 的例項了。
    // SqlSession 完全包含了面向資料庫執行 SQL 命令所需的所有方法。
    // 你可以通過 SqlSession 例項來直接執行已對映的 SQL 語句。
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

2.3、編寫程式碼

編寫實體類,目錄為main/java新建package:com.yuxue.pojo，新建一個User類

package com.yuxue.pojo;

public class User {
    private int id;
    private String name;
    private String pwd;

    public User() {
    }

    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

    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 getPwd() {
        return pwd;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", pwd='" + pwd + '\'' +
                '}';
    }
}

之後編寫Dao當中的程式碼，首先編寫UserMapper的抽象介面，目錄為main/java新建package:com.yuxue.dao

package com.yuxue.dao;

import com.yuxue.pojo.User;

import java.util.List;

public interface UserMapper {
    //查詢所有使用者
    List<User> getUserList();
}

之後再Dao資料夾下新建UserMapper.xml檔案對SQL語句進行編寫

<?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">
<!--namespace=繫結一個對應的Dao/Mapper介面-->
<mapper namespace="com.yuxue.dao.UserMapper">
    <select id="getUserList" resultType="com.yuxue.pojo.User">
        select * from mybatis.user
    </select>
</mapper>

要讓這個配置檔案在mybatis-config.xml檔案中註冊，於是加上

   <!--每一個Mapper.xml都需要在Mybatis核心配置檔案中註冊-->
    <mappers>
        <mapper resource="com/yuxue/dao/UserMapper.xml"></mapper>
    </mappers>

在子工程以及父工程的pom檔案中加上一段話讓其識別資料夾中的xml檔案

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

2.4、測試

使用juint進行測試，在test資料夾下建立package:com.yuxue.UserMapperTest

package com.yuxue.dao;

import com.yuxue.pojo.User;
import com.yuxue.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {
    @Test
    public void test(){
        //第一步：獲得SqlSession物件
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //執行SQL
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        List<User> userList = mapper.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }
        //關閉SqlSession
        sqlSession.close();
    }
}

可能會遇到的問題：
    配置檔案沒有註冊
    繫結介面錯誤
    方法名不對
    返回型別不對
    Maven匯出資源問題

以上就是我們所寫的第一個Mybatis程式

3、CRUD

3.1、namespace

namespace中的包名要和dao/mapper介面的包名保持一致

<mapper namespace="com.yuxue.dao.UserMapper">

3.2、select

選擇查詢語句；以下在select語句當中的引數非常重要

id：就是對應的namespace中的方法名；
resultType：Sql語句執行的返回值！
parameterType：引數型別！

編寫介面

package com.yuxue.dao;

import com.yuxue.pojo.User;

import java.util.List;

public interface UserMapper {
    //根據id查詢使用者
    User getUserById(int id);
}

編寫對應的mapper中的sql語句

<select id="getUserById" resultType="com.yuxue.pojo.User" parameterType="int">
    select * from mybatis.user where id = #{id};
</select>

測試

@Test
public void getUserById(){
    SqlSession sqlSession = MyBatisUtils.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = mapper.getUserById(1);
    System.out.println(user);
    sqlSession.close();
}

3.3、Insert

//插入一個USER
int insertUser(User user);

<insert id="insertUser" parameterType="com.yuxue.pojo.User">
    insert into mybatis.user (id, name, pwd) values (#{id}, #{name}, #{pwd})
</insert>

@Test
public void insertUserTest(){
    SqlSession sqlSession = MybatisUtils.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    int number = mapper.insertUser(new User(4, "呵呵", "1454321"));
    if (number==1){
        sqlSession.commit();
    }
    sqlSession.close();
}

3.4、Update

//修改使用者
int updateUser(User user);

<update id="updateUser" parameterType="com.yuxue.pojo.User">
    update mybatis.user set name=#{name}, pwd=#{pwd}  where id=#{id}
</update>

@Test
public void updateUserTest(){
    SqlSession sqlSession = MybatisUtils.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    int heihei = mapper.updateUser(new User(4, "heihei", "1454321"));
    if (heihei==1){
        sqlSession.commit();
    }
    sqlSession.close();
}

3.5、Delete

//刪除使用者
int deleteUser(int id);

<delete id="deleteUser" parameterType="int">
    delete from mybatis.user where id = #{id}
</delete>

@Test
public void deleteUserTest(){
    SqlSession sqlSession = MybatisUtils.getSqlSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    int i = mapper.deleteUser(4);
    if (i==1){
        sqlSession.commit();
    }
    sqlSession.close();
}

注意點：增刪改需要提交事務

我們可以發現，現在編寫一條新的SQL語句只用修改三個檔案即可，其他的檔案均不用動，這三個檔案分別是

1.UserMapper

2.UserMapper.xml

3.UserMapperTest

3.6、分析錯誤

resource繫結mapper，需要使用路徑！
程式配置檔案必須符合規範
NullPointerException，沒有註冊到資源
輸出的xml檔案中存在中文亂碼問題
maven資源沒有匯出問題

最終形成的目錄結構以及檔案如下圖所示

MyBatis(二)MyBatis入門程式(MyBatis demo)
2018-07-03
MyBatis
MyBatis系列(一)：MyBatis入門
2019-06-28
MyBatis
MyBatis從入門到精通(一)：MyBatis入門
2019-06-28
MyBatis
mybatis入門程式
2021-08-07
MyBatis
MyBatis(一) 入門
2018-07-03
MyBatis
MyBatis1：MyBatis入門
2016-03-08
MyBatis
MyBatis 入門
2020-02-16
MyBatis
Mybatis入門
2024-04-10
MyBatis
【MyBatis】3：MyBatis環境搭建及入門程式示例
2016-07-30
MyBatis
MyBatis入門學習（一）
2015-03-13
MyBatis
MyBatis入門基礎(一)
2015-06-27
MyBatis
MyBatis基礎：MyBatis入門（1）
2017-08-15
MyBatis
深入淺出Mybatis原始碼系列（一）---Mybatis入門
2018-09-18
MyBatis原始碼
MyBatis 框架之快速入門程式
2019-02-18
MyBatis框架
mybatis 學習--mybatis基本用法入門
2016-11-27
MyBatis
mybatis快速入門
2021-08-26
MyBatis
mybatis入門教程
2017-06-16
MyBatis
【mybatis學習之入門（一）】
2017-06-18
MyBatis
MyBatis第一個程式
2020-10-25
MyBatis
mybatis入門學習
2020-07-05
MyBatis
Mybatis極速入門
2020-05-16
MyBatis
MyBatis--快速入門
2020-12-13
MyBatis
轉載：mybatis入門
2015-09-18
MyBatis
Mybatis 入門介紹
2024-02-27
MyBatis
MyBatis研習錄(01)——MyBatis概述與入門
2020-02-17
MyBatis
入門MyBatis框架我一點都不慌
2020-07-11
MyBatis框架
30分鐘入門MyBatis
2019-03-03
MyBatis
MyBatis入門——瞭解配置
2018-10-17
MyBatis
Mybatis框架入門學習
2020-10-10
MyBatis框架
由表生成程式碼：mybatis-generator入門
2019-04-13
MyBatis
mybatis入門程式：刪除、更新使用者&&hibernate和mybatis的區別
2020-10-03
MyBatis
Mybatis初學建立一個MyBatis-Helloworld
2018-11-20
MyBatis
Mybatis-Plus入門實踐
2022-05-10
MyBatis
MyBatis-Plus筆記(入門)
2021-04-17
MyBatis筆記
Java持久層框架Mybatis入門
2021-06-19
Java框架MyBatis
Mybatis入門看這一篇就夠了
2018-03-12
MyBatis
MyBatis從入門到精通(九)：MyBatis高階結果對映之一對一對映
2019-07-11
MyBatis
MyBatis從入門到精通(五)：MyBatis 註解方式的基本用法
2019-07-05
MyBatis