mirror of
https://github.com/qaiu/netdisk-fast-download.git
synced 2025-12-16 20:33:03 +00:00
67 lines
1.6 KiB
Markdown
67 lines
1.6 KiB
Markdown
# 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 >= 17，Maven >= 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
|