{YouAsk 诞生记 2} Spring Boot项目接入MyBatis Plus

原创 已于 2025-08-20 09:39:43 修改 · 950 阅读 · 16 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
收录于
YouAsk

当前文章被收录于：

YouAsk
4 篇文章 0 人学习
订阅专栏 查看详情
于 2025-08-14 11:27:26 首次发布

为了简化开发、提高效率，YouAsk 项目采用了 MyBatis-Plus 作为数据层的持久层框架，提供了主键自动生成、内置代码生成器、分页插件等强大功能。
项目地址：https://gitee.com/obsidian15/youask/tree/v0.2/
Tag：v2.0

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

MyBatis-Plus 是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

YouAsk使用MyBatis Plus作为项目数据层的持久层框架，相比于MyBatis提供很多增强功能，比较有用的增强功能包括

  • 支持主键自动生成
  • 内置代码生成器
  • 内置分页插件
  • 内置全局拦截插件

这些功能在后续项目中都会用带，我也会逐一介绍如何开发和使用。

MyBaits-Plus 引用

  1. 父模块pom中增加mybatis-plus的引用
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
    <version>3.5.12</version>
</dependency>
  1. youask-admin-api项目的pom中增加mybatis-plus的引用，但是不需要指定version
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
</dependency>
  1. application.yaml文件中增加数据库连接配置
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/youask?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: root
    password: p@ssword!

# mybatis-plus配置
mybatis-plus:
  mapper-locations: classpath:mapper/*.xml
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  1. YouAskAdminApiApplication.java启动类上增加MapperScan注释
package com.obsidian.youask;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@MapperScan("com.obsidian.youask.mapper")
public class YouAskAdminApiApplication {

	public static void main(String[] args) {
		SpringApplication.run(YouAskAdminApiApplication.class, args);
	}

}

开发User数据库访问层和服务层

  1. 在介绍具体代码开发前，我先介绍一下API的层次结构

项目从上至下分为6层，分别为Web层、Controller层、Service层、Mapper层和数据库

  • Web层是页面展示层
  • Controller层提供对外的API访问请求，请求主要来自Web、App或者小程序
  • Service是服务层，主要包含业务处理逻辑
  • Mapper是数据持久层，主要生产SQL语句实现数据库操作
  • Database是数据库，用于存储数据

服务分层

我们将按照上面的分层，逐层搭建

  1. resources/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.obsidian.youask.mapper.UserMapper">

</mapper>

MyBatis Plus需要编写mapper来实现数据库的操作，mapper由两部分组成，mapper接口定义和mapper的实现。其中mapper的实现可以直接在mapper接口定义的方法上，用注释（annotation）的方式定义，也可以使用mapper.xml的形式，使用xml格式定义。使用下来觉得，使用xml的方式虽然比较啰嗦，但是比较好用，直接写的是SQL语句，更加直观。个人比较推荐的做法是，一些常用的增、删、改和简单参数的查询直接用service定义即可，xml中主要包含复杂的查询，可以直接使用SQL语句实现。

  1. mapper文件夹中增加UserMapper.java
package com.obsidian.youask.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.obsidian.youask.model.entity.SysUser;

public interface UserMapper extends BaseMapper<SysUser> {

}
  1. service文件夹中增加IUserService.java接口
package com.obsidian.youask.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.obsidian.youask.model.entity.SysUser;

public interface IUserService extends IService<SysUser> {

}
  1. service/impl文件夹中增加UserService.java的实现
package com.obsidian.youask.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.obsidian.youask.model.entity.SysUser;

public interface IUserService extends IService<SysUser> {

}
  1. DBeaver连接MySQL数据，创建sys_user数据表
CREATETABLE`sys_user` (
	`user_id`bigintNOT NULLAUTO_INCREMENT COMMENT '用户ID',
	`user_name`varchar(20)NOT NULL COMMENT '用户账号',
	`password`varchar(32)NOT NULL COMMENT '加密后密码',
	`dept_id`bigintNOT NULL COMMENT '部门ID',
	`employee_no`varchar(20)CHARACTERSET utf8mb4COLLATE utf8mb4_0900_ai_ciDEFAULT NULL COMMENT '工号',
	`position`intDEFAULT NULL COMMENT '职位ID',
	`name`varchar(50)DEFAULT NULL COMMENT '姓名',
	`nick_name`varchar(50)NOT NULL COMMENT '用户昵称',
	`email`varchar(50)DEFAULT NULL COMMENT '用户邮箱地址',
	`phone_number`varchar(20)DEFAULT NULL COMMENT '手机号码',
	`gender`intDEFAULT NULL COMMENT '性别',
	`avatar`varchar(100)DEFAULT NULL COMMENT '用户头像URL',
	`last_login_time`datetimeDEFAULT NULL COMMENT '最后登陆时间',
	`last_login_ip`varchar(15)DEFAULT NULL COMMENT '最后登陆IP',
	`pwd_last_update_time`datetimeDEFAULT NULL COMMENT '密码最后更新时间',
	`status`intDEFAULT NULL COMMENT '状态',
	`is_deleted`intNOT NULLDEFAULT '0' COMMENT '是否删除',
	`updated_by`bigintDEFAULT NULL COMMENT '更新人ID',
	`updated_at`datetimeDEFAULT NULL COMMENT '更新时间',
	`created_by`bigintNOT NULL COMMENT '创建人ID',
	`created_at`datetimeNOT NULLDEFAULTCURRENT_TIMESTAMP COMMENT '创建时间',
	PRIMARYKEY (`user_id`)
)ENGINE=InnoDBDEFAULTCHARSET=utf8mb4COLLATE=utf8mb4_0900_ai_ci;
  1. 修改UserController中的getAll方法，实现从sys_user表中获取所有数据
@Autowired
private IUserService userService;

@GetMapping()
public YaResult<List<SysUser>> getAll() {
    return YaResult.success(userService.list());
}

@Autowired是 Spring 框架中的一个注解，主要用于实现依赖注入（Dependency Injection, DI）。它的核心作用是自动装配，即让 Spring 容器自动为类中的属性、构造方法或 setter 方法注入所需的依赖对象，无需手动创建和赋值。

简单说就是对象不需要自己new了，SpringBoot帮助我们自动new了个对象，比如这里的IUserService是个接口，具体的实现是UserService，SpringBoot就会自动用UserService类来实例化。如果IUserService这个接口有多个类实现了，可以使用@Primary，@Qualifier来指定具体使用哪个实现。

  1. 启动项目调试，在数据库里增加几条数据，在OpenAPI页面中打开getAll方法，在调试面板中点击“发送”，正常情况下就能看到从数据库获取到的结果。

getAll方法调试
这样从API获取请求，到数据库之间的打通了。

实现逻辑删除

从MyBatis输出的日志中可以看到实际生成的查询语句。

MyBatis 生成的 SQL 语句
生成的SQL语句比较简单，主要是字段，没有包含where语句。从User实际应用来看，至少应该包含2个默认的过滤

  • is_deleted=0，is_deleted=1表示记录逻辑删除
  • tenant_id租户过滤，这个默认应该获取当前登陆用户所在的租户，并添加where过滤（后续会加）

逻辑删除有2种实现方法，第一种是使用mybatis的QueryWrapper实现，手动增加is_deleted字段不等于0的判断，这样做的问题是所有的查询都需要添加这样语句。第二种实现方法是使用mybatis plus提供的逻辑删除。

逻辑删除是一种优雅的数据管理策略，它通过在数据库中标记记录为“已删除”而非物理删除，来保留数据的历史痕迹，同时确保查询结果的整洁性。MyBatis-Plus 提供了便捷的逻辑删除支持，使得这一策略的实施变得简单高效。

Mybatis Plus实现逻辑删除也很简单，在YaEntity类中增加@TableLogic的注释。0表示记录正常，1表示记录删除。

/** 
 * 删除标志
 * 0：正常
 * 1：删除
*/
@Schema(description = "逻辑删除标志")
@TableLogic(value = "0", delval = "1")
private Integer isDeleted;

在OpenAPI上重新发送请求，再看日志，可以发现增加了WHERE is_deleted=0，说明逻辑删除生效了。

SQL语句中包含了逻辑删除条件

实现添加和更新

  1. UserController中增加add方法用户新增用户
@PostMapping()
public YaResult<SysUser> add(@Valid @RequestBody SysUser user) {
    if (userService.save(user)) {
        return YaResult.success(user);
    }
    return YaResult.failed("Add user failed");
}
  1. 浏览器打开OpenAPI页面，定位到add方法，在body中输入完整的体
{
  "status": 0,
  "isDeleted": 0,
  "createdBy": 0,
  "createdAt": "",
  "updatedBy": 0,
  "updatedAt": "",
  "userId": 0,
  "userName": "ammey",
  "password": "123567",
  "deptId": 0,
  "employeeNo": "",
  "position": 0,
  "nickName": "",
  "name": "",
  "gender": 1,
  "email": "",
  "phoneNumber": "",
  "avatar": "",
  "lastLoginTime": "",
  "lastLoginIp": "",
  "pwdLastUpdateTime": ""
}

查看请求的SQL语句，发现辅助字段，比如status、isDeleted、createdBy、createdAt这些字段，如果再请求时不填写，新建对象是会报错的。我们可以用Mybatis Plus的自动填充字段功能，在insert或者update时，自动填充辅助字段。

  1. 在YaEntity类中，需要使用 @TableField 注解来标记哪些字段需要自动填充，并指定填充的策略。
@Data
public abstract class YaEntity implements Serializable {
    /** 
     * 状态
     * 0：停用
     * 1：正常
     */
    @Schema(description = "状态")
    @TableField(fill = FieldFill.INSERT)
    private Integer status;

    /** 
     * 删除标志
     * 0：正常
     * 1：删除
     */
    @Schema(description = "逻辑删除标志")
    @TableLogic(value = "0", delval = "1")
    @TableField(fill = FieldFill.INSERT)
    private Integer isDeleted;

    /**
     * 创建人ID
     */
    @Schema(description = "创建人ID")
    @TableField(fill = FieldFill.INSERT)
    private Integer createdBy;

    /**
     * 创建时间
     */
    @Schema(description = "创建时间")
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createdAt;

    /**
     * 更新人ID
     */
    @Schema(description = "更新人ID")
    @TableField(fill = FieldFill.UPDATE)
    private Integer updatedBy;

    /**
     * 更新时间
     */
    @Schema(description = "更新时间")
    @TableField(fill = FieldFill.UPDATE)
    private LocalDateTime updatedAt;
}
  1. config文件夹中创建EntityMetaObjectHandler.java，主要用来指定每个字段分别在insert和update的时候如何
package com.obsidian.youask.config;

import java.time.LocalDateTime;

import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;

@Component
public class EntityMetaObjectHandler implements MetaObjectHandler {

    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "status", Integer.class, 1);
        this.strictInsertFill(metaObject, "isDeleted", Integer.class, 0);
        this.strictInsertFill(metaObject, "createdBy", Long.class, 1L);
        this.strictInsertFill(metaObject, "createdAt", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "updatedBy", Long.class, 1L);
        this.strictUpdateFill(metaObject, "updatedAt", LocalDateTime.class, LocalDateTime.now());
    }
}
  1. 重新发送请求，删除请求数据中的status、isDeleted、createdBy、createdAt、updatedBy、updatedAt字段，可以看到生成的SQL语句中自动填充了数据。
{
  "userId": 0,
  "userName": "ammey",
  "password": "123567",
  "deptId": 0,
  "employeeNo": "",
  "position": 0,
  "nickName": "",
  "name": "",
  "gender": 1,
  "email": "",
  "phoneNumber": "",
  "avatar": "",
  "lastLoginTime": "",
  "lastLoginIp": "",
  "pwdLastUpdateTime": ""
}

执行add方法生成的SQL语句

实现queryByCondition方法

之所以把queryByCondition方法单独提出来讲，主要是这个方法相对来说比较复杂，它不包含具体业务（因为这个是通用方法，按照输入的查询条件，生成SQL的WHERE查询条件），但是流程覆盖从controller到service到mapper到database。

queryByCondition方法的作用是根据参数中的condition，自动拼接where条件，实现复杂条件的查询，主要用在列表页面的展示和查询功能上。

  1. resources/mapper文件夹中创建EntityMapper.xml，对应YaEntity.java对象

EntityMapper中的resultMap和Sql都是作为其他mapper的引用，并不直接执行，这个也是我觉得mapper.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.obsidian.youask.mapper.EntityMapper">
    <resultMap id="EntityMap" type="com.obsidian.youask.model.YaEntity">
        <result column="status" property="status" />
        <result column="is_deleted" property="isDeleted" />
        <result column="created_by" property="createdBy" />
        <result column="created_at" property="createdAt" />
        <result column="updated_by" property="updatedBy" />
        <result column="updated_at" property="updatedAt" />
    </resultMap>
    <sql id="entityCondtion">
        <if test="condition.status != null">
            and status = #{condition.status}
        </if>
        <if test="condition.statuses != null and condition.statuses.size() > 0">
            and status in
            <foreach collection="condition.statuses" item="item" open="(" separator="," close=")">
                #{item}
            </foreach>
        </if>
        <if test="condition.createdBy != null">
            and created_by = #{condition.createdBy}
        </if>
        <if test="condition.createUserIds != null and condition.createUserIds.size() > 0">
            and created_by in
            <foreach collection="condition.createUserIds" item="item" open="(" separator="," close=")">
                #{item}
            </foreach>
        </if>
        <if test="condition.startCreateTime != null">
            and created_at &gt;= #{condition.startCreateTime}
        </if>
        <if test="condition.endCreateTime != null">
            and created_at &lt; #{condition.endCreateTime}
        </if>
        <if test="condition.updatedBy != null">
            and updated_by = #{condition.updatedBy}
        </if>
        <if test="condition.updateUserIds != null and condition.updateUserIds.size() > 0">
            and updated_by in
            <foreach collection="condition.updateUserIds" item="item" open="(" separator="," close=")">
                #{item}
            </foreach>
        </if>
        <if test="condition.startUpdateTime != null">
            and updated_at &gt;= #{condition.startUpdateTime}
        </if>
        <if test="condition.endUpdateTime != null">
            and updated_at &lt; #{condition.endUpdateTime}
        </if>
    </sql>
</mapper>

EntityMapper定义了通用的查询条件，包活以下的字段：

  • status - 单状态查询
  • statuses - 状态列表查询
  • createdBy - 单创建人Id查询
  • createUserIds - 创建人Id列表查询
  • startCreateTime，endCreateTime - 开始、结束创建时间查询
  • updatedBy - 单更新人Id查询
  • updateUserIds - 更新人Id列表查询
  • startUpdateTime，endUpdateTime - 开始、结束更新时间查询
  1. resources/mapper文件夹中创建UserMapper.xml，对应SysUser.java对象
<?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.obsidian.youask.mapper.UserMapper">
    <resultMap id="UserMap" 
               extends="com.obsidian.youask.mapper.EntityMapper.EntityMap"
               type="com.obsidian.youask.model.entity.SysUser">
        <id column="user_id" property="userId"/>
        <result column="user_name" property="userName"/>
        <result column="password" property="password"/>
        <result column="dept_id" property="deptId"/>
        <result column="employee_no" property="employeeNo"/>
        <result column="position" property="position"/>
        <result column="nick_name" property="nickName"/>
        <result column="name" property="name"/>
        <result column="gender" property="gender"/>
        <result column="email" property="email"/>
        <result column="phone_number" property="phoneNumber"/>
        <result column="avatar" property="avatar"/>
        <result column="last_login_time" property="lastLoginTime"/>
        <result column="last_login_ip" property="lastLoginIp"/>
        <result column="pwd_last_update_time" property="pwdLastUpdateTime"/>
    </resultMap>

    <select id="selectByCondition" resultMap="UserMap" parameterType="java.util.Map">
        select * from sys_user where is_deleted = 0
        <if test="condition.userId != null">
            and user_id = #{condition.userId}
        </if>
        <if test="condition.userIds != null and condition.userIds.size() > 0">
            and user_id in
            <foreach collection="condition.userIds" item="item" open="(" separator="," close=")">
                #{item}
            </foreach>
        </if>
        <if test="condition.userName != null and condition.userName != ''">
            and user_name like concat('%', #{condition.userName}, '%')
        </if>
        <if test="condition.deptId != null">
            and dept_id = #{condition.deptId}
        </if>
        <if test="condition.deptIds != null and condition.deptIds.size() > 0">
            and dept_id in
            <foreach collection="condition.deptIds" item="item" open="(" separator="," close=")">
                #{item}
            </foreach>
        </if>
        <include refid="com.obsidian.youask.mapper.EntityMapper.EntityCondtion" />
    </select>
</mapper>
  • UserMapper中的resultMap从EntityMap扩展
  • UserMapper中selectByCondition引用了EntityMap的EntityCondtion
  1. IUserMapper中增加selectByCondition方法的定义
package com.obsidian.youask.mapper;

import java.util.Map;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.obsidian.youask.model.entity.SysUser;

public interface UserMapper extends BaseMapper<SysUser> {
    IPage<SysUser> selectByCondition(IPage<SysUser> page, Map<String, Object> condition);
}

IUserMapper定义了selectByCondition方法，输入参数和输出参数都为IPage对象，IPage对象是MyBatis Plus的内部模块，用于在数据库查询时提供分页能力。

MyBatis-Plus 的分页插件 PaginationInnerInterceptor 提供了强大的分页功能，支持多种数据库，使得分页查询变得简单高效。

这里的条件参数使用了Map<String, Object>类型，主要是因为后续mapper希望通过Mybatis Generator自动生成，根据不同表生成Condition对象不是很方便，所以这里选择了直接使用map方式。在很多SpringBoot项目标准中还是不建议使用这种方式的。

  1. IUserService的改造
package com.obsidian.youask.service;

import java.util.Map;

import com.baomidou.mybatisplus.extension.service.IService;
import com.obsidian.youask.model.YaPageResult;
import com.obsidian.youask.model.entity.SysUser;

public interface IUserService extends IService<SysUser> {

    public YaPageResult<SysUser> queryByCondition(Map<String, Object> condition, Integer pageIndex, Integer pageSize);
}
  1. UserServiceImpl的改造
package com.obsidian.youask.service.impl;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.obsidian.youask.mapper.UserMapper;
import com.obsidian.youask.model.YaPageResult;
import com.obsidian.youask.model.entity.SysUser;
import com.obsidian.youask.service.IUserService;

import java.util.Map;

import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, SysUser> implements IUserService {

    @Override
    public YaPageResult<SysUser> queryByCondition(Map<String, Object> condition, Integer pageIndex, Integer pageSize) {
        IPage<SysUser> page = new Page<>(pageIndex, pageSize);
        IPage<SysUser> result = baseMapper.selectByCondition(page, condition);
        return YaPageResult.success(result.getRecords(), pageIndex, pageSize, result.getTotal());
    }

}
  1. UserController改造
@PostMapping("query")
public YaPageResult<SysUser> queryByCondition(@RequestBody Map<String, Object> condition, 
    @RequestParam(defaultValue = YaConst.DEFAULT_PAGE_INDEX) Integer pageIndex, 
    @RequestParam(defaultValue = YaConst.DEFAULT_PAGE_SIZE) Integer pageSize) {
        return userService.queryByCondition(condition, pageIndex, pageSize);
}
  1. 配置Mybatis Plus分页插件

Mybatis Plus分页插件

在父项目pom项目中增加mybatis-plus-jsqlparser的引用

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-jsqlparser</artifactId>
    <version>3.5.12</version>
</dependency>

在youask-admin-api项目增加mybatis-plus-jsqlparser的引用

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-jsqlparser</artifactId>
</dependency>

config目录中创建MybatisPlusConfig配置文件

package com.obsidian.youask.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;

@Configuration
public class MybatisPlusConfig {

    /**
     * 添加分页插件
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); 
        return interceptor;
    }
}
  1. 调试queryByCondition方法

在浏览器中打开OpenAPI页面，定位到queryByCondition方法，在URL中增加pageIndex和pageSize参数

/users/query?pageIndex=1&pageSize=10

设置body参数

{
    "userIds": [1,2]
}

点击发送后可以看到查询结果，其中包含了page对象，保存了分页信息

queryByCondition方法执行结果

我们到后台看一下生成的SQL语句，可以看到查询条件user_id in 已经包含了，并且包含了LIMIT的限制用于实现分页。

queryByCondition方法生成的SQL语句

完善UserController的方法

package com.obsidian.youask.admin.controller;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import com.github.xiaoymin.knife4j.annotations.ApiSupport;
import com.obsidian.youask.admin.YaConst;
import com.obsidian.youask.admin.service.IUserService;
import com.obsidian.youask.common.model.YaPageResult;
import com.obsidian.youask.common.model.YaResult;
import com.obsidian.youask.common.model.YaResultCode;
import com.obsidian.youask.common.model.entity.SysUser;

import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.validation.Valid;
import lombok.extern.slf4j.Slf4j;

import java.util.List;
import java.util.Map;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;

@ApiSupport(author = YaConst.AUTHOR)
@Tag(name = "UserController", description = "用户服务")
@Slf4j
@RestController
@RequestMapping("users")
public class UserController {

    @Autowired
    private IUserService userService;

    /**
     * 获取所有用户
     * @return 用户列表
     */
    @GetMapping()
    public YaResult<List<SysUser>> getAll() {
        return YaResult.success(userService.list());
    }

    /**
     * 根据用户ID获取用户详情
     * @param userId 用户ID
     * @return 用户详情
     */
    @GetMapping("{userId}")
    public YaResult<SysUser> getById(@PathVariable Long userId) {
        return YaResult.success(userService.getById(userId));
    }

    /**
     * 根据条件查询用户列表
     * @param condition 查询条件对象
     * @return 用户列表
     */
@PostMapping("query")
public YaPageResult<SysUser> queryByCondition(@RequestBody Map<String, Object> condition, 
    @RequestParam(defaultValue = YaConst.DEFAULT_PAGE_INDEX) Integer pageIndex, 
    @RequestParam(defaultValue = YaConst.DEFAULT_PAGE_SIZE) Integer pageSize) {
        return userService.queryByCondition(condition, pageIndex, pageSize);
} 

    /**
     * 添加用户
     * @param user 待添加的用户对象
     * @return 添加后的用户对象
     */
    @PostMapping()
    public YaResult<SysUser> add(@Valid @RequestBody SysUser user) {
        if (userService.save(user)) {
            return YaResult.success(user);
        }
        return YaResult.failed(YaConst.MSG_TMPL_ADD_FAILED, "user");
    }

    /**
     * 根据用户ID更新用户信息
     * @param userId 用户ID
     * @param user 待更新的用户对象
     * @return 更新后的用户对象
     */
    @PutMapping("{userId}")
    public YaResult<SysUser> modifyById(@PathVariable Long userId, @RequestBody SysUser user) {
        user.setUserId(userId);
        if (userService.updateById(user)) {
            return YaResult.success(user);
        }
        return YaResult.failed(YaConst.MSG_TMPL_UPDATE_FAILED, "user", userId);
    }

    /**
     * 停用用户
     * @param userId 用户ID
     * @return 更新后的用户对象
     */
    @PutMapping("{userId}/deactive")
    public YaResult<SysUser> deactivateById(@PathVariable Long userId) {
        return updateStatus(userId, YaConst.STATUS_DEACTIVE);
    }

    /**
     * 激活用户
     * @param userId 用户ID
     * @return 更新后的用户对象
     */
    @PutMapping("{userId}/active")
    public YaResult<SysUser> activateById(@PathVariable Long userId) {
        return updateStatus(userId, YaConst.STATUS_ACTIVE);
    }

    /**
     * 更新用户状态
     * @param userId 用户ID
     * @param status 状态
     * @return 更新后的用户对象
     */
    private YaResult<SysUser> updateStatus(Long userId, Integer status) {
        SysUser user = userService.getById(userId);
        if (user == null) {
            return YaResult.failed(YaResultCode.NOT_FOUND, YaConst.MSG_TMPL_NOT_FOUND, "User", userId);
        }
        user.setStatus(status);
        if (userService.updateById(user)) {
            return YaResult.success(user);
        }
        return YaResult.failed(YaConst.MSG_TMPL_UPDATE_FAILED, "user", userId);
    }

    /**
     * 根据用户ID删除用户
     * @param userId 用户ID
     * @return 删除结果
     */
    @DeleteMapping("{userId}")
    public YaResult<Boolean> removeById(@PathVariable Long userId) {
        if (userService.removeById(userId)) {
            return YaResult.success(true);
        }
        return YaResult.failed(YaConst.MSG_TMPL_DELETE_FAILED, "user", userId);
    }
}

一般的Controller中会包含一些通用的API，这些API不包含具体的业务逻辑，是针对数据库中数据的CRUD操作，包括以下方法：

  • getAll - 获取所有（非删除）数据
  • getById - 根据Id获取数据
  • queryByCondition - 根据条件获取数据
  • add - 添加数据
  • modifyById - 根据Id修改数据
  • activateById - 根据Id启用数据
  • deactivateById - 根据Id停用数据
  • removeById - 根据Id删除数据

这说明一下我自己的一个命名规则：
Controller层、Service层更贴近业务，把业务数据看成是列表的形式，CRUD的命名使用add、remove、modify、get或者query。get表达简单条件，可以包含缓存，获取开销较低；query需要有复杂查询，获取开销较高；
Mapper层贴近数据库，是数据库的抽象层，CRUD的命名使用insert、delete、update和select；
方法命名会包含一些特定的格式，比如：
XXXById - 根据Id（主键）进行操作
XXXByCode - 根据Code进行操作
XXXByCondition - 根据复杂条件进行操作
XXXAsVO - 返回数据转换为VO对象
XXXWithXXX - 返回复杂的嵌套对象

后续工作

考虑到从API到数据库中的层次较多，同时数据表也会很多，每张数据表都需要这样逐层开发将会很费时间，所有我们会使用MyBatis Code Generator来自动生成这些模块话的代码。

YouAsk系列目录：

标签
#spring boot #mybatis #后端
电力电子技术速通复习
qq_62873973的博客
08-19 2477
一种完全纯净，结构完整的半导体晶体，其含有两种载流子而且，自由电子的浓度和空穴的浓度总是相等，一般情况下，在硅晶体中掺入P（磷）五价元素，多子为自由电子，少子为空穴；在硅晶体中掺入B（磷）三价元素，多子为空穴，少子为自由电子；6.PN结具有单相导电性，PN结具有雪崩击穿（T越高，击穿电压越大）和齐纳击穿（T越高，击穿电压越小），均可逆，热击穿不可逆；PN结具有电容效应，势垒电容（耗尽层变化等效的电容）扩散电容（非平衡少子引起的电荷量的变化等效出来的电容效应）
VMware Workstation 17 Pro 保姆级教程：手把手教你安装银河麒麟 Kylin V10 SP3 国产系统
weixin_30879169的博客
03-25 617
本文提供VMware Workstation 17 Pro安装银河麒麟Kylin V10 SP3的详细教程，涵盖环境准备、虚拟机配置、系统安装及优化全流程。通过分步指导和实用技巧，帮助用户高效搭建国产操作系统开发测试环境，特别适合技术自主可控需求场景下的虚拟化实践。
Java大厂面试实录：Spring Boot与微服务、Redis缓存、JWT安全、Prometheus监控全解析——记谢飞机的一次硬核面试
2602_95996092的博客
08-16 272
周六下午，互联网大厂“星河科技”的会议室里，阳光透过落地窗洒在长桌上。面试官李总眉头微蹙，翻看着眼前这位候选人的简历——谢飞机，三年Java开发经验，自我评价“精通全家桶”。对面，谢飞机正襟危坐，嘴角带着一丝自信到发光的微笑。李总推了推眼镜，语气平淡：“谢飞机先生，我们开始吧。今天聊电商后端场景，你平时写代码用什么Java版本？
Java数据可视化实战：基于JFreeChart的数学函数绘图工具开发
2201_76125393的博客
08-19 350
JFreeChart是一个开源的Java图表库，适用于Swing和JavaFX应用程序。折线图和面积图柱状图和饼图散点图和气泡图组合图表3D图表等实现自定义数学表达式解析：java复制下载throw new IllegalArgumentException("表达式不能为空");// 验证表达式try {}");throw new IllegalArgumentException("无效的数学表达式: " + e.getMessage());try {
漏洞预警｜Fastjson2 高危RCE漏洞（QVD-2026-45876）全网爆发，Spring Boot项目自查修复指南
srlsong的博客
08-19 217
Fastjson2 作为阿里开源的高性能 JSON 解析框架，广泛应用于 Java 后端、Spring Boot 微服务、API 网关、中间件、政企系统等绝大多数业务场景。Fastjson2 2.0.62 及以下全版本存在高危远程代码执行漏洞。不同于传统 Fastjson 反序列化漏洞，本次漏洞利用方式全新，属于gadget-free 无依赖利用链，彻底绕过以往 AutoType 关闭的防护策略，传统应急防护全部失效。攻击者仅需公网可访问的接口，构造携带恶意@type。
【计算机毕业设计】基于Spring Boot的宠物领养救助平台的设计与实现
2601_96387018的博客
08-16 239
本文设计并实现了一个基于Java SpringBoot和Vue框架的宠物领养救助平台，旨在解决传统线下救助模式存在的信息不对称、流程不规范等问题。系统采用前后端分离架构，包含用户端和管理员端两大模块：用户端提供注册登录、宠物浏览、领养申请、救助活动参与等全流程服务；管理员端实现用户管理、内容审核、数据统计等后台功能。通过E-R图完成数据库设计，确保数据一致性和系统性能。该平台规范了宠物救助领养流程，为公益事业提供数字化支撑，推动行业向规范化、高效化方向发展。系统功能涵盖宠物信息管理、志愿者招募、养护指南查询
Spring Boot 3 + Vue 3 全栈外卖系统：RabbitMQ异步解耦、MySQL/Neo4j双引擎推建
2303_79635409的博客
08-19 403
后端：Spring Boot 3.2.5 + MyBatis-Plus + Redis + RabbitMQ + Neo4j + 支付宝沙箱前端核心业务覆盖：用户注册登录、菜品浏览、购物车管理、下单结算、支付宝支付、订单状态实时同步、支付成功邮件通知等完整闭环。系统实现了基于用户行为的个性化推荐、基于图数据库的购物车共现推荐、以及基于消息队列的全链路异步解耦。
Spring Boot 入门指南：从零开始构建你的第一个应用
2601_96491970的博客
08-17 212
Spring Boot 是 Pivotal 团队在 Spring 框架基础上推出的一个全新开源框架，其设计目的是用来简化 Spring 应用的初始搭建以及开发过程。它采用了“约定优于配置”的理念，让开发者能够快速创建独立的、生产级别的基于 Spring 的应用程序。核心特性：自动配置：根据项目依赖自动配置 Spring 应用。独立运行：内嵌了 Tomcat、Jetty 或 Undertow 等 Web 服务器，无需部署 WAR 文件。生产就绪：提供诸如健康检查、指标、外部化配置等生产级特性。
大厂Java面试：Spring Boot、JVM、Redis、Kafka与Elasticsearch在内容社区UGC场景下的实战拷问
2602_95996092的博客
08-18 191
下一位，谢飞机。”面试官王工翻看着简历，头也不抬地说。谢飞机挺直腰板走进会议室，坐下后紧张地搓了搓手：“面试官好，我叫谢飞机，Java后端开发三年经验，主要做内容社区方向的业务。王工抬眼看了他一下：“三年经验，简历上写了Spring Boot、Redis、Kafka、Elasticsearch这些。那我们直接进入正题，你们社区的核心功能是什么？我们那套系统日活大概五十万，我负责的模块是内容发布和动态流。王工点点头：“行，先从你熟悉的说起。
Spring Boot 打成 JAR 后，application.yml 到底按什么顺序加载？
weixin_49990593的博客
08-17 299
classpath:/ → classpath:/config/ → ./ → ./config/，越往后越优先。
Spring Boot中使用缓存
wno704的博客
08-19 366
在程序中可以使用缓存的技术来节省对数据库的开销。Spring Boot对缓存提供了很好的支持，我们几乎不用做过多的配置即可使用各种缓存实现。这里主要介绍平日里个人接触较多的Ehcache和Redis缓存实现。
Micrometer 系列【68】统一观测：基于 Spring Boot 的生产级演示案例 | 跨进程场景
记录知识、锤炼自我
08-16 331
单进程里，Micrometer 的 Observation 靠 openScope() 维护一张 ThreadLocal 栈，子观测自动成为父观测的 child，Span 自动串成树。
数据库读写分离与动态路由实战：Spring Boot + ShardingSphere-JDBC 生产配置
最新发布
专注分享原创技术干货。大厂资深架构师，多年技术架构与技术管理经验，多年面试官经验。一对一技术指导培训，带你从小白到入门到架构设计到技术管理。关注我，免费领取学习资料。一对一免费面试指导，快速拿offer。
08-21 214
摘要（149字） ShardingSphere-JDBC解决传统读写分离方案的三大痛点：事务内读错库、配置硬编码、结果集归并复杂。其核心流程包括SQL解析、路由（写操作强制主库/读操作负载均衡）、改写、并行执行和内存归并，通过绑定事务上下文规避主从延迟问题。生产配置需关注主库事务读、权重负载均衡和连接池参数，支持动态扩缩容和Hint强制读主。针对分页查询建议改用游标查询，分布式ID推荐雪花算法。
Spring Boot 可执行 JAR 原理与应用启动速度优化
weixin_51228134的博客
08-20 542
本文解析了SpringBoot可执行JAR与普通JAR的区别，并提供了启动优化的系统方法。SpringBoot JAR通过特殊结构（BOOT-INF目录和内置Loader）实现依赖打包和独立运行，而普通JAR仅是类库。针对启动慢问题，建议先分析耗时环节，再依次处理无用依赖、扫描范围、外部连接等关键因素，最后考虑懒加载等高级方案。强调优化需保持功能完整，通过基准测试验证效果，避免盲目调整配置。文末总结了面试常见问题，为开发者提供了实用指南。
API 版本化管理与平滑迁移：Spring Boot 路由策略与生产级治理实践
专注分享原创技术干货。大厂资深架构师，多年技术架构与技术管理经验，多年面试官经验。一对一技术指导培训，带你从小白到入门到架构设计到技术管理。关注我，免费领取学习资料。一对一免费面试指导，快速拿offer。
08-18 238
本文针对接口版本管理提出了实战解决方案，主要包含三个核心要点： 版本标识选择：对比分析了URL Path/Header/Query/Media Type四种方案，推荐无网关团队使用Path，有网关则优先采用Header方案，强调团队统一规范的重要性。 Spring路由实现：通过自定义ApiVersion注解和RequestCondition实现版本路由解耦，将版本控制逻辑从业务代码抽离到框架层，保持Controller纯净，支持多版本并行维护。 兼容性设计：强调DTO必须按版本隔离（如UserV1/V2DT
Spring Boot 3.x 虚拟线程实战：高并发改造与线上避坑指南
专注分享原创技术干货。大厂资深架构师，多年技术架构与技术管理经验，多年面试官经验。一对一技术指导培训，带你从小白到入门到架构设计到技术管理。关注我，免费领取学习资料。一对一免费面试指导，快速拿offer。
08-19 229
虚拟线程（Virtual Threads）是 JDK 21 引入的高并发解决方案，通过 M:N 映射模型大幅提升 IO 密集型任务性能。在 Spring Boot 3.2+ 中，只需简单配置即可启用虚拟线程，但需注意 ThreadLocal 上下文隔离和连接池优化等关键点。实际应用中需区分任务类型：IO 密集型适合虚拟线程，CPU 密集型仍需传统线程池。线上需警惕 synchronized 导致的线程钉住问题，并通过 JFR 和指标监控优化性能。升级建议从非核心业务灰度开始，逐步验证稳定性。虚拟线程显著降低
从Spring Boot到Kafka再到JVM调优：电商场景Java高频面试实战记录
2602_95996092的博客
08-16 181
面试官王工推了推眼镜，看着对面坐着的一位头发略显凌乱、背着双肩包的年轻人——谢飞机。王工打开简历，目光在“熟练掌握微服务架构”一行停了两秒，然后抬起头。王工：“谢飞机对吧？先做个简单自我介绍。谢飞机：“面试官好，我叫谢飞机，花名‘真机’，三年Java经验，主要在电商行业做后端开发，用过Spring Boot、MyBatis、Redis、Kafka这些，平时也看看JVM调优，喜欢研究新技术。王工点点头：“好，那咱们开始。今天聊一个实际的电商下单场景。
高可靠消息驱动架构：Spring Boot 对接 MQ 的防丢失、防重放与积压治理
专注分享原创技术干货。大厂资深架构师，多年技术架构与技术管理经验，多年面试官经验。一对一技术指导培训，带你从小白到入门到架构设计到技术管理。关注我，免费领取学习资料。一对一免费面试指导，快速拿offer。
08-16 618
摘要： 本文针对MQ在生产环境中的可靠性问题，提出了一套从选型到落地的实战方案。核心观点包括： 选型需匹配业务需求：RabbitMQ适合强一致性场景，RocketMQ支持事务消息，Kafka则侧重高吞吐流处理。 生产者端：通过本地消息表（Outbox模式）确保消息必达，避免分布式事务的复杂性。 消费者端：手动ACK、限流重试（指数退避）和死信队列（DLQ）是关键，需关闭自动ACK并限制预取量。 幂等性设计：通过唯一索引或状态机+乐观锁避免重复消息导致的数据不一致。 积压治理：监控基线+降级预案，补偿脚本需提
海量数据异步导出与流式报表：Spring Boot + EasyExcel 生产级实践
专注分享原创技术干货。大厂资深架构师，多年技术架构与技术管理经验，多年面试官经验。一对一技术指导培训，带你从小白到入门到架构设计到技术管理。关注我，免费领取学习资料。一对一免费面试指导，快速拿offer。
08-16 213
摘要：本文针对传统Spring Boot后台数据导出服务的高并发痛点，提出一套生产级解决方案。通过JDBC流式查询（MySQL需配置useCursorFetch）、EasyExcel分批写入（2000~5000行/批）、独立线程池异步处理（CallerRunsPolicy背压）三核心手段，有效规避OOM与网关超时问题。结合Redis进度追踪、OSS分片上传实现断点续传，实测可稳定支持千万级数据导出。关键点包括：MyBatis的Cursor游标必须显式关闭、POI样式对象复用、双线程池隔离计算与IO任务，以及
复杂检索引擎落地：Spring Boot + Elasticsearch 数据同步与高阶查询实战
专注分享原创技术干货。大厂资深架构师，多年技术架构与技术管理经验，多年面试官经验。一对一技术指导培训，带你从小白到入门到架构设计到技术管理。关注我，免费领取学习资料。一对一免费面试指导，快速拿offer。
08-16 540
MySQL复杂查询性能瓶颈与Elasticsearch架构演进实践 当业务量增长导致MySQL复杂查询性能下降时，引入Elasticsearch成为必要选择。本文基于实战经验，提出关键实施策略： 引入时机判断：单表超500万数据、查询延迟持续超2秒、业务需要全文检索/实时聚合时考虑ES。 数据同步方案：推荐Canal+Kafka+消费者模式，实现业务解耦与最终一致性，需注意GTID配置和消费组隔离。 Mapping设计原则：中文场景使用ik分词器，合理配置字段类型，控制分片数量（20-50GB/片），调整r
零停机数据库演进：Spring Boot 集成 Flyway 与平滑DDL变更策略
专注分享原创技术干货。大厂资深架构师，多年技术架构与技术管理经验，多年面试官经验。一对一技术指导培训，带你从小白到入门到架构设计到技术管理。关注我，免费领取学习资料。一对一免费面试指导，快速拿offer。
08-18 321
线上数据库变更最怕DDL操作引发连接池打满、主从延迟飙升等问题。本文拆解了Spring Boot+Flyway的平滑DDL变更方案，指出MySQL DDL本质是物理页重构，分析了COPY/INPLACE/INSTANT三种算法的适用场景。生产环境的关键在于采用"扩-迁-收"的并行变更策略：先兼容性扩展结构，再双写迁移数据，最后清理冗余字段。同时强调Flyway脚本需与应用发布解耦，通过独立Job执行，并配置严格的发布检查清单和熔断机制。文中还总结了典型故障案例，如大表加索引阻塞连接池、主从延迟导致字段不可见
spring boot启动流程总结
HH_HH_HH1的博客
08-18 263
同时也可以通过@conditional进行过滤和去重。完成之后会将满足条件的自动配置类注册核心bean到spring容器之中。最后通过@configurationproperties绑定配置文件application.yml中的属性，覆盖默认值。首先程序启动时都会有一个main函数作为入口，spring boot也有一个main函数作为入口，就是启动类。
使用Spring Boot发送邮件
wno704的博客
08-20 318
在项目的维护过程中，我们通常会在应用中加入短信或者邮件预警功能，比如当应用出现异常宕机时应该及时地将预警信息发送给运维或者开发人员，本文将介绍如何在Spring Boot中发送邮件。在Spring Boot中发送邮件使用的是Spring提供的org.springframework.mail.javamail.JavaMailSender，其提供了许多简单易用的方法，可发送简单的邮件、HTML格式的邮件、带附件的邮件，并且可以创建邮件模板。
Unity游戏源码分享-射击游戏Low Poly FPS Pack 3.2
Unity游戏源码分享-射击游戏Low Poly FPS Pack 3.2
JAVA API官方文档中文版
JAVA API官方文档中文版，CHM格式，查询非常方便。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值