脚手架介绍

应用技术架构

功能特性

• 应用网关 spring cloud gateway： 作为访问后端应用的入口，所有请求要经过网关进行访问的鉴权和请求的转发；
• 主体框架：采用最新的Spring Cloud 2023.0.1 , Spring Boot 3.2.2, Spring Cloud Alibaba 2023.0.1.3 版本进行系统设计；
• 统一注册：支持Nacos作为注册中心，实现多配置、分群组、分命名空间、多业务模块的注册和发现功能；
• 业务熔断：采用Sentinel实现业务熔断处理，避免服务之间出现雪崩；
• 身份注入：通过内置类 TronSecurityHelper.currentUser() 的方式，实现快速获取用户登录信息；
• 代码生成：基于groovy模板自动生成代码，提升开发效率；
• 链路追踪：每个请求生成traceId，实现简单的链路追踪功能，日志的链路跟踪打印；
• 多租户功能：集成Mybatis Plus,实现SAAS多租户功能；
• redis： 常用功能封装；
• 多数据源支持；

框架结构介绍

├── swing-framework-parent
│   ├── pom.xml                                             --主模块
│   ├── swing-framework-bean                                --封装了通用bean的
│   ├── swing-framework-bom                                 --封装了框架的版本管理
│   ├── swing-framework-cache                               --封装了缓存模块
│   ├── swing-framework-core                                --封装了核心模块        
│   ├── swing-framework-data                
│   │   ├── swing-framework-data-influxdb2                  --封装了时序库v2模块
│   │   ├── swing-framework-data-mybatis-plus               --封装了mybatis功能模块
│   ├── swing-framework-notice-spring-boot-starter          --封装了消息通知功能模块
│   ├── swing-framework-security-spring-boot-starter        --封装了服务安全功能模块
│   ├── swing-framework-trace                               --封装了日志链路追踪功能模块
│   └── swing-framework-web-spring-boot-starter             --封装了web功能模块

框架使用说明

需满足开发环境前置条件

1. maven settings.xml 配置私有仓库地址

<!--设置仓库凭证-->
<servers>
    <server>
        <id>swing</id>
        <username>************</username>
        <password>************</password>
    </server>
</servers>

<!--私有仓库配置-->
<repositories>
    <repository>
        <id>swing</id>
        <url>https://packages.aliyun.com/************</url>
    </repository>
</repositories>

2. pom.xml 添加依赖

    <parent>
        <groupId>com.wings.tiny</groupId>
        <artifactId>swing-framework-parent</artifactId>
        <version>2025.2.7</version>
    </parent>

<dependencies>
    <!-- 示例 swing-framework-web-spring-boot-starter -->
    <dependency>
        <groupId>com.wings.tiny</groupId>
        <artifactId>swing-framework-web-spring-boot-starter</artifactId>
    </dependency>
</dependencies>

3. gateway nacos 路由配置

- id: swing-demo-service
  uri: lb://SWING-DEMO-SERVICE
  predicates:
    - Path=/services/swing-demo/api/v1/**