netdisk-fast-download/parser/README.md

parser

NFD 解析器模块：聚合各类网盘/分享页解析，统一输出文件列表与下载信息，供上层下载器使用。

• 语言：Java 17
• 构建：Maven
• 模块版本：10.1.17

依赖（Maven Central）

<dependency>
  <groupId>cn.qaiu</groupId>
  <artifactId>parser</artifactId>
  <version>10.1.17</version>
</dependency>

• Gradle Groovy DSL：

dependencies {
  implementation 'cn.qaiu:parser:10.1.17'
}

• Gradle Kotlin DSL：

dependencies {
  implementation("cn.qaiu:parser:10.1.17")
}

核心 API 速览

• WebClientVertxInit：注入/获取 Vert.x 实例（内部 HTTP 客户端依赖）。
• ParserCreate：从分享链接或类型构建解析器；生成短链 path。
• IPanTool：统一解析接口（parse、parseFileList、parseById）。
• CustomParserRegistry：自定义解析器注册中心（支持扩展）。
• CustomParserConfig：自定义解析器配置类（支持扩展）。

使用示例（极简）

Vertx vx = Vertx.vertx();
WebClientVertxInit.init(vx);
IPanTool tool = ParserCreate.fromShareUrl("https://www.lanzoui.com/xxx").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

自定义解析器扩展

本模块支持用户自定义解析器扩展。通过简单的配置和注册，你可以添加自己的网盘解析实现：

// 1. 实现 IPanTool 接口
public class MyPanTool implements IPanTool {
    public MyPanTool(ShareLinkInfo info) { /* 必须提供此构造器 */ }
    @Override
    public Future<String> parse() { /* 实现解析逻辑 */ }
}

// 2. 注册到系统
CustomParserConfig config = CustomParserConfig.builder()
    .type("mypan")
    .displayName("我的网盘")
    .toolClass(MyPanTool.class)
    .build();
CustomParserRegistry.register(config);

// 3. 使用自定义解析器（仅支持 fromType 方式）
IPanTool tool = ParserCreate.fromType("mypan")
    .shareKey("abc123")
    .createTool();
String url = tool.parseSync();

详细文档： 自定义解析器扩展指南

文档

• parser/doc/README.md：解析约定、示例、IDEA .http 调试
• parser/doc/CUSTOM_PARSER_GUIDE.md：自定义解析器扩展完整指南

目录

• src/main/java/cn/qaiu/entity：通用实体（如 FileInfo）
• src/main/java/cn/qaiu/parser：解析框架 & 各站点实现（impl）
• src/test/java：单测与示例

许可证

MIT License