Java?Mybatis框架應用實例分析

Java Mybatis框架應用實例分析

1. 引言

MyBatis 是一個優秀的持久層框架，它支持定制化 SQL、存儲過程以及高級映射。MyBatis 避免了幾乎所有的 JDBC 代碼和手動設置參數以及獲取結果集。MyBatis 可以使用簡單的 XML 或注解來配置和映射原生信息，將接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java對象)映射成數據庫中的記錄。

本文將通過對一個簡單的 MyBatis 應用實例的分析，幫助讀者理解 MyBatis 的基本使用方法和核心概念。

2. 環境準備

在開始之前，我們需要準備以下環境：

• JDK 1.8 或更高版本
• Maven 3.x
• MySQL 數據庫
• IntelliJ IDEA 或其他 Java IDE

2.1 創建 Maven 項目

首先，我們使用 Maven 創建一個新的 Java 項目。在 pom.xml 文件中添加 MyBatis 和 MySQL 驅動的依賴：

<dependencies>
    <!-- MyBatis 核心依賴 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>

    <!-- MySQL 驅動 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>

    <!-- 日志依賴 -->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
        <version>1.7.32</version>
    </dependency>
</dependencies>

2.2 配置 MyBatis

在 src/main/resources 目錄下創建 mybatis-config.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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis_example"/>
                <property name="username" value="root"/>
                <property name="password" value="password"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

2.3 創建數據庫表

在 MySQL 中創建一個簡單的 user 表：

CREATE TABLE user (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50),
    email VARCHAR(50)
);

3. 編寫代碼

3.1 創建實體類

創建一個 User 實體類，對應數據庫中的 user 表：

package com.example.model;

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

    // Getters and Setters
}

3.2 創建 Mapper 接口

創建一個 UserMapper 接口，定義數據庫操作的方法：

package com.example.mapper;

import com.example.model.User;
import java.util.List;

public interface UserMapper {
    User selectUserById(int id);
    List<User> selectAllUsers();
    void insertUser(User user);
    void updateUser(User user);
    void deleteUser(int id);
}

3.3 編寫 Mapper XML 文件

在 src/main/resources/com/example/mapper 目錄下創建 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">
<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectUserById" resultType="com.example.model.User">
        SELECT * FROM user WHERE id = #{id}
    </select>

    <select id="selectAllUsers" resultType="com.example.model.User">
        SELECT * FROM user
    </select>

    <insert id="insertUser" parameterType="com.example.model.User">
        INSERT INTO user (name, email) VALUES (#{name}, #{email})
    </insert>

    <update id="updateUser" parameterType="com.example.model.User">
        UPDATE user SET name = #{name}, email = #{email} WHERE id = #{id}
    </update>

    <delete id="deleteUser" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

3.4 編寫測試類

創建一個測試類 MyBatisTest，測試 MyBatis 的功能：

package com.example;

import com.example.mapper.UserMapper;
import com.example.model.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 java.io.IOException;
import java.io.InputStream;
import java.util.List;

public class MyBatisTest {
    public static void main(String[] args) throws IOException {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);

            // 插入用戶
            User user = new User();
            user.setName("John Doe");
            user.setEmail("john.doe@example.com");
            mapper.insertUser(user);
            session.commit();

            // 查詢用戶
            User selectedUser = mapper.selectUserById(user.getId());
            System.out.println("Selected User: " + selectedUser);

            // 查詢所有用戶
            List<User> users = mapper.selectAllUsers();
            users.forEach(u -> System.out.println("User: " + u));

            // 更新用戶
            user.setName("Jane Doe");
            mapper.updateUser(user);
            session.commit();

            // 刪除用戶
            mapper.deleteUser(user.getId());
            session.commit();
        }
    }
}

4. 運行結果

運行 MyBatisTest 類，控制臺將輸出以下內容：

Selected User: User{id=1, name='John Doe', email='john.doe@example.com'}
User: User{id=1, name='John Doe', email='john.doe@example.com'}

5. 總結

通過本文的實例分析，我們了解了如何使用 MyBatis 框架進行數據庫操作。MyBatis 通過簡單的 XML 或注解配置，將 Java 對象與數據庫表進行映射，極大地簡化了數據庫操作的代碼量。MyBatis 的靈活性和易用性使其成為 Java 開發中常用的持久層框架之一。

在實際開發中，MyBatis 還可以與 Spring 等框架集成，進一步簡化開發流程。希望本文能幫助讀者更好地理解和使用 MyBatis 框架。