
要做好架构设计,首先需厘清云原生数据库的核心特性,及其与传统数据库、传统分布式数据库的本质区别,避免架构设计中的认知偏差。
根据CNCF(Cloud Native Computing Foundation,云原生计算基金会)对云原生技术的定义,云原生数据库是为云环境而生,深度融合云计算弹性、分布式、自愈等核心能力的数据库服务。其核心特性并非简单的“数据库上云”,而是具备以下权威属性(参考CNCF《云原生数据库技术白皮书》):
很多开发者容易将“传统分布式数据库”与“云原生数据库”混淆,二者的核心差异体现在“设计理念”而非“部署方式”,具体对比如下:
对比维度 | 传统单体/分布式数据库 | 云原生数据库 |
|---|---|---|
资源扩展方式 | 垂直扩容(升级硬件)或手动水平扩容 | 自动弹性扩容,计算/存储独立扩展 |
部署依赖 | 依赖物理机/虚拟机,部署配置复杂 | 依赖K8s等容器编排,部署自动化、可编排 |
故障处理 | 需人工介入排查,恢复时间长 | 自动检测故障,自愈切换,无需人工干预 |
资源利用率 | 资源预留冗余,利用率低(通常≤50%) | 按需分配资源,利用率≥80%,成本更优 |
生态集成 | 需额外开发适配云组件 | 原生兼容云原生生态,开箱即用 |
关键结论:云原生数据库的核心优势是“适配云环境的弹性与自动化能力”,而非单纯的分布式存储。企业架构设计时,需从“资源按需分配、业务高可用、运维自动化”三个核心目标出发,而非仅关注数据分布式存储。
基于云原生数据库的企业信息系统架构设计,需遵循“业务驱动、弹性优先、高可用兜底、运维自动化”四大核心原则,同时参考《企业架构设计指南》(TOGAF框架)的分层设计思想,确保架构的合理性与可扩展性。
架构设计需紧密贴合业务场景,避免“为了云原生而云原生”。例如:
架构设计需最大化利用云原生数据库的弹性能力,核心设计要点:
企业信息系统的核心诉求是“业务不中断”,基于云原生数据库的高可用设计需满足“跨可用区、多层容错”:
云原生架构的核心目标之一是“降低运维成本”,架构设计需融入自动化能力:
架构设计的落地关键在于组件选型,需结合“业务场景、稳定性、生态兼容性”三大要素,选择最新稳定版本的组件。以下是企业级信息系统的核心组件选型方案(所有版本均为2025年最新稳定版):
根据业务场景不同,推荐以下主流且稳定的云原生数据库:
业务场景 | 推荐数据库 | 最新稳定版本 | 核心优势 | 适用企业规模 |
|---|---|---|---|---|
交易系统(强一致) | OceanBase | 4.3.0 | 金融级高可用,支持强一致性,兼容MySQL | 中大型企业 |
通用业务(性价比) | 阿里云PolarDB MySQL | 8.0.32 | 兼容MySQL,弹性扩容,按需付费 | 中小企业 |
HTAP场景(实时分析) | TiDB | 7.5.0 | 支持OLTP+OLAP,分布式架构,兼容MySQL | 中大型企业 |
非关系型数据(文档) | MongoDB Atlas | 7.0.5 | 云原生托管,弹性扩展,支持文档存储 | 全规模企业 |
缓存场景 | Redis Cloud | 7.2.4 | 云原生托管,自动分片,高可用 | 全规模企业 |
基于TOGAF分层架构思想,结合云原生数据库的特性,企业信息系统架构可分为“前端层、网关层、应用服务层、数据访问层、数据存储层、基础设施层”六大核心层级。各层级职责清晰,通过标准化接口交互,确保架构的可扩展性与可维护性。



以下结合企业最常用的“用户管理系统”,提供从环境配置、代码实现到数据库脚本的完整实例,所有代码均基于JDK17、最新稳定版本组件,严格遵循《阿里巴巴Java开发手册(嵩山版)》,确保可编译运行。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.2.5</version>
<relativePath/><!-- lookup parent from repository -->
</parent>
<groupId>com.jam.demo</groupId>
<artifactId>user-service</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>user-service</name>
<description>用户管理服务(基于云原生架构)</description>
<properties>
<java.version>17</java.version>
<spring-cloud.version>2023.0.1</spring-cloud.version>
<mybatis-plus.version>3.5.5</mybatis-plus.version>
<seata.version>2.0.0</seata.version>
<springdoc.version>2.5.0</springdoc.version>
<guava.version>32.1.3</guava.version>
<fastjson2.version>2.0.50</fastjson2.version>
</properties>
<dependencies>
<!-- Spring Boot核心依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- 服务注册发现(Nacos) -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
<!-- 持久层(MyBatis-Plus) -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>${mybatis-plus.version}</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-core</artifactId>
<version>${mybatis-plus.version}</version>
</dependency>
<!-- 数据库驱动(OceanBase/MySQL兼容) -->
<dependency>
<groupId>com.oceanbase</groupId>
<artifactId>oceanbase-client</artifactId>
<version>2.4.0</version>
</dependency>
<!-- 分布式事务(Seata) -->
<dependency>
<groupId>io.seata</groupId>
<artifactId>seata-spring-boot-starter</artifactId>
<version>${seata.version}</version>
</dependency>
<!-- API文档(Swagger3) -->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<version>${springdoc.version}</version>
</dependency>
<!-- 工具类 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.30</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>${guava.version}</version>
</dependency>
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2</artifactId>
<version>${fastjson2.version}</version>
</dependency>
<!-- 测试依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<!-- Spring Cloud依赖管理 -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2023.0.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>${spring-cloud.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<excludes>
<exclude>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
</build>
</project>
spring:
application:
name:user-service# 服务名称
cloud:
nacos:
discovery:
server-addr:127.0.0.1:8848# Nacos服务地址
config:
server-addr:127.0.0.1:8848
file-extension:yml
datasource:
driver-class-name:com.oceanbase.jdbc.Driver
url:jdbc:oceanbase://127.0.0.1:2881/test?useUnicode=true&characterEncoding=utf-8&useSSL=false
username:root
password:root123456
hikari:
maximum-pool-size:20# 连接池最大连接数
minimum-idle:5# 最小空闲连接数
idle-timeout:300000# 空闲连接超时时间(5分钟)
# MyBatis-Plus配置
mybatis-plus:
mapper-locations:classpath:mapper/*.xml
type-aliases-package:com.jam.demo.entity
configuration:
map-underscore-to-camel-case:true# 下划线转驼峰
log-impl:org.apache.ibatis.logging.stdout.StdOutImpl# 打印SQL日志
# Seata配置
seata:
application-id:${spring.application.name}
tx-service-group:default_tx_group
service:
vgroup-mapping:
default_tx_group:default
grouplist:
default:127.0.0.1:8091
config:
type:nacos
nacos:
server-addr:127.0.0.1:8848
group:SEATA_GROUP
registry:
type:nacos
nacos:
server-addr:127.0.0.1:8848
group:SEATA_GROUP
# SpringDoc-Swagger3配置
springdoc:
api-docs:
path:/v3/api-docs
swagger-ui:
path:/swagger-ui.html
operationsSorter:method
packages-to-scan:com.jam.demo.controller
# 日志配置
logging:
level:
root:info
com.jam.demo:debug
pattern:
console:"%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n"
# 服务端口
server:
port:8081
-- 创建用户表
CREATETABLE`sys_user` (
`id`bigintNOTNULL AUTO_INCREMENT COMMENT'用户ID',
`username`varchar(50) NOTNULLCOMMENT'用户名',
`password`varchar(100) NOTNULLCOMMENT'密码(加密存储)',
`real_name`varchar(50) DEFAULTNULLCOMMENT'真实姓名',
`phone`varchar(20) DEFAULTNULLCOMMENT'手机号',
`email`varchar(100) DEFAULTNULLCOMMENT'邮箱',
`status`tinyintNOTNULLDEFAULT1COMMENT'状态:1-正常,0-禁用',
`create_time` datetime NOTNULLDEFAULTCURRENT_TIMESTAMPCOMMENT'创建时间',
`update_time` datetime NOTNULLDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMPCOMMENT'更新时间',
PRIMARY KEY (`id`),
UNIQUEKEY`uk_username` (`username`),
KEY`idx_phone` (`phone`)
) ENGINE=InnoDBDEFAULTCHARSET=utf8mb4 COMMENT='系统用户表';
-- 创建角色表
CREATETABLE`sys_role` (
`id`bigintNOTNULL AUTO_INCREMENT COMMENT'角色ID',
`role_name`varchar(50) NOTNULLCOMMENT'角色名称',
`role_code`varchar(50) NOTNULLCOMMENT'角色编码',
`remark`varchar(200) DEFAULTNULLCOMMENT'备注',
`create_time` datetime NOTNULLDEFAULTCURRENT_TIMESTAMPCOMMENT'创建时间',
`update_time` datetime NOTNULLDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMPCOMMENT'更新时间',
PRIMARY KEY (`id`),
UNIQUEKEY`uk_role_code` (`role_code`)
) ENGINE=InnoDBDEFAULTCHARSET=utf8mb4 COMMENT='系统角色表';
-- 创建用户角色关联表
CREATETABLE`sys_user_role` (
`id`bigintNOTNULL AUTO_INCREMENT COMMENT'ID',
`user_id`bigintNOTNULLCOMMENT'用户ID',
`role_id`bigintNOTNULLCOMMENT'角色ID',
`create_time` datetime NOTNULLDEFAULTCURRENT_TIMESTAMPCOMMENT'创建时间',
PRIMARY KEY (`id`),
UNIQUEKEY`uk_user_role` (`user_id`,`role_id`),
KEY`idx_role_id` (`role_id`)
) ENGINE=InnoDBDEFAULTCHARSET=utf8mb4 COMMENT='用户角色关联表';
-- 初始化数据
INSERTINTO`sys_role` (`role_name`, `role_code`, `remark`) VALUES
('超级管理员', 'SUPER_ADMIN', '拥有系统全部权限'),
('普通用户', 'COMMON_USER', '拥有基础访问权限');
INSERTINTO`sys_user` (`username`, `password`, `real_name`, `phone`, `email`, `status`) VALUES
('admin', '$2a$10$EixZaYb4xU58Gpq1R0yWbeb00LU5qUaK6x8h8H9x0yW7y5m5G7y5m', '超级管理员', '13800138000', 'admin@jam.com', 1),
('test', '$2a$10$EixZaYb4xU58Gpq1R0yWbeb00LU5qUaK6x8h8H9x0yW7y5m5G7y5m', '测试用户', '13800138001', 'test@jam.com', 1);
INSERTINTO`sys_user_role` (`user_id`, `role_id`) VALUES
(1, 1),
(2, 2);
package com.jam.demo.entity;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.time.LocalDateTime;
/**
* 系统用户实体类
* @author ken
* @date 2025-05-20
*/
@Data
@TableName("sys_user")
publicclass SysUser {
/**
* 用户ID
*/
@TableId(type = IdType.AUTO)
private Long id;
/**
* 用户名
*/
private String username;
/**
* 密码(加密存储)
*/
private String password;
/**
* 真实姓名
*/
private String realName;
/**
* 手机号
*/
private String phone;
/**
* 邮箱
*/
private String email;
/**
* 状态:1-正常,0-禁用
*/
private Integer status;
/**
* 创建时间
*/
private LocalDateTime createTime;
/**
* 更新时间
*/
private LocalDateTime updateTime;
}
package com.jam.demo.entity;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.time.LocalDateTime;
/**
* 系统角色实体类
* @author ken
* @date 2025-05-20
*/
@Data
@TableName("sys_role")
publicclass SysRole {
/**
* 角色ID
*/
@TableId(type = IdType.AUTO)
private Long id;
/**
* 角色名称
*/
private String roleName;
/**
* 角色编码
*/
private String roleCode;
/**
* 备注
*/
private String remark;
/**
* 创建时间
*/
private LocalDateTime createTime;
/**
* 更新时间
*/
private LocalDateTime updateTime;
}
package com.jam.demo.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.jam.demo.entity.SysUser;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import java.util.List;
/**
* 系统用户Mapper
* @author ken
* @date 2025-05-20
*/
@Mapper
publicinterface SysUserMapper extends BaseMapper<SysUser> {
/**
* 根据用户名查询用户
* @param username 用户名
* @return 系统用户实体
*/
SysUser selectByUsername(@Param("username") String username);
/**
* 根据角色ID查询用户列表
* @param roleId 角色ID
* @return 用户列表
*/
List<SysUser> selectByRoleId(@Param("roleId") Long roleId);
}
package com.jam.demo.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.jam.demo.entity.SysRole;
import org.apache.ibatis.annotations.Mapper;
/**
* 系统角色Mapper
* @author ken
* @date 2025-05-20
*/
@Mapper
public interface SysRoleMapper extends BaseMapper<SysRole> {
}
package com.jam.demo.service;
import com.baomidou.mybatisplus.extension.service.IService;
import com.jam.demo.entity.SysUser;
import com.jam.demo.vo.UserVO;
import java.util.List;
/**
* 系统用户服务接口
* @author ken
* @date 2025-05-20
*/
publicinterface SysUserService extends IService<SysUser> {
/**
* 根据用户名查询用户信息(含角色)
* @param username 用户名
* @return 用户VO
*/
UserVO getUserByUsername(String username);
/**
* 分页查询用户列表
* @param pageNum 页码
* @param pageSize 每页条数
* @param keyword 搜索关键词(用户名/手机号/邮箱)
* @return 用户列表
*/
List<SysUser> listUserByPage(Integer pageNum, Integer pageSize, String keyword);
/**
* 新增用户(含角色关联)
* @param sysUser 用户实体
* @param roleIds 角色ID列表
* @return 新增是否成功
*/
boolean saveUserWithRole(SysUser sysUser, List<Long> roleIds);
/**
* 更新用户状态
* @param id 用户ID
* @param status 状态:1-正常,0-禁用
* @return 更新是否成功
*/
boolean updateUserStatus(Long id, Integer status);
}
package com.jam.demo.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.google.common.collect.Lists;
import com.jam.demo.entity.SysRole;
import com.jam.demo.entity.SysUser;
import com.jam.demo.entity.SysUserRole;
import com.jam.demo.mapper.SysRoleMapper;
import com.jam.demo.mapper.SysUserMapper;
import com.jam.demo.mapper.SysUserRoleMapper;
import com.jam.demo.service.SysUserService;
import com.jam.demo.vo.UserVO;
import io.seata.spring.annotation.GlobalTransactional;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.BeanUtils;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.util.CollectionUtils;
import org.springframework.util.ObjectUtils;
import org.springframework.util.StringUtils;
import javax.annotation.Resource;
import java.util.List;
import java.util.stream.Collectors;
/**
* 系统用户服务实现类
* @author ken
* @date 2025-05-20
*/
@Service
@Slf4j
publicclass SysUserServiceImpl extends ServiceImpl<SysUserMapper, SysUser> implements SysUserService {
@Resource
private SysUserMapper sysUserMapper;
@Resource
private SysRoleMapper sysRoleMapper;
@Resource
private SysUserRoleMapper sysUserRoleMapper;
/**
* 根据用户名查询用户信息(含角色)
* @param username 用户名
* @return 用户VO
*/
@Override
public UserVO getUserByUsername(String username) {
// 校验参数
StringUtils.hasText(username, "用户名不能为空");
// 查询用户基本信息
SysUser sysUser = sysUserMapper.selectByUsername(username);
if (ObjectUtils.isEmpty(sysUser)) {
log.warn("用户名[{}]不存在", username);
returnnull;
}
// 查询用户角色
List<SysRole> roleList = sysRoleMapper.selectList(
new LambdaQueryWrapper<SysRole>()
.inSql(SysRole::getId, "SELECT role_id FROM sys_user_role WHERE user_id = " + sysUser.getId())
);
// 组装VO返回
UserVO userVO = new UserVO();
BeanUtils.copyProperties(sysUser, userVO);
if (!CollectionUtils.isEmpty(roleList)) {
userVO.setRoleNames(roleList.stream().map(SysRole::getRoleName).collect(Collectors.toList()));
userVO.setRoleCodes(roleList.stream().map(SysRole::getRoleCode).collect(Collectors.toList()));
}
return userVO;
}
/**
* 分页查询用户列表
* @param pageNum 页码
* @param pageSize 每页条数
* @param keyword 搜索关键词
* @return 用户列表
*/
@Override
public List<SysUser> listUserByPage(Integer pageNum, Integer pageSize, String keyword) {
// 校验参数
if (ObjectUtils.isEmpty(pageNum) || pageNum < 1) {
pageNum = 1;
}
if (ObjectUtils.isEmpty(pageSize) || pageSize < 1 || pageSize > 100) {
pageSize = 10;
}
// 构建分页查询条件
Page<SysUser> page = new Page<>(pageNum, pageSize);
LambdaQueryWrapper<SysUser> queryWrapper = new LambdaQueryWrapper<>();
if (StringUtils.hasText(keyword)) {
queryWrapper.like(SysUser::getUsername, keyword)
.or().like(SysUser::getPhone, keyword)
.or().like(SysUser::getEmail, keyword);
}
queryWrapper.orderByDesc(SysUser::getCreateTime);
// 执行分页查询
Page<SysUser> userPage = sysUserMapper.selectPage(page, queryWrapper);
return userPage.getRecords();
}
/**
* 新增用户(含角色关联)
* @param sysUser 用户实体
* @param roleIds 角色ID列表
* @return 新增是否成功
*/
@Override
@GlobalTransactional(rollbackFor = Exception.class) // 分布式事务注解
public boolean saveUserWithRole(SysUser sysUser, List<Long> roleIds) {
// 校验参数
StringUtils.hasText(sysUser.getUsername(), "用户名不能为空");
StringUtils.hasText(sysUser.getPassword(), "密码不能为空");
if (CollectionUtils.isEmpty(roleIds)) {
thrownew IllegalArgumentException("至少选择一个角色");
}
// 1. 新增用户
int insertUser = sysUserMapper.insert(sysUser);
if (insertUser <= 0) {
log.error("新增用户失败,用户信息:{}", sysUser);
returnfalse;
}
// 2. 新增用户角色关联
List<SysUserRole> userRoleList = Lists.newArrayList();
for (Long roleId : roleIds) {
SysUserRole userRole = new SysUserRole();
userRole.setUserId(sysUser.getId());
userRole.setRoleId(roleId);
userRoleList.add(userRole);
}
int insertUserRole = sysUserRoleMapper.batchInsert(userRoleList);
if (insertUserRole <= 0) {
log.error("新增用户角色关联失败,用户ID:{},角色ID列表:{}", sysUser.getId(), roleIds);
returnfalse;
}
log.info("新增用户成功,用户ID:{}", sysUser.getId());
returntrue;
}
/**
* 更新用户状态
* @param id 用户ID
* @param status 状态
* @return 更新是否成功
*/
@Override
@Transactional(rollbackFor = Exception.class)
public boolean updateUserStatus(Long id, Integer status) {
// 校验参数
if (ObjectUtils.isEmpty(id)) {
thrownew IllegalArgumentException("用户ID不能为空");
}
if (!status.equals(0) && !status.equals(1)) {
thrownew IllegalArgumentException("状态值只能是0或1");
}
// 查询用户是否存在
SysUser sysUser = sysUserMapper.selectById(id);
if (ObjectUtils.isEmpty(sysUser)) {
log.warn("用户ID[{}]不存在", id);
returnfalse;
}
// 更新状态
SysUser updateUser = new SysUser();
updateUser.setId(id);
updateUser.setStatus(status);
int updateCount = sysUserMapper.updateById(updateUser);
if (updateCount > 0) {
log.info("更新用户状态成功,用户ID:{},新状态:{}", id, status);
returntrue;
} else {
log.error("更新用户状态失败,用户ID:{},新状态:{}", id, status);
returnfalse;
}
}
}
package com.jam.demo.controller;
import com.jam.demo.entity.SysUser;
import com.jam.demo.service.SysUserService;
import com.jam.demo.vo.ResultVO;
import com.jam.demo.vo.UserVO;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.media.Content;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.extern.slf4j.Slf4j;
import org.springframework.util.ObjectUtils;
import org.springframework.web.bind.annotation.*;
import javax.annotation.Resource;
import java.util.List;
/**
* 系统用户控制器
* @author ken
* @date 2025-05-20
*/
@RestController
@RequestMapping("/sys/user")
@Tag(name = "系统用户管理", description = "用户查询、新增、状态更新等接口")
@Slf4j
publicclass SysUserController {
@Resource
private SysUserService sysUserService;
/**
* 根据用户名查询用户信息
* @param username 用户名
* @return ResultVO<UserVO>
*/
@GetMapping("/getByUsername")
@Operation(summary = "根据用户名查询用户", description = "查询用户基本信息及关联角色")
@ApiResponse(responseCode = "200", description = "查询成功",
content = @Content(schema = @Schema(implementation = ResultVO.class)))
public ResultVO<UserVO> getByUsername(
@Parameter(description = "用户名", required = true) @RequestParam String username) {
try {
UserVO userVO = sysUserService.getUserByUsername(username);
return ResultVO.success(userVO);
} catch (Exception e) {
log.error("根据用户名查询用户失败,用户名:{}", username, e);
return ResultVO.fail("查询失败:" + e.getMessage());
}
}
/**
* 分页查询用户列表
* @param pageNum 页码
* @param pageSize 每页条数
* @param keyword 搜索关键词
* @return ResultVO<List<SysUser>>
*/
@GetMapping("/listByPage")
@Operation(summary = "分页查询用户列表", description = "支持用户名、手机号、邮箱模糊搜索")
public ResultVO<List<SysUser>> listByPage(
@Parameter(description = "页码,默认1") @RequestParam(required = false) Integer pageNum,
@Parameter(description = "每页条数,默认10") @RequestParam(required = false) Integer pageSize,
@Parameter(description = "搜索关键词") @RequestParam(required = false) String keyword) {
try {
List<SysUser> userList = sysUserService.listUserByPage(pageNum, pageSize, keyword);
return ResultVO.success(userList);
} catch (Exception e) {
log.error("分页查询用户列表失败", e);
return ResultVO.fail("查询失败:" + e.getMessage());
}
}
/**
* 新增用户(含角色关联)
* @param sysUser 用户实体
* @param roleIds 角色ID列表
* @return ResultVO<Boolean>
*/
@PostMapping("/saveWithRole")
@Operation(summary = "新增用户", description = "新增用户并关联角色")
public ResultVO<Boolean> saveWithRole(
@Parameter(description = "用户实体", required = true) @RequestBody SysUser sysUser,
@Parameter(description = "角色ID列表", required = true) @RequestParam List<Long> roleIds) {
try {
boolean success = sysUserService.saveUserWithRole(sysUser, roleIds);
return success ? ResultVO.success(true) : ResultVO.fail("新增失败");
} catch (Exception e) {
log.error("新增用户失败", e);
return ResultVO.fail("新增失败:" + e.getMessage());
}
}
/**
* 更新用户状态
* @param id 用户ID
* @param status 状态:1-正常,0-禁用
* @return ResultVO<Boolean>
*/
@PutMapping("/updateStatus")
@Operation(summary = "更新用户状态", description = "设置用户状态为正常或禁用")
public ResultVO<Boolean> updateStatus(
@Parameter(description = "用户ID", required = true) @RequestParam Long id,
@Parameter(description = "状态:1-正常,0-禁用", required = true) @RequestParam Integer status) {
try {
boolean success = sysUserService.updateUserStatus(id, status);
return success ? ResultVO.success(true) : ResultVO.fail("更新失败");
} catch (Exception e) {
log.error("更新用户状态失败,用户ID:{},状态:{}", id, status, e);
return ResultVO.fail("更新失败:" + e.getMessage());
}
}
}
package com.jam.demo.vo;
import lombok.Data;
/**
* 统一返回结果VO
* @author ken
* @date 2025-05-20
*/
@Data
publicclass ResultVO<T> {
/**
* 状态码:200-成功,500-失败
*/
private Integer code;
/**
* 提示信息
*/
private String msg;
/**
* 数据
*/
private T data;
/**
* 成功响应(带数据)
* @param data 响应数据
* @param <T> 数据类型
* @return ResultVO<T>
*/
publicstatic <T> ResultVO<T> success(T data) {
returnnew ResultVO<>(200, "操作成功", data);
}
/**
* 成功响应(无数据)
* @param <T> 数据类型
* @return ResultVO<T>
*/
publicstatic <T> ResultVO<T> success() {
returnnew ResultVO<>(200, "操作成功", null);
}
/**
* 失败响应
* @param msg 失败提示信息
* @param <T> 数据类型
* @return ResultVO<T>
*/
publicstatic <T> ResultVO<T> fail(String msg) {
returnnew ResultVO<>(500, msg, null);
}
/**
* 构造函数
* @param code 状态码
* @param msg 提示信息
* @param data 响应数据
*/
public ResultVO(Integer code, String msg, T data) {
this.code = code;
this.msg = msg;
this.data = data;
}
}
package com.jam.demo.entity;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.time.LocalDateTime;
/**
* 用户角色关联实体类
* @author ken
* @date 2025-05-20
*/
@Data
@TableName("sys_user_role")
publicclass SysUserRole {
/**
* ID
*/
@TableId(type = IdType.AUTO)
private Long id;
/**
* 用户ID
*/
private Long userId;
/**
* 角色ID
*/
private Long roleId;
/**
* 创建时间
*/
private LocalDateTime createTime;
}
package com.jam.demo.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.jam.demo.entity.SysUserRole;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import java.util.List;
/**
* 用户角色关联Mapper
* @author ken
* @date 2025-05-20
*/
@Mapper
publicinterface SysUserRoleMapper extends BaseMapper<SysUserRole> {
/**
* 批量插入用户角色关联数据
* @param userRoleList 用户角色关联列表
* @return 插入条数
*/
int batchInsert(@Param("list") List<SysUserRole> userRoleList);
/**
* 根据用户ID删除关联数据
* @param userId 用户ID
* @return 删除条数
*/
int deleteByUserId(@Param("userId") Long userId);
}
package com.jam.demo.util;
import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONObject;
import com.google.common.collect.Maps;
import org.springframework.util.StringUtils;
import java.util.Map;
/**
* JSON工具类(基于FastJSON2)
* @author ken
* @date 2025-05-20
*/
publicclass JsonUtils {
/**
* 将对象转换为JSON字符串
* @param obj 待转换对象
* @return JSON字符串
*/
public static String toJsonString(Object obj) {
if (obj == null) {
returnnull;
}
return JSON.toJSONString(obj);
}
/**
* 将JSON字符串转换为指定类型对象
* @param jsonStr JSON字符串
* @param clazz 目标类型
* @param <T> 泛型类型
* @return 指定类型对象
*/
publicstatic <T> T parseObject(String jsonStr, Class<T> clazz) {
if (!StringUtils.hasText(jsonStr)) {
returnnull;
}
return JSON.parseObject(jsonStr, clazz);
}
/**
* 将JSON字符串转换为Map
* @param jsonStr JSON字符串
* @return Map对象
*/
public static Map<String, Object> parseMap(String jsonStr) {
if (!StringUtils.hasText(jsonStr)) {
return Maps.newHashMap();
}
return JSONObject.parseObject(jsonStr).toJavaObject(Map.class);
}
}
package com.jam.demo;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
/**
* 用户服务启动类
* @author ken
* @date 2025-05-20
*/
@SpringBootApplication
@EnableDiscoveryClient// 启用服务注册发现
@MapperScan("com.jam.demo.mapper") // 扫描Mapper接口
publicclass UserServiceApplication {
public static void main(String[] args) {
SpringApplication.run(UserServiceApplication.class, args);
}
}
<?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.jam.demo.mapper.SysUserRoleMapper">
<!-- 批量插入用户角色关联数据 -->
<insert id="batchInsert">
INSERT INTO sys_user_role (user_id, role_id, create_time)
VALUES
<foreach collection="list" item="item" separator=",">
(#{item.userId}, #{item.roleId}, NOW())
</foreach>
</insert>
<!-- 根据用户ID删除关联数据 -->
<delete id="deleteByUserId">
DELETE FROM sys_user_role WHERE user_id = #{userId}
</delete>
</mapper>
package com.jam.demo;
import com.jam.demo.entity.SysUser;
import com.jam.demo.service.SysUserService;
import com.jam.demo.vo.UserVO;
import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.util.Assert;
import java.util.List;
/**
* 用户服务测试类
* @author ken
* @date 2025-05-20
*/
@SpringBootTest
@Slf4j
publicclass SysUserServiceTest {
@Autowired
private SysUserService sysUserService;
/**
* 测试根据用户名查询用户
*/
@Test
public void testGetUserByUsername() {
String username = "admin";
UserVO userVO = sysUserService.getUserByUsername(username);
log.info("查询结果:{}", userVO);
// 断言用户存在且角色正确
Assert.notNull(userVO, "用户不存在");
Assert.isTrue(userVO.getRoleCodes().contains("SUPER_ADMIN"), "角色编码不正确");
}
/**
* 测试分页查询用户列表
*/
@Test
public void testListUserByPage() {
List<SysUser> userList = sysUserService.listUserByPage(1, 10, "test");
log.info("分页查询结果:{}", userList.size());
Assert.notEmpty(userList, "查询结果为空");
}
/**
* 测试新增用户(含角色关联)
*/
@Test
public void testSaveUserWithRole() {
SysUser sysUser = new SysUser();
sysUser.setUsername("jam_test");
sysUser.setPassword("123456");
sysUser.setRealName("测试用户2");
sysUser.setPhone("13800138002");
sysUser.setEmail("jam_test@jam.com");
sysUser.setStatus(1);
// 关联普通用户角色(角色ID=2)
List<Long> roleIds = List.of(2L);
boolean success = sysUserService.saveUserWithRole(sysUser, roleIds);
log.info("新增用户结果:{}", success);
Assert.isTrue(success, "新增用户失败");
}
/**
* 测试更新用户状态
*/
@Test
public void testUpdateUserStatus() {
Long userId = 3L; // 对应上面新增的jam_test用户ID
Integer status = 0; // 禁用
boolean success = sysUserService.updateUserStatus(userId, status);
log.info("更新用户状态结果:{}", success);
Assert.isTrue(success, "更新用户状态失败");
}
}
基于云原生数据库的企业信息系统架构落地,需重点关注以下核心问题,避免架构设计与实际落地脱节:
基于云原生数据库的企业信息系统架构设计,核心是“以业务为中心,充分利用云原生数据库的弹性、高可用、自动化特性”,而非简单的技术堆砌。本文从核心认知、架构原则、组件选型、分层设计、实例落地到避坑指南,系统拆解了架构设计的全流程:
对于企业而言,云原生数据库不仅是技术升级,更是架构思维的转变——从“资源预留”转向“按需分配”,从“人工运维”转向“自动化运维”,最终实现企业信息系统的高性能、高可用、低成本运行,支撑业务的持续快速发展。