1. 程式人生 > 實用技巧 >MyBatis-入門

MyBatis-入門

第一個MyBatis程式

學習任何東西的思路都是:

搭建環境 -> 匯入依賴 -> 編寫程式碼 -> 測試

搭建環境

首先安裝資料庫和資料庫管理軟體,這裡直接使用以前的MySQLSQLyog

然後建立相關的資料庫和資料表

-- 每個sql語句以分號結尾
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` VALUES(1,'張三','111'),(2,'李四','000'),(3,'王五','666');

建立父子工程

  • 建立父Maven - 空專案

  • 刪除src目錄,父工程不寫程式碼的,只管匯入依賴

  • 配置父工程的pom.xml檔案

    <?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.hong</groupId>
        <artifactId>MyBatis-Study</artifactId>
        <version>1.0-SNAPSHOT</version>
    
        <!--匯入相關依賴-->
        <dependencies>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>5.1.47</version>
            </dependency>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.4.6</version>
            </dependency>
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>4.11</version>
            </dependency>
        </dependencies>
    </project>
    
  • 建立模組 -- Maven子專案繼承父專案的依賴

編寫配置檔案

在子專案的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://localhost:3306/mybatis?useSSL=true&amp;userUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

封裝工具類

MybatisUtils.java

package com.hong.util;

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;

/**
 * 封裝工具類
 */
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();
        }
    }

    /**
     * 通過工廠生產sqlSession物件
     * @return sql操作物件
     */
    public static SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }
}

編寫程式碼

實體類

Dao介面

介面實現類

  1. pojo

    package com.hong.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

    package com.hong.dao;
    
    import com.hong.pojo.User;
    
    import java.util.List;
    
    /**
     * 以後的dao都寫成mapper
     */
    public interface UserDao {
        // 獲取使用者列表
        List<User> getUserList();
    }
    
  3. 實現類由原來的UserDaoImpl轉變為Mapper配置檔案

    原來的實現類(對比而已,現在不用了!)

    package com.hong.dao;
    
    import com.hong.pojo.User;
    
    import java.util.List;
    
    /**
     * 以前jdbc時都是寫這種實現類
     * 使用MyBatis之後就用xml實現
     */
    public class UserDaoImpl implements UserDao {
        public List<User> getUserList() {
            // 底層的JDBC跟資料庫打交道,拿到使用者列表後返回
            return null;
        }
    }
    

    Mybatis的Mapper配置檔案

    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="com.hong.dao.UserDao">
        <!--select查詢語句 -->
        <select id="getUserList" resultType="com.hong.pojo.User">
            select * from mybatis.user
        </select>
    </mapper>
    

    解釋:在xml中不能匯入包,所以要寫全路徑。id繫結的是介面的方法,返回結果是列表中的泛型。中間寫sql語句

測試

執行出錯跳轉到後面看看

UserDaoTest.java

package com.hong.dao;

import com.hong.pojo.User;
import com.hong.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDaoTest {
    @Test
    public void test() {
        // 獲取資料庫操作物件
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        try {
            // 方式1 建議使用
            UserDao userDao = sqlSession.getMapper(UserDao.class);
            List<User> userList = userDao.getUserList();

            // 方式2 老版本的獲取方式
            // List<User> userList = sqlSession.selectList("com.hong.dao.UserDao.getUserList");
            for (User user : userList) {
                System.out.println(user);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            sqlSession.close();
        }
    }
}


解決完報錯之後的執行結果

User{id=1, name='張三', pwd='111'}
User{id=2, name='李四', pwd='000'}
User{id=3, name='王五', pwd='666'}

遇到的問題

注意點!這裡有很多坑要注意啦

  • 沒有註冊mapper -> 繫結異常 Type interface com.hong.dao.UserDao is not known to the MapperRegistry.

    • 回到核心配置檔案mybatis-config.xml中註冊mapper

      <?xml version="1.0" encoding="UTF8" ?>
      <!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?useSSL=true&amp;userUnicode=true&amp;characterEncoding=UTF-8"/>
                      <property name="username" value="root"/>
                      <property name="password" value="123456"/>
                  </dataSource>
              </environment>
          </environments>
          <mappers>
              <mapper resource="com/hong/dao/UserMapper.xml"/>
          </mappers>
      </configuration>
      
      
  • 找不到資源 -> 可能是靜態資源被過濾,檢視target目錄下有沒有UserMapper.xml。也可能是路徑寫錯了

    • 如果在target目錄下找不到,則在子專案的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>
                  </resource>
              </resources>
          </build>
      
      
    • 註冊mapper時,路徑使用斜槓分隔。com/hong/dao/UserMapper.xml

  • 版本相容問題,報錯一位元組錯誤時,將<?xml version="1.0" encoding="UTF-8" ?>UTF-8 改成 UTF8

  • 建議不要在xml內出現中文,包括註釋

總結

使用配置檔案替代原來繁雜的JDBC操作,但思想都是一樣的。