Mybatis入門及第一個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、創建一個模塊

1. 首先在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>

2. 之后編寫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、編寫代碼

1. 編寫實體類,目錄為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 + '\'' +
                '}';
    }
}

2. 之后編寫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();
}

3. 之后再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>

4. 要讓這個配置文件在mybatis-config.xml文件中注冊，於是加上

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

5. 在子工程以及父工程的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資源沒有導出問題

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