工具概览
Vben Admin 提供了丰富的工具类,分为前端工具和后端工具。
前端工具类(20 个)
数据处理
| 工具类 | 说明 | 链接 |
|---|---|---|
| ExportUtils | Excel/CSV/JSON 导出 | 查看 |
| FormatUtils | 文件大小/数字/日期格式化 | 查看 |
| TreeUtils | 树形数据处理 | 查看 |
| ArrayUtils | 数组操作 | 查看 |
| ObjectUtils | 对象操作 | 查看 |
安全加密
| 工具类 | 说明 | 链接 |
|---|---|---|
| EncryptUtils | MD5/AES/SHA256/Base64 | 查看 |
| DesensitizeUtils | 数据脱敏 | 查看 |
| ValidationUtils | 数据验证 | 查看 |
用户交互
| 工具类 | 说明 | 链接 |
|---|---|---|
| ClipboardUtils | 剪贴板操作 | 查看 |
| FullscreenUtils | 全屏控制 | 查看 |
| PrintUtils | 打印功能 | 查看 |
| DownloadUtils | 文件下载 | 查看 |
页面增强
| 工具类 | 说明 | 链接 |
|---|---|---|
| WatermarkUtils | 水印功能 | 查看 |
| QRCodeUtils | 二维码生成 | 查看 |
| DomUtils | DOM 操作 | 查看 |
存储和工具
| 工具类 | 说明 | 链接 |
|---|---|---|
| StorageUtils | localStorage/sessionStorage | 查看 |
| UrlUtils | URL 参数处理 | 查看 |
| DeviceUtils | 设备检测 | 查看 |
| ColorUtils | 颜色处理 | 查看 |
| FunctionUtils | 防抖/节流 | 查看 |
后端工具类(12 个)
文件处理
| 工具类 | 说明 | 链接 |
|---|---|---|
| ExcelUtils | Excel 导入导出 | 查看 |
| FileDownloadUtils | 文件下载 | 查看 |
数据安全
| 工具类 | 说明 | 链接 |
|---|---|---|
| DesensitizeUtils | 数据脱敏 | 查看 |
| ValidationUtils | 数据验证 | 查看 |
缓存和锁
| 工具类 | 说明 | 链接 |
|---|---|---|
| CacheUtils | Redis 缓存 | 查看 |
| LockUtils | 分布式锁 | 查看 |
通用工具
| 工具类 | 说明 | 链接 |
|---|---|---|
| IpUtils | IP 处理 | 查看 |
| JsonUtils | JSON 处理 | 查看 |
| DateUtils | 日期处理 | 查看 |
| StringUtils | 字符串处理 | 查看 |
| CollectionUtils | 集合处理 | 查看 |
| BeanUtils | Bean 处理 | 查看 |
快速使用
前端工具
typescript
import {
ExportUtils,
ClipboardUtils,
EncryptUtils
} from '@vben/utils'
// 导出 Excel
ExportUtils.exportExcel(data, '用户列表')
// 复制到剪贴板
await ClipboardUtils.copy('文本内容')
// MD5 加密
const hash = EncryptUtils.md5('password')后端工具
java
import com.vben.common.utils.*;
// 导出 Excel
ExcelUtils.exportExcel(users, User.class, "用户列表", response);
// 数据脱敏
String phone = DesensitizeUtils.desensitize("13812341234", DesensitizeType.PHONE);
// 分布式锁
LockUtils.executeWithLock("order:" + userId, () -> {
orderService.createOrder(order);
});工具分类
按功能分类
数据处理
- ExportUtils(前端/后端)
- FormatUtils(前端)
- TreeUtils(前端)
- ArrayUtils(前端)
- ObjectUtils(前端)
- JsonUtils(后端)
- DateUtils(后端)
- StringUtils(后端)
- CollectionUtils(后端)
- BeanUtils(后端)
安全加密
- EncryptUtils(前端)
- DesensitizeUtils(前端/后端)
- ValidationUtils(前端/后端)
文件操作
- ExcelUtils(后端)
- FileDownloadUtils(后端)
- DownloadUtils(前端)
- PrintUtils(前端)
用户交互
- ClipboardUtils(前端)
- FullscreenUtils(前端)
- WatermarkUtils(前端)
- QRCodeUtils(前端)
系统工具
- CacheUtils(后端)
- LockUtils(后端)
- StorageUtils(前端)
- IpUtils(后端)
- UrlUtils(前端)
- DeviceUtils(前端)
- DomUtils(前端)
- ColorUtils(前端)
- FunctionUtils(前端)
使用建议
最佳实践
- 优先使用框架提供的工具类
- 避免重复造轮子
- 注意工具类的适用场景
- 合理处理异常情况
- 关注性能影响
注意事项
- 部分工具类需要特定环境支持
- 注意浏览器兼容性
- 大数据量操作要注意性能
- 敏感数据要做好安全防护