parser发布到maven central方便开发者依赖, pom文件结构调整

This commit is contained in:
q
2025-10-16 18:08:03 +08:00
parent eb06eb9f3d
commit c16bde6bb8
9 changed files with 642 additions and 101 deletions

66
parser/README.md Normal file
View File

@@ -0,0 +1,66 @@
# parser
NFD 解析器模块:聚合各类网盘/分享页解析,统一输出文件列表与下载信息,供上层下载器使用。
- 语言Java 17
- 构建Maven
- 模块版本10.1.9
## 依赖Maven Central
- Maven无需额外仓库配置
```xml
<dependency>
<groupId>cn.qaiu</groupId>
<artifactId>parser</artifactId>
<version>10.1.9</version>
</dependency>
```
- Gradle Groovy DSL
```groovy
dependencies {
implementation 'cn.qaiu:parser:10.1.9'
}
```
- Gradle Kotlin DSL
```kotlin
dependencies {
implementation("cn.qaiu:parser:10.1.9")
}
```
## 核心 API 速览
- WebClientVertxInit注入/获取 Vert.x 实例(内部 HTTP 客户端依赖)。
- ParserCreate从分享链接或类型构建解析器生成短链 path。
- IPanTool统一解析接口parse、parseFileList、parseById
## 使用示例(极简)
```java
Vertx vx = Vertx.vertx();
WebClientVertxInit.init(vx);
IPanTool tool = ParserCreate.fromShareUrl("https://www.ilanzou.com/s/xxxx").createTool();
List<FileInfo> list = tool.parseFileList().toCompletionStage().toCompletableFuture().join();
```
完整示例与调试脚本见 parser/doc/README.md。
## 快速开始
- 环境JDK >= 17Maven >= 3.9
- 构建/安装:
```
mvn -pl parser -am clean package
mvn -pl parser -am install
```
- 测试:
```
mvn -pl parser test
```
## 文档
开发者请阅读 parser/doc/README.md含解析约定、示例、IDEA `.http` 调试)。
## 目录
- src/main/java/cn/qaiu/entity通用实体如 FileInfo
- src/main/java/cn/qaiu/parser解析框架 & 各站点实现impl
- src/test/java单测与示例
## 许可证
MIT License