Java 解析磁力链 (Magnet URI) 完整指南

2.2 使用 URLDecoder 处理编码

在解析过程中，需对参数值进行解码以还原原始内容：

import java.io.UnsupportedEncodingException;
import java.net.URLDecoder;

// 在上述 parseMagnetLink 方法中添加解码处理
try {
    value = URLDecoder.decode(value, "UTF-8");
} catch (UnsupportedEncodingException e) {
    // 保持原始值
}

3. 完整示例代码

import java.io.UnsupportedEncodingException;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URLDecoder;
import java.util.HashMap;
import java.util.Map;

public class MagnetURIParserDemo {
    public static void main(String[] args) {
        String magnetLink = "magnet:?xt=urn:btih:1a2b3c4d5e6f7g8h9i0j&dn=example+file.mp4&tr=udp%3A%2F%2Ftracker.example.com%3A6969";
        try {
            Map<String, String> result = parseMagnetLink(magnetLink);
            System.out.println("磁力链解析结果:");
            System.out.println("哈希值：" + extractHash(result.get("xt")));
            System.out.println("文件名：" + result.get("dn"));
            System.out.println("Tracker: " + result.get("tr"));
            System.out.println("文件大小：" + (result.containsKey("xl") ? formatSize(result.get("xl")) : "未知"));
        } catch (URISyntaxException e) {
            System.err.println("无效的磁力链格式：" + e.getMessage());
        }
    }

    private static String extractHash(String xt) {
        if (xt == null) return null;
        // 从 xt 值中提取哈希部分，如"urn:btih:1a2b3c..."
        return xt.substring(xt.lastIndexOf(':') + 1);
    }

    private static String formatSize(String xl) {
        try {
            long bytes = Long.parseLong(xl);
            if (bytes < 1024) return bytes + " B";
            int exp = (int) (Math.log(bytes) / Math.log(1024));
            String pre = "KMGTPE".charAt(exp - 1) + "i";
            return String.format("%.1f %sB", bytes / Math.pow(1024, exp), pre);
        } catch (NumberFormatException e) {
            return xl + " B";
        }
    }

    public static Map<String, String> parseMagnetLink(String magnetLink) throws URISyntaxException {
        Map<String, String> params = new HashMap<>();
        URI uri = new URI(magnetLink);
        String query = uri.getRawQuery();
        if (query != null) {
            String[] pairs = query.split("&");
            for (String pair : pairs) {
                int idx = pair.indexOf("=");
                String key = idx > 0 ? pair.substring(0, idx) : pair;
                String value = idx > 0 && pair.length() > idx + 1 ? pair.substring(idx + 1) : "";
                try {
                    value = URLDecoder.decode(value, "UTF-8");
                } catch (UnsupportedEncodingException e) {
                    // 保持原始值
                }
                params.put(key, value);
            }
        }
        return params;
    }
}

4. 实际应用场景

1. BT 客户端开发：解析磁力链获取文件哈希和 Tracker 地址
2. 下载管理器：识别磁力链并启动相应下载协议
3. 资源搜索工具：从磁力链中提取关键信息建立索引
4. 文件校验工具：通过 btih 哈希验证文件完整性

5. 注意事项

磁力链 (Magnet URI) 中的参数排列具有灵活性，其核心特征包括：

1. 参数顺序可变性

   • 各参数间用"&"符号连接，但排列顺序不影响功能
   • 例如"magnet:?xt=...&dn=..."和"magnet:?dn=...&xt=..."是等效的
   • 这种设计增强了协议的兼容性

2. 参数重复机制

   • 关键参数允许重复出现，特别是 Tracker 服务器地址
   • 典型应用场景：多个备用 Tracker 时形如"tr=udp://tracker1&tr=udp://tracker2"
   • 客户端应支持解析所有重复参数值

3. 编码处理要求

   • 参数值可能包含特殊字符，需遵循 RFC 3986 的百分号编码规则
   • 常见需要解码的字符：空格 (%20)、冒号 (%3A)、斜杠 (%2F) 等
   • 实现时必须先解码再使用参数值

4. 哈希值多样性

   • 主标识符 (xt 参数) 支持多种哈希类型：
     • 40 字符的 SHA-1 哈希 (URN 格式：urn:sha1:)
     • 32 字符的 Base32 编码 (URN 格式：urn:btih:)
     • 部分客户端还支持 MD5 等其他哈希算法
   • 示例对比：
     • SHA-1：urn:sha1:YNCKHTQCWBTRNJIV4WNAE52SJUQCZO5C
     • Base32：urn:btih:QJZ5VWQ6KJNHVZ5FWAH5Q5PX6KJNHVZ5

5. 扩展性考虑

   • 协议保留未知参数的处理机制
   • 新参数应使用 x.前缀 (如 x.foo=bar)
   • 客户端应忽略无法识别的参数而不报错

6. 扩展功能

如果需要更复杂的解析，可以考虑：

1. 处理多个 Tracker 地址
2. 解析 Web 种子 (ws 参数)
3. 处理 Peer 地址 (pe 参数)
4. 支持更多哈希类型 (MD5, SHA-256 等)

通过以上方法，您可以轻松地在 Java 应用程序中解析和处理磁力链信息。