Java 20中如何替换已废弃的URL构造器？

1. new URL(filename)替换可行性 #

直接使用new URI(filename).toURL()大部分场景可行，但要注意两个关键差异：

• URI构造器会严格校验字符串格式，旧URL构造器的校验更宽松——比如空格、中文等特殊字符在旧URL中会自动编码，URI则直接抛出IllegalArgumentException。
• 如果filename是本地文件路径（如/home/user/file.txt），旧URL构造器会自动补全file://协议，URI需要显式指定协议，否则会报错。这种场景可以先做判断处理：

  if (!filename.startsWith("file:")) {
      // 跨平台兼容：Windows路径需处理盘符，比如将C:\test转成file:///C:/test
      filename = "file://" + (filename.startsWith("/") ? "" : "/") + filename.replace("\\", "/");
  }
  url = new URI(filename).toURL();
  

2. new URL(spec)的等价URI写法 #

直接对应new URI(spec).toURL()，但需适配URI的严格校验规则：

• 若spec包含不合法的URI字符，需手动对路径部分编码（避免整个URL被破坏）：

  // 拆分协议和路径，仅编码路径部分
  int protocolSplit = spec.indexOf("://");
  if (protocolSplit != -1) {
      String protocol = spec.substring(0, protocolSplit + 3);
      String path = spec.substring(protocolSplit + 3);
      String encodedPath = URLEncoder.encode(path, StandardCharsets.UTF_8)
              .replace("+", "%20"); // 替换空格编码为URI标准格式
      spec = protocol + encodedPath;
  }
  url = new URI(spec).toURL();
  

• 若仍报错，可尝试URI.create(spec)，它比new URI(spec)的校验更宽松，但依然遵循URI核心规范。

3. new URL(context, spec)的等价URI写法 #

对应URI的resolve()方法，步骤如下：

1. 将上下文URL（或File）转换为URI
2. 调用resolve(spec)生成新的URI
3. 转换为URL
   示例代码：

// 替换 new URL(new URL(url), relativeLoc)
URI contextUri = new URI(url);
URI resolvedUri = contextUri.resolve(relativeLoc);
return resolvedUri.toURL();

// 替换 new URL(_baseDir.toURL(), spec)
// 若_baseDir是File类型，直接用toURI()更兼容
URI baseUri = _baseDir.toURI();
URI resolvedUri = baseUri.resolve(spec);
final URL rVal = resolvedUri.toURL();

处理IllegalArgumentException的通用方法 #

• 针对性编码：仅对路径、参数等包含特殊字符的部分编码，不要编码整个URL的协议、域名部分。
• 本地文件优先用File.toURI()：自动处理跨平台路径分隔符、盘符、特殊字符，避免手动拼接file://的错误。
• 兼容旧格式：如果旧代码依赖URL的宽松校验，可捕获异常后手动修复格式，比如补全协议、转义空格为%20。

内容的提问来源于stack exchange，提问作者gouessej