快捷導(dǎo)航

Spring?Boot中集成MyBatis操作數(shù)據(jù)庫的超詳細(xì)步驟(含代碼)

更新時間：2026年07月24日 09:28:30 作者：普通網(wǎng)友

MyBatis作為操作數(shù)據(jù)庫的流行框架,Spring Boot沒有提供MyBatis場景依賴,但是MyBatis開發(fā)團(tuán)隊自己適配了Spring Boot,提供了mybatis-spring-starter依賴啟動器實現(xiàn)數(shù)據(jù)訪問操作,這篇文章主要介紹了Spring?Boot中集成MyBatis操作數(shù)據(jù)庫的超詳細(xì)步驟,需要的朋友可以參考下

前言

在Java開發(fā)中，MyBatis是一款輕量級且靈活的持久層框架，支持SQL語句和自定義映射，尤其適合需要復(fù)雜SQL操作的應(yīng)用場景。結(jié)合Spring Boot，我們可以更加方便地使用MyBatis進(jìn)行數(shù)據(jù)操作。本篇文章將手把手地介紹如何在Spring Boot項目中集成MyBatis，并實現(xiàn)基礎(chǔ)的增刪改查操作。我們會從依賴配置開始，到實體類、Mapper接口、Service和Controller的創(chuàng)建，最終形成一個簡潔易用的應(yīng)用結(jié)構(gòu)。

1. 項目依賴配置

在Spring Boot項目中使用MyBatis的第一步，是在pom.xml文件中引入MyBatis的依賴。這里使用mybatis-spring-boot-starter來實現(xiàn)快速集成，同時加入MySQL驅(qū)動程序mysql-connector-java，實現(xiàn)與數(shù)據(jù)庫的連接。

1.1 引入MyBatis和數(shù)據(jù)庫驅(qū)動依賴

在pom.xml文件中加入以下依賴配置：

<dependencies>
    <!-- MyBatis Spring Boot Starter 依賴 -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.0</version>
    </dependency>
    <!-- MySQL Connector 依賴 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

1.2 數(shù)據(jù)源配置

接下來，在application.properties中配置數(shù)據(jù)庫連接信息，以便MyBatis能夠正確訪問數(shù)據(jù)庫。在這里，我們設(shè)置數(shù)據(jù)庫URL、用戶名、密碼及其他連接信息。

spring.datasource.url=jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# 指定MyBatis的Mapper XML文件位置
mybatis.mapper-locations=classpath:mapper/*.xml

2. 創(chuàng)建數(shù)據(jù)庫映射實體類

MyBatis通過實體類來映射數(shù)據(jù)庫表的字段。以User表為例，創(chuàng)建一個實體類User來表示用戶信息，包含ID、用戶名、郵箱等字段。

在com.example.demo.model包中創(chuàng)建User類，與數(shù)據(jù)庫中的用戶表結(jié)構(gòu)相對應(yīng)。該類包含屬性及其getter和setter方法。

package com.example.demo.model;

public class User {
    private Long id;
    private String username;
    private String email;

    // Getter 和 Setter 方法
    public Long getId() {
        return id;
    }
    public void setId(Long id) {
        this.id = id;
    }
    public String getUsername() {
        return username;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public String getEmail() {
        return email;
    }
    public void setEmail(String email) {
        this.email = email;
    }
}

3. 創(chuàng)建Mapper層接口

Mapper層是MyBatis與數(shù)據(jù)庫進(jìn)行交互的核心。通過Mapper接口定義數(shù)據(jù)操作方法，使用MyBatis的@Select等注解書寫SQL語句，實現(xiàn)增刪改查等數(shù)據(jù)庫操作。

在com.example.demo.mapper包中創(chuàng)建UserMapper接口，并用@Mapper注解標(biāo)記。這里定義的接口方法將被MyBatis自動實現(xiàn)，完成相應(yīng)的SQL操作。

package com.example.demo.mapper;

import com.example.demo.model.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;

import java.util.List;

@Mapper
public interface UserMapper {

    @Select("SELECT * FROM user")
    List<User> findAll();

    @Select("SELECT * FROM user WHERE id = #{id}")
    User findById(Long id);
}

此接口中的方法findAll()和findById()分別用于查詢所有用戶和根據(jù)ID查詢特定用戶的信息。

4. 創(chuàng)建Service層

Service層主要封裝業(yè)務(wù)邏輯，進(jìn)一步管理數(shù)據(jù)操作。通過Service層，我們可以將數(shù)據(jù)庫操作與業(yè)務(wù)需求分離，提高代碼的可讀性和維護(hù)性。

4.1 定義Service接口

在com.example.demo.service包中創(chuàng)建UserService接口，定義獲取所有用戶和根據(jù)ID查找用戶的方法：

package com.example.demo.service;

import com.example.demo.model.User;

import java.util.List;

public interface UserService {
    List<User> getAllUsers();
    User getUserById(Long id);
}

4.2 實現(xiàn)Service接口

在com.example.demo.service.impl包中創(chuàng)建UserServiceImpl類，實現(xiàn)UserService接口。使用@Service注解聲明這是一個服務(wù)類，并通過@Autowired注入UserMapper，調(diào)用Mapper接口方法實現(xiàn)數(shù)據(jù)庫操作。

package com.example.demo.service.impl;

import com.example.demo.mapper.UserMapper;
import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserMapper userMapper;

    @Override
    public List<User> getAllUsers() {
        return userMapper.findAll();
    }

    @Override
    public User getUserById(Long id) {
        return userMapper.findById(id);
    }
}

在這里，我們通過UserServiceImpl實現(xiàn)具體的業(yè)務(wù)邏輯，進(jìn)一步包裝了Mapper中的數(shù)據(jù)庫操作，使得Controller層能夠更專注于接口設(shè)計。

5. 創(chuàng)建Controller層

Controller層是前端和后端交互的接口層，用于接收客戶端請求，調(diào)用Service層的業(yè)務(wù)邏輯，并返回處理結(jié)果。我們使用Spring MVC的@RestController注解來創(chuàng)建控制器。

在com.example.demo.controller包中創(chuàng)建UserController類，用于處理用戶相關(guān)的HTTP請求。通過@Autowired注入UserService，并定義接口方法實現(xiàn)獲取用戶列表和根據(jù)ID查找用戶的功能。

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping
    public List<User> getAllUsers() {
        return userService.getAllUsers();
    }

    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getUserById(id);
    }
}

上述代碼實現(xiàn)了兩個接口方法：

getAllUsers()：用于獲取所有用戶信息。
getUserById(Long id)：根據(jù)用戶ID獲取特定用戶信息。

6. 運(yùn)行和測試項目

完成了以上步驟后，可以運(yùn)行項目并測試接口，確認(rèn)功能實現(xiàn)情況。

6.1 啟動項目

運(yùn)行Spring Boot項目的主類DemoApplication中的main方法，啟動應(yīng)用程序。

6.2 測試接口

可以使用Postman等工具測試API接口。例如，發(fā)送GET請求至http://localhost:8080/users即可獲取所有用戶信息，發(fā)送GET請求至http://localhost:8080/users/{id}則可以獲取指定用戶信息。

7. 總結(jié)

通過本教程，我們完成了在Spring Boot中集成MyBatis的全過程。從項目依賴配置、實體類、Mapper接口的創(chuàng)建，到Service層和Controller層的開發(fā)，逐步實現(xiàn)了數(shù)據(jù)庫的基本操作。通過這種結(jié)構(gòu)化的分層設(shè)計，項目代碼清晰，業(yè)務(wù)邏輯和數(shù)據(jù)操作實現(xiàn)了分離，易于維護(hù)和擴(kuò)展。MyBatis結(jié)合Spring Boot的方式能夠高效地完成數(shù)據(jù)持久化操作，希望這篇文章能幫助大家更好地理解和使用這兩者的集成。

到此這篇關(guān)于Spring Boot中集成MyBatis操作數(shù)據(jù)庫的超詳細(xì)步驟的文章就介紹到這了,更多相關(guān)SpringBoot集成MyBatis操作數(shù)據(jù)庫內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: