Mybatis全域性設定及對映關係的實現

2022-03-03 13:02:00

一、組態檔內容

mybatis.xml就是Mybatis的全域性組態檔。

全域性組態檔需要在頭部使用約束檔案。

<?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（設定）
    properties--屬性:載入外部組態檔，例如資料庫的連線資訊
    Settings--全域性設定引數:例如紀錄檔設定
    typeAliases--型別別名
    typeHandlers--型別處理器
    objectFactory--物件工廠
    Plugins--外掛：例如分頁外掛
    Environments--環境集合屬性物件
        environment(環境變數)
            transactionManager(事務管理器)
            dataSource(資料來源)
    Mappers--對映器：註冊對映檔案

1.1、Proerties

屬性可以在外部設定，並可以進行動態替換。我們既可以在properties元素的子元素設定（例如Datasource中的properties節點）也可以在java屬性檔案中設定。

資料來源中有連線資料庫的四個引數資料，我們一般都放在專門的屬性檔案中，mybatis的全域性組態檔直接從屬性檔案中讀取資料。

1、resources目錄下建立jdbc.properties

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1:3306/mybatis?serverTimezone=UTC&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
jdbc.username=root
jdbc.password=123@qwe

2、mybatis.xml中引入組態檔

    <properties resource="jdbc.properties"/>

3、使用屬性檔案中的值

 <dataSource type="POOLED">
    <!--  連線資料庫四大引數  --> 
    <property name="driver" value="${jdbc.driver}"/>
    <property name="url" value="${jdbc.url}"/>
    <property name="username" value="${jdbc.username}"/>
    <property name="password" value="${jdbc.password}"/>
</dataSource>

1.2、設定setting

Mybatis中極為重要的調整設定，它們會改變Mybatis的執行行為，例如紀錄檔。

 <!-- 設定紀錄檔   -->
    <settings>
        <setting name="logImpl" value="LOG4J"/>
    </settings>

1.3、型別別名typeAliases

可以為java型別設定一個縮寫別名，僅用於xml設定，意在減低冗餘全限定類名書寫。
MyBatis中已經支援一些常見型別的別名，如下：

別名	對映的型別
_byte	byte
_long	long
_short	short
_int	int
_integer	int
_double	double
_float	float
_boolean	boolean
string	String
byte	Byte
long	Long
short	Short
int	Integer
integer	Integer
double	Double
float	Float
boolean	Boolean
date	Date
decimal	BigDecimal
bigdecimal	BigDecimal
object	Object
map	Map
hashmap	HashMap
list	List
arraylist	ArrayList
collection	Collection
iterator	Iterator

也支援自定義別名：

 <typeAliases>
        <!--  對單個實體類定義別名 -->
        <typeAlias type="com.jsonliu.test.entity.Users" alias="Users" />
        <!--  推薦：批次定義別名，掃描指定包下所有類，同時別名定義為類名，別名首字母大小寫都可以 -->
        <package name="com.jsonliu.test.entity"/>
    </typeAliases>

1.4、對映器Mappers

1.4.1、使用相對於類路徑的資源參照

語法：<mapper resource="">
使用相對於類路徑的資源，從classpath路徑查詢檔案
例如：<mapper resource="com/jsonliu/test/entity/Team.xml"/>

1.4.2、使用對映器介面實現類的完全限定類名

語法：<mapper class="">
要求：介面和對映檔案同包同名
<mapper class="com.jsonliu.test.mapper.UsersMapper"/>

1.4.3、將包內對映器介面全部註冊為對映器

1.5、dataSource

Mybatis中存取資料庫支援連線池技術，而且採用的自己的連線池技術。在mybatis.xml檔案中進行設定，根據type屬性建立相應型別資料來源DataSource。
Mybatis資料來源分三類：

UNPOOLED:不使用連線池資料來源
POOLED:使用連線池資料來源
JNDI：使用JNDI實現的資料來源

前兩個資料來源都實現了javax.sql.Datasource介面

1.6、事務

預設手動提交事務：

Mybatis框架是對JDBC的封裝，所以Mybatis事務的控制方式本身也是用JDBC的connection物件的commit()、rollback()方法，connection物件的setAutoCommit()設定事務提交方式為手動或者自動。

<!--  事務型別：使用JDBC事務，使用connection提交和回滾  -->
            <transactionManager type="JDBC" />

transactionManager 指定Mybatis所用事務管理器，支援：JDBC與MANAGED

JDBC事務管理機制，通過Connection物件的commit()方法提交，rollback()方法回滾。預設情況下Mybatis將關閉自動提交功能，觀察紀錄檔可以看出，提交或者回滾都需要我們手動設定。

MANAGED：由容器來管理事務的整個生命週期（如Spring容器）

SqlSessionFactory的openSession()方法存在過載，可以設定自動提交方式。
如果sqlSession = SqlSessionFactory.openSession(true);
引數設定為true，再次執行增刪改不需要執行sqlSession.commit()，事務會自動提交。

二、Mybatis中的關係對映

表結構如下：

2.1、一對一對映

新增實體類Player:

public class Player { 
    private Integer playerId;
    private String playerName;
    private Integer playerNum;
    private Integer teamId; 
    private Team team1;

    public Player() {
    }

    public Player(Integer playerId, String playerName, Integer playerNum, Integer teamId) {
        this.playerId = playerId;
        this.playerName = playerName;
        this.playerNum = playerNum;
        this.teamId = teamId;
    }

    @Override
    public String toString() {
        return "Player{" +
                "playerId=" + playerId +
                ", playerName='" + playerName + ''' +
                ", playerNum=" + playerNum +
                ", teamId=" + teamId +
                ", team1=" + team1 +
                '}';
    }

    public Integer getPlayerId() {
        return playerId;
    }

    public void setPlayerId(Integer playerId) {
        this.playerId = playerId;
    }

    public String getPlayerName() {
        return playerName;
    }

    public void setPlayerName(String playerName) {
        this.playerName = playerName;
    }

    public Integer getPlayerNum() {
        return playerNum;
    }

    public void setPlayerNum(Integer playerNum) {
        this.playerNum = playerNum;
    }

    public Integer getTeamId() {
        return teamId;
    }

    public void setTeamId(Integer teamId) {
        this.teamId = teamId;
    }

    public Team getTeam1() {
        return team1;
    }

    public void setTeam1(Team team1) {
        this.team1 = team1;
    }
}

Mapper介面：

public interface PlayerMapper {

    Player queryById(int playerId);
    Player queryById1(int playerId);
    Player queryById2(int playerId);
    Player queryById3(int playerId);

}

Mapper對映檔案：

<?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.jsonliu.test.mapper.PlayerMapper">
    <select id="queryById" resultType="player">
        select * from player where playerId=#{playerId}
    </select>

    <select id="queryById1" resultMap="joinTeamResult1">
        select * from player a inner join team b on a.teamId=b.teamId
        where a.playerId=#{playerId}
    </select>

    <select id="queryById2" resultMap="joinTeamResult2">
        select * from player a inner join team b on a.teamId=b.teamId
        where a.playerId=#{playerId}
    </select>

    <select id="queryById3" resultMap="joinTeamResult3">
        select * from player where playerId=#{playerId}
    </select>
    
    <resultMap id="baseResultMap" type="player">
        <id property="playerId" column="playerId" ></id>
        <result property="playerName" column="playerName"></result>
        <result property="playerNum" column="playerNum"></result>
        <result property="teamId" column="teamId"></result>
    </resultMap>

    <!-- 方式一：關聯物件.屬性，要求連線查詢。 extends=表示繼承其他的resultMap的ID  -->
    <resultMap id="joinTeamResult1" type="player" extends="baseResultMap">
        <id property="team1.teamId" column="teamId"></id>
        <result property="team1.teamName" column="teamName"></result>
        <result property="team1.location" column="location"></result>
        <result property="team1.createTime" column="createTime"></result>
    </resultMap>

    <!-- 方式二：直接參照關聯物件的mapper對映,要求連線查詢。 property=關聯物件的屬性名
        javaType=關聯物件的型別  resultMap=關聯物件名稱空間中的resultMap-->
    <resultMap id="joinTeamResult2" type="player" extends="baseResultMap">
        <association property="team1" javaType="team" resultMap="com.jsonliu.test.mapper.TeamMapper.baseResultMap"/>
    </resultMap>

    <!-- 方式三：直接參照關聯物件的查詢方法,要求關聯物件的mapper中必須有單獨的查詢方法。 property=關聯物件的屬性名
    javaType=關聯物件的型別 select=關聯物件的單獨查詢語句 column=外來鍵列 -->
    <resultMap id="joinTeamResult3" type="player" extends="baseResultMap">
        <association property="team1" javaType="team" select="com.jsonliu.test.mapper.TeamMapper.queryById" column="teamId"/>
    </resultMap> 
</mapper>

測試類：

public class PlayerMapperTest {

    private PlayerMapper mapper=MybatisUtil.getSqlSession().getMapper(PlayerMapper.class);

    @Test
    public void test1(){
        Player player = mapper.queryById1(1);
        System.out.println(player);
    }

    @Test
    public void test2(){
        Player player = mapper.queryById2(1);
        System.out.println(player);
    }

    @Test
    public void test3(){
        Player player = mapper.queryById3(1);
        System.out.println(player);
    } 
}

2.2、一對多對映

修改實體類Team.java:

public class Team {
    /**
     * 球隊ID
     */
    private Integer teamId;
    /**
     * 球隊名稱
     */
    private String teamName;
    /**
     * 球隊地址
     */
    private String location;
    /**
     * 創立時間
     */
    private Date createTime;
    /**
     * 隊員集合
     */
    private List<Player> playerList;
    ...
}

TeamMapper介面中新增方法：

    Team queryById1(int teamId);

    Team queryById2(int teamId);

PlayerMapper介面中新增方法：

    List<Player> queryByTeamId(int teamId);

TeamMapper.xml中新增對映：

 <!-- 方式一：使用collection,property=關聯物件集合名稱，javaType=關聯物件集合型別，ofType=關聯物件集合的泛型，
       resultMap=引起關聯物件的結果對映  -->
    <resultMap id="joinResult1" type="team" extends="baseResultMap">
        <collection property="playerList" javaType="arrayList" ofType="Player" resultMap="com.jsonliu.test.mapper.PlayerMapper.baseResultMap"/>
    </resultMap>

    <!-- 方式一：使用collection,property=關聯物件集合名稱，javaType=關聯物件集合型別，ofType=關聯物件集合的泛型，
      select=引起關聯物件的單獨查詢方法，使用的前提是關聯物件中該方法可用
      column=引起關聯物件的單獨查詢方法的引數，一般是外來鍵-->
    <resultMap id="joinResult2" type="team" extends="baseResultMap">
        <collection property="playerList" javaType="arrayList" select="com.jsonliu.test.mapper.PlayerMapper.queryByTeamId" column="teamId"/>
    </resultMap>

PlayerMapper.xml中新增對映：

  <select id="queryByTeamId" resultType="player">
        select * from player where teamId=#{teamId}
    </select>

測試類中新增測試方法：

 @Test
    public void test13(){
        TeamMapper mapper = sqlSession.getMapper(TeamMapper.class);
        Team team = mapper.queryById1(1025);
        System.out.println(team);
    }

    @Test
    public void test14(){
        TeamMapper mapper = sqlSession.getMapper(TeamMapper.class);
        Team team = mapper.queryById2(1025);
        System.out.println(team);
    }

到此這篇關於Mybatis全域性設定及對映關係的實現的文章就介紹到這了,更多相關Mybatis全域性設定及對映關係內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com！