# GNU Java Utils Library 一个轻量级 Java 工具库，提供压缩/解压、终端彩色输出、随机数生成、硬件标识等功能。 *注：此项目/仓库已同步到Github：（https://github.com/databasemysql233-debug/gnu_java_utils_library.git）* *原项目/仓库链接：（https://git.opensource-studio.info/database-mysql/gnu_java_utils_library.git）* ## 技术栈 - **Java 25** - **Maven** 构建 - **Apache Commons Compress 1.28.0**（压缩功能依赖） ## 项目结构 ``` src/main/java/top/gtb520/java/gnu/java/utils/library/ ├── main.java # 统一入口接口 └── utils/ ├── compress/ │ └── compress.java # 压缩/解压工具类 ├── print/ │ ├── echo.java # 终端彩色输出工具类 │ └── ColorNameEnum.java # 颜色名称枚举 └── processing/ ├── random/ │ └── defaults.java # 随机数/字符串生成器 └── hwid/ └── getHWID.java # 硬件标识生成器 ``` ## 功能模块 ### 1. 压缩/解压 (`compress`) 支持 **Tar.Gz** 和 **Zip** 两种格式的压缩与解压，支持单文件和目录递归处理。 | 方法 | 说明 | 参数 | |------------------------------------|--------------------------|-------------------------------------| | `compress.MakeTarGz(source, dest)` | 将文件或目录压缩为 `.tar.gz` | `source` 源路径，`dest` 压缩包输出路径 | | `compress.UnTarGz(source, dest)` | 解压 `.tar.gz` 到指定目录 | `source` 压缩包路径，`dest` 解压目标目录 | | `compress.MakeZip(source, dest)` | 将文件或目录压缩为 `.zip` | `source` 源路径，`dest` 压缩包输出路径 | | `compress.UnZip(source, dest)` | 解压 `.zip` 到指定目录 | `source` 压缩包路径，`dest` 解压目标目录 | **使用示例：** ```java import top.gtb520.java.gnu.java.utils.library.utils.compress.compress; // 压缩目录为 Tar.Gz compress.MakeTarGz("/path/to/source", "/path/to/output.tar.gz"); // 解压 Tar.Gz compress.UnTarGz("/path/to/output.tar.gz", "/path/to/dest"); // 压缩文件为 Zip compress.MakeZip("/path/to/file.txt", "/path/to/output.zip"); // 解压 Zip compress.UnZip("/path/to/output.zip", "/path/to/dest"); ``` 也可以通过统一入口 `main` 接口调用： ```java import top.gtb520.java.gnu.java.utils.library.main; main.compress.UnTarGz(source, dest); main.compress.TarGz(source, dest); ``` ### 2. 终端彩色输出 (`echo`) 基于 ANSI 转义序列，在终端中输出彩色文本。提供三种打印方式： #### 2.1 预定义颜色打印 — `ColorPrintln` 使用颜色枚举快速输出。 | 方法 | 说明 | 参数 | |-------------------------------------|-------------|--------------------------------| | `echo.ColorPrintln(message, color)` | 使用预定义颜色打印 | `message` 文本，`color` 颜色枚举 | **支持的颜色枚举 (`ColorNameEnum`)：** | 枚举值 | 颜色 | |----------|----| | `RED` | 红色 | | `GREEN` | 绿色 | | `YELLOW` | 黄色 | | `BLUE` | 蓝色 | | `PURPLE` | 紫色 | | `CYAN` | 青色 | ```java import top.gtb520.java.gnu.java.utils.library.utils.print.echo; import top.gtb520.java.gnu.java.utils.library.utils.print.ColorNameEnum; echo.ColorPrintln("错误信息", ColorNameEnum.RED); echo.ColorPrintln("成功信息", ColorNameEnum.GREEN); ``` #### 2.2 自定义颜色打印 — `ColorHexPrintln` 支持 `#RRGGBB`、`#RGB` 十六进制颜色及 ANSI 颜色代码。 | 方法 | 说明 | 参数 | |-------------------------------------------|------------------|-------------------------------------| | `echo.ColorHexPrintln(message, hexColor)` | 使用自定义颜色码打印 | `message` 文本，`hexColor` 颜色代码 | **支持的颜色格式：** | 格式 | 示例 | 说明 | |-------------|-------------|------------------------| | `#RRGGBB` | `#FFC0CB` | 十六进制真彩色，自动转 ANSI 序列 | | `#RGB` | `#F0F` | 十六进制简写，自动扩展后转 ANSI 序列 | | ANSI 颜色码 | `31` | 标准 ANSI 颜色（如 31=红色） | | ANSI 扩展色 | `38;5;208` | 256 色扩展（如 208=橙色） | ```java // 十六进制颜色 echo.ColorHexPrintln("粉色文本", "#FFC0CB"); echo.ColorHexPrintln("简写青色", "#0FF"); // ANSI 颜色码 echo.ColorHexPrintln("红色文本", "31"); echo.ColorHexPrintln("扩展橙色", "38;5;208"); ``` #### 2.3 Minecraft 风格多色打印 — `ColorPrintlnPlus` 在单行内使用 `&X` 格式码打印多种颜色和文本效果，仿照 Minecraft 格式化语法。 | 方法 | 说明 | 参数 | |------------------------------------|-----------------------|-----------------------------| | `echo.ColorPrintlnPlus(message)` | 解析 `&X` 格式码后打印多色文本 | `message` 含格式码的文本 | **颜色代码：** | 代码 | 颜色 | 代码 | 颜色 | |------|--------|------|--------| | `&0` | 黑色 | `&8` | 深灰色 | | `&1` | 深蓝色 | `&9` | 浅蓝色 | | `&2` | 深绿色 | `&a` | 浅绿色 | | `&3` | 深青色 | `&b` | 浅青色 | | `&4` | 深红色 | `&c` | 浅红色 | | `&5` | 深紫色 | `&d` | 粉色 | | `&6` | 橙色 | `&e` | 黄色 | | `&7` | 灰色 | `&f` | 白色 | **格式代码：** | 代码 | 效果 | 代码 | 效果 | |------|------|------|------| | `&l` | 加粗 | `&k` | 乱码（随机字符替换） | | `&m` | 删除线 | `&r` | 重置 | | `&n` | 下划线 | | | | `&o` | 斜体 | | | > 格式码大小写不敏感，`&A` 与 `&a` 等效。非合法格式码（如 `&z`）将原样保留。 ```java import top.gtb520.java.gnu.java.utils.library.utils.print.echo; // 多色文本 echo.ColorPrintlnPlus("&6Welcome &2to &4Project"); // 混合格式效果 echo.ColorPrintlnPlus("&4&l粗体红色 &n&9下划线蓝色"); // 乱码效果（每次调用生成不同随机字符） echo.ColorPrintlnPlus("&k这是一段乱码文字"); // 重置后恢复普通文本 echo.ColorPrintlnPlus("&4红色文字 &r普通文字"); ``` 也可以通过统一入口 `main` 接口调用： ```java import top.gtb520.java.gnu.java.utils.library.main; main.echo.Println("警告信息", ColorNameEnum.YELLOW); main.echo.ColorHexPrintln("自定义颜色", "#FF0000"); main.echo.ColorPrintlnPlus("&a多色 &c文本"); ``` ### 3. 随机生成器 (`random`) | 方法 | 说明 | 参数 | |---------------------------------------------|--------------|------------------------------| | `defaults.random(start_scope, end_scope)` | 生成指定范围内的随机数 | `start_scope` 起始，`end_scope` 结束 | | `defaults.randomString(length)` | 生成指定长度的随机字符串 | `length` 字符串长度 | ```java import top.gtb520.java.gnu.java.utils.library.utils.processing.random.defaults; int num = defaults.random(1, 100); // 生成 1~100 的随机整数 String str = defaults.randomString(16); // 生成 16 位随机字符串（大小写字母+数字） ``` ### 4. 硬件标识生成器 (`hwid`) 组合 CPU、主板、MAC 地址、硬盘序列号等信息，通过 SHA-256 生成唯一的硬件标识符（HWID）。支持 Windows、macOS、Linux 及 Android 平台。 | 方法 | 说明 | 参数 | |------------------------|----------|----| | `getHWID.generateHWID()` | 生成硬件标识符 | 无 | ```java import top.gtb520.java.gnu.java.utils.library.utils.processing.hwid.getHWID; String hwid = getHWID.generateHWID(); System.out.println("HWID: " + hwid); ``` ## 构建 ```bash mvn compile ``` 或打包为 JAR： ```bash mvn package ``` ## 使用 编译成功后，将 `target/gnu-java-utils-library-1.2-SNAPSHOT.jar` 放入项目依赖中，或在 Releases 中下载最新版 JAR 包。 **pom.xml 引入本地依赖：** ```xml top.gtb520.java.gnu gnu_java_utils_library 1.2-SNAPSHOT system ${project.basedir}/lib/gnu_java_utils_library-1.2-SNAPSHOT.jar ``` ## 异常处理 压缩/解压方法在以下情况会抛出 `IllegalArgumentException`： - **压缩时**：源路径不存在 - **解压时**：目标路径不是有效的目录 随机数方法在以下情况会抛出 `IllegalArgumentException`： - **起始值大于结束值时** ## 许可证 Apache License 2.0 禁止商业用途