Java URL编码与解码基础

URL编码（Percent-Encoding）是将URL中的特殊字符转换为%加十六进制形式的过程。Java中主要通过java.net.URLEncoder和java.net.URLDecoder类实现。

编码示例代码：

String originalUrl = "https://example.com/search?q=Java编码测试&page=1";
String encodedUrl = URLEncoder.encode(originalUrl, StandardCharsets.UTF_8);
System.out.println("编码后：" + encodedUrl);

解码示例代码：

String encodedUrl = "https%3A%2F%2Fptop.only.wip.la%3A443%2Fhttps%2Fexample.com%2Fsearch%3Fq%3DJava%E7%BC%96%E7%A0%81%E6%B5%8B%E8%AF%95%26page%3D1";
String decodedUrl = URLDecoder.decode(encodedUrl, StandardCharsets.UTF_8);
System.out.println("解码后：" + decodedUrl);

不同部分的编码处理

URL的不同部分需要不同的编码策略。路径部分和查询参数需要分别处理：

String baseUrl = "https://example.com/path with space/";
String query = "name=张三&age=25";

String encodedPath = URLEncoder.encode(baseUrl, StandardCharsets.UTF_8)
    .replace("%3A", ":")
    .replace("%2F", "/");
String encodedQuery = URLEncoder.encode(query, StandardCharsets.UTF_8);

String fullUrl = encodedPath + "?" + encodedQuery;
System.out.println("完整编码URL：" + fullUrl);

处理特殊字符情况

某些字符在URL中有特殊意义，需要特别注意编码方式：

Map<String, String> params = new HashMap<>();
params.put("key1", "value&with/special=chars");
params.put("key2", "another value");

String queryString = params.entrySet().stream()
    .map(entry -> entry.getKey() + "=" + 
         URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8))
    .collect(Collectors.joining("&"));

System.out.println("参数编码结果：" + queryString);

使用URI类处理复杂URL

对于复杂的URL操作，可以使用java.net.URI类：

try {
    URI uri = new URI("https", "example.com", "/path with space/", "param=值", null);
    String encodedUri = uri.toASCIIString();
    System.out.println("URI编码结果：" + encodedUri);
    
    URI decodedUri = new URI(encodedUri);
    System.out.println("URI解码路径：" + decodedUri.getPath());
} catch (URISyntaxException e) {
    e.printStackTrace();
}

Spring框架中的URL处理

在使用Spring框架时，可以借助UriComponentsBuilder：

String url = UriComponentsBuilder.fromHttpUrl("https://example.com/api")
    .path("/search")
    .queryParam("query", "Java 编码")
    .queryParam("page", 2)
    .build()
    .encode(StandardCharsets.UTF_8)
    .toUriString();

System.out.println("Spring构建的URL：" + url);

常见问题与解决

避免双重编码问题：

String doubleEncoded = URLEncoder.encode(URLEncoder.encode("测试", "UTF-8"), "UTF-8");
System.out.println("双重编码结果：" + doubleEncoded);

String singleDecoded = URLDecoder.decode(doubleEncoded, "UTF-8");
System.out.println("单次解码：" + singleDecoded);
System.out.println("完全解码：" + URLDecoder.decode(singleDecoded, "UTF-8"));

处理不同编码格式：

String gb2312Encoded = URLEncoder.encode("中文", "GB2312");
System.out.println("GB2312编码：" + gb2312Encoded);

try {
    String utf8Decoded = URLDecoder.decode(gb2312Encoded, "UTF-8");
    System.out.println("用UTF-8解码GB2312编码结果：" + utf8Decoded);
} catch (Exception e) {
    System.out.println("编码不匹配导致解码失败");
}

性能优化建议

对于大量URL处理，可以考虑以下优化方式：

// 重用编码器实例
CharsetEncoder encoder = StandardCharsets.UTF_8.newEncoder();
CharsetDecoder decoder = StandardCharsets.UTF_8.newDecoder();

// 批量处理示例
List<String> urls = Arrays.asList("url1", "url2", "url3");
List<String> encodedUrls = urls.stream()
    .map(url -> {
        try {
            return URLEncoder.encode(url, StandardCharsets.UTF_8);
        } catch (Exception e) {
            return url;
        }
    })
    .collect(Collectors.toList());