# 基于社会服务项目工具类提取

**Repository Path**: wjpCodes/com.util

## Basic Information

- **Project Name**: 基于社会服务项目工具类提取
- **Description**: 基于若依框架的项目工具类提取，提供便捷的开发工具和组件，加速项目构建与维护。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# RGSoft Utils - 工具类库

> 从实际项目中提炼的实用工具类库，开箱即用

[![Java](https://img.shields.io/badge/Java-1.8-blue.svg)](https://openjdk.java.net/)
[![Maven](https://img.shields.io/badge/Maven-3.6+-red.svg)](https://maven.apache.org/)
[![License](https://img.shields.io/badge/License-Apache%202.0-green.svg)](https://opensource.org/licenses/Apache-2.0)

---

## 📦 快速使用

### Maven 依赖

```xml
<dependency>
    <groupId>com.rgsoft</groupId>
    <artifactId>rgsoft-utils</artifactId>
    <version>1.0.0</version>
</dependency>
```

### 核心依赖

项目需要以下依赖支持：

```xml
<!-- Apache Commons Lang3 -->
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.12.0</version>
</dependency>

<!-- SLF4J 日志 -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>1.7.36</version>
</dependency>
```

---

## 🎯 核心工具类速查

### 字符串处理

```java
// 空值判断
StringUtils.isEmpty("test");
StringUtils.isNotEmpty("test");

// 驼峰转下划线
StringUtils.toUnderScoreCase("userName"); // user_name

// 截取字符串
StringUtils.substring("Hello World", 0, 5); // Hello
```

### 日期时间

```java
// 获取当前日期
Date now = DateUtils.getNowDate();

// 日期格式化
String dateStr = DateUtils.parseDateToStr(DateUtils.YYYY_MM_DD, new Date());

// 计算年龄
int age = DateUtils.getAge(birthDay);
```

### 加密解密

```java
// MD5 加密
String md5 = Md5Utils.hash("password");

// Base64 编码
String encoded = Base64.encode("data");

// RSA 加密 (需要先加载密钥)
String encrypted = RsaUtils.encryptByPublicKey(data, publicKeyBase64);
```

### 唯一 ID

```java
// 雪花算法生成 18 位数字 ID
long id = IdUtils.nextId();
```

### 隐私脱敏

```java
// 手机号脱敏：13812345678 -> 138****5678
PrivacyUtil.maskPhone("13812345678");

// 身份证号脱敏
PrivacyUtil.maskIdCard("110101199001011234");

// 邮箱脱敏
PrivacyUtil.maskEmail("zhangsan@example.com");
```

### 类型转换

```java
// 转换为整数
Integer num = Convert.toInt("123");

// 转换为字符串
String str = Convert.toString(123);

// 转换为数组
String[] arr = Convert.toArray("a,b,c");
```

---

## 📁 完整目录结构

```
rgsoft-utils/
├── core/                    # 核心工具类
│   ├── StringUtils          # 字符串处理
│   ├── DateUtils            # 日期时间
│   ├── Convert              # 类型转换
│   ├── PrivacyUtil          # 隐私脱敏
│   ├── SecurityUtils        # 安全服务
│   ├── PatternUtils         # 正则验证
│   ├── AjaxResult           # 统一响应结果
│   ├── PageInfo             # 分页信息
│   ├── ServiceException     # 业务异常
│   └── ...
│
├── sign/                    # 加密签名
│   ├── Md5Utils             # MD5 加密
│   ├── Base64               # Base64 编解码
│   └── RsaUtils             # RSA 加密
│
├── uuid/                    # ID 生成
│   └── IdUtils              # 雪花算法
│
├── file/                    # 文件处理
│   ├── FileReaderUtil       # 文件读取
│   └── FileUploadUtils      # 文件上传
│
├── html/                    # HTML 处理
│   ├── HTMLFilter           # HTML 过滤
│   └── EscapeUtil           # HTML 转义
│
├── http/                    # HTTP 工具
│   └── HttpUtils            # HTTP 请求处理
│
├── ip/                      # IP 地址
│   ├── IpUtils              # IP 工具
│   └── AddressUtils         # 地址解析
│
├── sql/                     # SQL 工具
│   └── SqlUtil              # SQL 防注入
│
└── bean/                    # Bean 工具
    └── BeanUtils            # Bean 复制
```

---

## 🔥 高频工具类

| 工具类 | 使用场景 |
|--------|----------|
| **StringUtils** | 字符串处理，每个项目必备 |
| **DateUtils** | 日期格式化、计算 |
| **Convert** | 类型转换，数据处理 |
| **Md5Utils** | 密码加密、文件校验 |
| **IdUtils** | 订单号、流水号生成 |
| **PrivacyUtil** | 数据脱敏展示 |
| **PatternUtils** | 手机、邮箱、身份证验证 |
| **FileUploadUtils** | 文件上传处理 |
| **SecurityUtils** | 密码加密验证 |
| **AjaxResult** | 统一响应结果 |

---

## ⚠️ 使用说明

### 1. 业务类简化说明

部分工具类是简化版本，需要根据项目配置：

**SpringUtils 配置示例**:

```java
@SpringBootApplication
public class Application implements ApplicationContextAware {
    @Override
    public void setApplicationContext(ApplicationContext context) {
        SpringUtils.setApplicationContext(context);
    }
}
```

### 2. 可选依赖

如需使用 Excel 导入导出等功能，需要添加 POI 依赖：

```xml
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>4.1.2</version>
</dependency>
```

---

## 📊 统计信息

- **工具类总数**: 42+ 个
- **功能包数量**: 9 个
- **注解类型**: 7 个

---

## 🛠️ 开发环境

- **JDK**: 1.8+
- **Maven**: 3.6+
- **IDE**: IntelliJ IDEA / Eclipse

---

## 📝 许可证

Apache License 2.0

---

## 👨‍💻 维护者

基于若依框架工具类整理优化  
作者：Unstoppable VS code
更新时间：2026-03-09