# java-common

**Repository Path**: devleon/java-common

## Basic Information

- **Project Name**: java-common
- **Description**: 一个集中式的Java工具类库，提供常用的工具方法封装，避免项目重复编写相同逻辑。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-11
- **Last Updated**: 2025-09-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java

## README

# java-common 工具库

一个集中式的Java工具类库，提供常用的工具方法封装，避免项目重复编写相同逻辑。

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Maven Central](https://img.shields.io/maven-central/v/io.gitee.devleon/java-common.svg)](https://search.maven.org/artifact/io.gitee.devleon/java-common)

## 特性

- 📦 **开箱即用**：提供丰富的工具方法，涵盖日常开发所需
- 🚀 **高性能**：优化的算法实现，提升执行效率
- 🛡️ **线程安全**：关键方法都经过线程安全处理，可安全用于并发环境
- 📚 **文档完善**：详细的注释和使用示例，易于理解和使用
- 🔧 **功能全面**：包含字符串处理、HTTP请求、加密解密、配置管理等常用功能

## 功能模块

### 1. 工具类 (Utils)
- `StringUtils`：字符串处理工具类，提供字符串截取、连接、去空格等常用操作
- `HttpUtil`：基于OkHttp的HTTP请求工具类，支持GET、POST、PUT、DELETE等请求方式
- `AESUtil`/`SM4Util`：加密解密工具类，支持AES和国密SM4算法
- `DateUtils`：日期时间处理工具类
- `SpringUtil`：Spring容器工具类，方便获取Bean实例和环境变量
- `MapUtil`：Map集合操作工具类
- `AssertUtils`：断言工具类，用于参数校验

### 2. 配置管理 (Config)
- `ConfigManager`：统一配置管理器，支持从application.yml文件和运行时动态配置
- `NorConfigManager`：标准配置管理器实现

### 3. Web组件 (Web)
- `ApiResponse`：统一API响应格式封装类，规范接口返回数据结构
- `GlobalExceptionHandler`：全局异常处理器，统一处理应用异常
- `FtdCoreException`：核心异常类，配合全局异常处理器使用

### 4. 其他组件
- `DingTalkRobot`：钉钉群聊机器人，支持发送消息到钉钉群

## 安装

在Maven项目中添加依赖：

```xml
<dependency>
    <groupId>io.gitee.devleon</groupId>
    <artifactId>java-common</artifactId>
    <version>1.0.0</version>
</dependency>
```

或者在Gradle项目中添加依赖：

```gradle
implementation 'io.gitee.devleon:java-common:1.0.0'
```

## 使用示例

### 字符串处理
```java
import io.gitee.devleon.common.utils.StringUtils;

// 判断字符串是否为空
boolean isEmpty = StringUtils.isNullOrEmpty("test");

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

// 字符串连接
String[] arr = {"a", "b", "c"};
String joined = StringUtils.join(",", arr); // "a,b,c"
```

### HTTP请求
```java
import io.gitee.devleon.common.utils.HttpUtil;

// 发送GET请求
String response = HttpUtil.sendGet("https://api.example.com/data");

// 发送POST请求
String postData = "{\"name\":\"test\"}";
String postResponse = HttpUtil.sendPost("https://api.example.com/data", postData);
```

### 加密解密
```java
import io.gitee.devleon.common.utils.AESUtil;

// AES加密
String key = "1234567890123456";
String data = "Hello World";
byte[] encrypted = AESUtil.encrypt(data.getBytes(), key, null);

// AES解密
byte[] decrypted = AESUtil.decrypt(encrypted, key, null);
String result = new String(decrypted);
```

### 统一API响应
```java
import io.gitee.devleon.common.web.ApiResponse;

// 创建成功响应
ApiResponse<String> successResponse = ApiResponse.success("操作成功");

// 创建错误响应
ApiResponse<String> errorResponse = ApiResponse.error("操作失败");
```

### 配置管理
```java
import io.gitee.devleon.common.config.ConfigManager;

// 获取配置值
String value = ConfigManager.getValue("app.name");

// 获取带默认值的配置
String defaultValue = ConfigManager.getValue("app.name", "defaultName");

// 获取整型配置
int port = ConfigManager.getValueAsInt("server.port", 8080);
```

## 环境要求

- Java 8 或更高版本
- Spring Framework 5.3.x 或 Spring Boot 2.6.x
- Maven 3.6.x 或 Gradle 6.x

## 构建项目

```bash
# 克隆项目
git clone https://gitee.com/devleon/java-common.git

# 进入项目目录
cd java-common

# Maven构建
mvn clean install

# 或者使用Gradle构建
./gradlew build
```

## 发布说明

查看 [CHANGELOG.md](CHANGELOG.md) 了解最新版本的更新内容。

## 贡献

欢迎提交Issue和Pull Request来改进这个项目。

1. Fork 本仓库
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启一个Pull Request

## 许可证

本项目基于MIT许可证开源，详情请查看[MIT License](LICENSE)文件。

## 联系方式

- 项目地址: [https://gitee.com/devleon/java-common](https://gitee.com/devleon/java-common)
- 开发者邮箱: mrbmyc@163.com