架构设计

核心层设计

核心层的职责与设计原则。

核心层设计

nebula-foundation

职责:提供框架的基础工具和异常处理

核心组件

1. 异常体系

NebulaException (基础异常)
    ├─ ValidationException (验证异常)
    ├─ BusinessException (业务异常)
    ├─ SystemException (系统异常)
    └─ ThirdPartyException (第三方异常)

2. 通用工具类

  • StringUtils: 字符串工具
  • DateUtils: 日期工具
  • JsonUtils: JSON 工具
  • IdGenerator: ID 生成器

3. 结果封装

public class Result<T> {
    private boolean success;
    private String code;
    private String message;
    private T data;
}

nebula-security

职责:提供安全认证和权限控制

核心组件

1. JWT 认证

用户登录
    ↓
生成 JWT Token
    ↓
Token 存入 Redis (可选)
    ↓
后续请求携带 Token
    ↓
验证 Token
    ↓
获取用户信息

2. RBAC 权限控制

用户 (User)
    ↓ 拥有
角色 (Role)
    ↓ 拥有
权限 (Permission)
    ↓ 控制
资源 (Resource)

3. 权限注解

@PreAuthorize("hasRole('ADMIN')")
public void adminOperation() { }

@PreAuthorize("hasPermission('order:create')")
public Order createOrder() { }