# wys-base

**Repository Path**: linxiaozhun_admin/wys-base

## Basic Information

- **Project Name**: wys-base
- **Description**: 基于spring框架整合各中间件的集成包
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2022-09-20
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一个基于springBoot的中间件集成包支持springCloudAlibaba、nacos2.0及以下版本、xxlJob、mqtt、knife4j、druid动态多数据源、shardingJdbc4.1.1、docker镜像部署.........
## 使用要求
### jdk: 1.8
### maven: 3.x及以上
### 当前最新版本
<img src="img/img.png" alt="">

## maven包引用方式
### 1、parent标签内使用如下包
<img src="img/img_3.png" alt="">

### 2、包名目录介绍
#### 2.1、api-base 用于springMVC工程的数据访问层与common-base配套使用(必用)
<img src="img/img_4.png" alt="">

#### 2.2、common-base wys-base工程的核心包(必用)
<img src="img/img_5.png" alt="">

#### 2.1、api-base
提供基础API组件，包含通用响应、异常处理和工具类
- **common**
  - `BaseErrorCode`: 定义系统错误码枚举，包含400/401/500等标准状态码及自定义业务码
  - `BaseModel`: MyBatis-Plus基础模型类，提供通用字段(创建时间/更新时间/删除状态)和AR模式支持
  - `CommonCode`: HTTP状态码和数据删除状态常量定义
  - `R`: 统一API响应封装类，支持成功/失败响应、数据包装和消息提示
- **constant**: 系统常量定义，包含缓存键、安全配置和令牌相关常量
- **exception**
  - `BizException`: 业务异常类，支持错误码和消息传递
  - `GlobalException`: 全局异常基类
- **swagger**: `Knife4jConfiguration` Swagger/OpenAPI文档配置类
- **utils**
  - `DateTimeUtils`: 日期时间格式化与转换工具，支持LocalDateTime与Date互转
  - `ModelUtils`: 模型转换工具类

#### 2.2、common-base
核心功能模块，包含Spring配置、缓存策略、数据源管理和第三方集成
- **spring/cache**
  - `CacheStrategy`: 缓存策略接口，定义缓存存取、清除等操作
  - `RedisCacheStrategy`: Redis缓存实现
  - `MysqlCacheStrategy`: 数据库缓存实现
- **spring/db**
  - `@DataSource`: 数据源切换注解
  - `DynamicDataSource`: 动态数据源路由实现
  - `MultipleDataSource`: 多数据源配置
- **pay/alipay**
  - `AlipayCore`: 支付宝支付核心类，支持H5支付、应用授权等功能
- **sms/aliyun**
  - `AliYunSmsUtil`: 阿里云短信发送工具类
- **utils**
  - `CharsetKit`: 字符集处理工具
  - `ServletUtils`: Web请求响应工具类
  - `StringUtils`: 字符串操作工具类

#### 2.3、utils-base wys-base工程里的工具包里面多为一些加密工具类(选用)
- **password**
  - `DESUtil`: 3DES加密解密工具，支持MD5/SHA256摘要算法
  - `RSAUtils`: RSA非对称加密工具，提供公钥加密、私钥解密功能
- **uuid**
  - `IdUtils`: UUID生成工具，支持标准UUID和简化版UUID
  - `SnowIdUtils`: 雪花算法ID生成器，提供分布式唯一ID
<img src="img/img_6.png" alt="">


## 使用方式
### springCloud模式
<img src="img/img_1.png" alt="">

### springBoot模式
#### 排除以下包即可,其他操作同springCloud模式一样
<img src="img/img_2.png" alt="">

### 多数据源配置说明
<img src="img/img_7.png" alt="">