|
|
# 一键全部清空功能 - 超简化版本
|
|
|
|
|
|
## 🎯 设计理念
|
|
|
|
|
|
**后端只有一个通用接口**，通过业务模块标识匹配表名，前端配置极简。
|
|
|
|
|
|
## 🔧 后端架构（已完成）
|
|
|
|
|
|
### 核心组件
|
|
|
- ✅ `CommonClearController` - 通用清空控制器
|
|
|
- ✅ `CommonClearService` - 通用清空服务
|
|
|
- ✅ `CommonClearMapper` - 通用清空数据访问层
|
|
|
|
|
|
### 安全措施
|
|
|
1. **白名单机制** - 只允许清空预定义的表
|
|
|
2. **表名验证** - 正则校验，防止SQL注入
|
|
|
3. **权限检查** - 动态权限验证
|
|
|
4. **SQL关键字过滤** - 防止恶意攻击
|
|
|
5. **长度限制** - 表名长度控制
|
|
|
6. **操作日志** - 完整的审计日志
|
|
|
|
|
|
## 🚀 前端快速集成（3步完成）
|
|
|
|
|
|
### 步骤1：添加按钮（导入按钮后）
|
|
|
```vue
|
|
|
<el-col :span="1.5">
|
|
|
<el-button
|
|
|
type="danger"
|
|
|
plain
|
|
|
icon="el-icon-delete"
|
|
|
size="mini"
|
|
|
@click="handleClearAll"
|
|
|
v-hasPermi="['你的权限:remove']"
|
|
|
>一键全部清空</el-button>
|
|
|
</el-col>
|
|
|
```
|
|
|
|
|
|
### 步骤2：导入mixin
|
|
|
```javascript
|
|
|
import clearAllMixin from "@/mixins/clearAllMixin";
|
|
|
|
|
|
export default {
|
|
|
name: "YourComponent",
|
|
|
mixins: [clearAllMixin],
|
|
|
// ... 其他代码
|
|
|
}
|
|
|
```
|
|
|
|
|
|
### 步骤3：配置模块信息（created钩子中）
|
|
|
```javascript
|
|
|
created() {
|
|
|
// 其他代码...
|
|
|
|
|
|
// 配置清空功能（仅需3个参数）
|
|
|
this.clearAllConfig = {
|
|
|
moduleKey: '模块标识', // 见下方支持的模块列表
|
|
|
entityName: '显示名称', // 如：'日常故障记录'
|
|
|
permission: '权限标识' // 如：'ems/info:dailyFaultRecord:remove'
|
|
|
};
|
|
|
}
|
|
|
```
|
|
|
|
|
|
## 📋 支持的模块列表（后端已配置）
|
|
|
|
|
|
| 模块标识 | 实体名称 | 权限标识 |
|
|
|
|---------|---------|---------|
|
|
|
| `dailyFaultRecord` | 日常故障记录 | `ems/info:dailyFaultRecord:remove` |
|
|
|
| `faultHandlingRecord` | 故障处置记录 | `ems/info:faultHandlingRecord:remove` |
|
|
|
| `plcBufferBatteryLifecycle` | PLC缓冲电池生命周期 | `ems/info:plcBufferBatteryLifecycle:remove` |
|
|
|
| `securityDoorBatteryLifecycle` | 安全门电池生命周期 | `ems/info:securityDoorBatteryLifecycle:remove` |
|
|
|
| `upsBatteryLifecycle` | UPS电池生命周期 | `ems/info:upsBatteryLifecycle:remove` |
|
|
|
| `sparePartsInventory` | 备件库记录 | `ems/info:sparePartsInventory:remove` |
|
|
|
| `sparePartsUsageRecord` | 备件领用记录 | `ems/info:sparePartsUsageRecord:remove` |
|
|
|
| `sparePartsRegistration` | 废旧备件登记 | `ems/info:sparePartsRegistration:remove` |
|
|
|
| `supervisionChecklist` | 监督检查清单 | `ems/info:supervisionChecklist:remove` |
|
|
|
| `sparePartsInventoryCheck` | 备件盘点记录 | `ems/info:sparePartsInventoryCheck:remove` |
|
|
|
|
|
|
## 💡 实际应用示例
|
|
|
|
|
|
### 日常故障记录页面（已完成）
|
|
|
```vue
|
|
|
<!-- 1. 添加按钮 -->
|
|
|
<el-col :span="1.5">
|
|
|
<el-button type="danger" plain icon="el-icon-delete"
|
|
|
size="mini" @click="handleClearAll"
|
|
|
v-hasPermi="['ems/info:dailyFaultRecord:remove']">
|
|
|
一键全部清空
|
|
|
</el-button>
|
|
|
</el-col>
|
|
|
|
|
|
<script>
|
|
|
// 2. 导入mixin
|
|
|
import clearAllMixin from "@/mixins/clearAllMixin";
|
|
|
|
|
|
export default {
|
|
|
mixins: [clearAllMixin],
|
|
|
created() {
|
|
|
// 3. 配置模块
|
|
|
this.clearAllConfig = {
|
|
|
moduleKey: 'dailyFaultRecord',
|
|
|
entityName: '日常故障记录',
|
|
|
permission: 'ems/info:dailyFaultRecord:remove'
|
|
|
};
|
|
|
}
|
|
|
}
|
|
|
</script>
|
|
|
```
|
|
|
|
|
|
### 故障处置记录页面（示例）
|
|
|
```javascript
|
|
|
// 只需要修改配置
|
|
|
this.clearAllConfig = {
|
|
|
moduleKey: 'faultHandlingRecord',
|
|
|
entityName: '故障处置记录',
|
|
|
permission: 'ems/info:faultHandlingRecord:remove'
|
|
|
};
|
|
|
```
|
|
|
|
|
|
## ⚡ 添加新模块支持
|
|
|
|
|
|
如需要支持新模块，只需要在后端 `CommonClearController` 的白名单中添加：
|
|
|
|
|
|
```java
|
|
|
put("新模块标识", new TableInfo("数据库表名", "显示名称", "权限标识"));
|
|
|
```
|
|
|
|
|
|
## 🛡️ 安全特性
|
|
|
|
|
|
1. **三次确认机制** - 确保用户真的要执行操作
|
|
|
2. **白名单限制** - 只能清空预定义的表
|
|
|
3. **权限验证** - 检查用户权限
|
|
|
4. **SQL安全** - 防止注入攻击
|
|
|
5. **操作审计** - 记录所有操作日志
|
|
|
|
|
|
## 📈 开发效率对比
|
|
|
|
|
|
| 方案 | 后端代码量 | 前端集成步骤 | 新增模块成本 |
|
|
|
|-----|-----------|-------------|-------------|
|
|
|
| 原方案 | 每模块5个文件 | 8步 | 高 |
|
|
|
| **新方案** | **1个通用接口** | **3步** | **极低** |
|
|
|
|
|
|
## 🎉 总结
|
|
|
|
|
|
- **后端**：一次开发，永久使用
|
|
|
- **前端**：复制粘贴，秒级集成
|
|
|
- **维护**：集中管理，安全可控
|
|
|
- **扩展**：新增模块只需添加一行配置
|
|
|
|
|
|
现在为任何页面添加清空功能，只需要3步，2分钟搞定！ |