一、项目概述
本教程旨在通过 IntelliJ IDEA 快速构建一个基于 Spring Boot 框架的 Web 应用,并集成 MyBatis 与 MySQL 数据库。我们将遵循标准 Maven 目录结构,实现从配置到接口开发的全流程,打造高效、可扩展且易于维护的后端基础。
二、项目结构
项目采用标准的 Maven 布局,主要模块划分如下:
- core:核心业务逻辑层代码。
- exception:统一异常处理类。
- mapper:数据访问对象(DAO),负责与数据库交互。
- service:服务接口层,提供对外业务方法。
- entity:实体类,对应数据库表结构。
- controller:控制层,处理 HTTP 请求并调用服务。
- config:配置文件存放目录。
- test:单元测试及集成测试。
- common:公共工具类及统一响应包装。
三、初始化项目
在 IDEA 中创建新项目时,选择 Spring Initializr 模板。确保勾选以下依赖:
- Spring Web:用于构建 RESTful API。
- MyBatis Framework:持久层框架支持。
- MySQL Driver:数据库驱动。
- Lombok(可选):简化实体类编写。
设置文件编码统一为 UTF-8,检查 Maven 构建目录结构是否符合预期。若未自动生成 pom.xml,可右键点击项目根目录执行 "Maven" -> "Reload Project"。
配置文件说明
在 application.properties 或 application.yml 中配置数据库连接信息。注意 MyBatis 映射文件路径需与实际资源位置一致。
# 应用服务端口
server.port=9090
# 数据库配置
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.url=jdbc:mysql://localhost:3306/userdb?useSSL=false&serverTimezone=UTC
# MyBatis 配置
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.configuration.map-underscore-to-camel-case=true
mybatis.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl
四、集成 MyBatis 编写接口
接下来我们实现一个简单的用户列表查询接口,采用经典的 Controller-Service-Mapper 分层架构。
1. 统一返回结果封装
为了规范前后端交互,建议定义通用的 Result 类。
package com.example.springboot.common;
public class Result {
private Integer code; // 状态码
private String message;
Object data;
Result {
();
result.setCode();
result.setMessage();
result;
}
Result {
success();
result.setData(data);
result;
}
Result {
();
result.setCode();
result.setMessage();
result;
}
Integer { code; }
{ .code = code; }
String { message; }
{ .message = message; }
Object { data; }
{ .data = data; }
}


