Java URL編碼與解碼基礎詳解

更新時間：2025年06月25日 08:53:55 作者：tulisx0

這篇文章主要介紹了Java URL編碼與解碼基礎詳解,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教

Java URL編碼與解碼基礎

URL編碼（Percent-Encoding）是將URL中的特殊字符轉換為%加十六進制形式的過程。Java中主要通過java.net.URLEncoder和java.net.URLDecoder類實現(xiàn)。

編碼示例代碼：

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%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的不同部分需要不同的編碼策略。路徑部分和查詢參數(shù)需要分別處理：

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("參數(shù)編碼結果：" + 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("編碼不匹配導致解碼失敗");
}

性能優(yōu)化建議

對于大量URL處理，可以考慮以下優(yōu)化方式：

// 重用編碼器實例
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());