# buk-common

**Repository Path**: bukcn/buk-common

## Basic Information

- **Project Name**: buk-common
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-13
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: buk-cn

## README

# buk-common

BUK 内部通用 Java 工具库，提供基础 DTO、工具类、Redis 封装、机票业务逻辑等公共能力。

## 项目信息

- **GroupId**: `cn.buk.common`
- **ArtifactId**: `buk-common`（父 POM）
- **版本**: `2.9.0`
- **Java**: 21
- **许可证**: GPL v3.0

## 模块

### common-util (`buk-common-util`)

核心工具模块，包含以下功能包：

| 包 | 说明 |
|---|---|
| `cn.buk.common.dto` | 通用 DTO（Eterm 航信接口、机票统计、TMC 订单状态等） |
| `cn.buk.common.dto.eterm` | 航信 Eterm 相关 DTO（PNR、AV、FD、FF、TPR 等） |
| `cn.buk.common.flight` | 航班信息相关 DTO |
| `cn.buk.common.redis` | Redis 工具类与 DAO 封装 |
| `cn.buk.common.sc` | 通用查询条件与分页 |
| `cn.buk.common.tms` | TMS 业务相关（航班接口、异常定义、订单请求等） |
| `cn.buk.common.util` | 工具类（HTTP 客户端、日期、金额、JSON、加密、验证码等） |

## 技术栈

| 依赖 | 版本 | 用途 |
|---|---|---|
| Jackson | 2.18.7 | JSON/XML 序列化 |
| Apache HttpClient5 | 5.6.1 | HTTP 客户端 |
| Jedis | 5.2.0 | Redis 客户端 |
| Commons Lang3 | 3.20.0 | 工具类增强 |
| Commons Pool2 | 2.13.1 | 对象池 |
| Dom4j | 2.1.4 | XML 解析 |
| Logback | 1.5.34 | 日志框架 |
| SLF4J | 2.0.18 | 日志门面 |
| Jakarta Validation API | 3.1.1 | 参数校验 |
| JUnit Jupiter | 5.14.4 | 单元测试 |
| JaCoCo | 0.8.15 | 测试覆盖率 |

## 快速开始

### 引入依赖

```xml
<dependency>
    <groupId>cn.buk.common</groupId>
    <artifactId>buk-common-util</artifactId>
    <version>2.9.0</version>
</dependency>
```

### 构建

```bash
mvn clean install -DskipTests
```

### 运行测试

```bash
mvn test
```

## 发布

### Release 发布

```bash
mvn release:perform -DuseReleaseProfile=src
```

### 手动部署到仓库

```bash
mvn clean deploy -DskipTests -P release
```

## 版本历史

- **2.9.0** - 最新版本
- **2.0.0** - 架构升级，不兼容 1.x 系列，移除废弃类