java.net
類 URLEncoder
java.lang.Object
public class URLEncoder
extends Object
HTML 格式編碼的實用工具類。該類包含了將 String 轉換爲 application/x-www-form-urlencoded
MIME 格式的靜態方法。有關 HTML 格式編碼的更多信息,請參閱 HTML 規範。
對 String 編碼時,使用以下規則:
- 字母數字字符 "
a
" 到 "z
"、"A
" 到 "Z
" 和 "0
" 到 "9
" 保持不變。 - 特殊字符 "
.
"、"-
"、"*
" 和 "_
" 保持不變。 - 空格字符 "
+
"。 - 所有其他字符都是不安全的,因此首先使用一些編碼機制將它們轉換爲一個或多個字節。然後每個字節用一個包含 3 個字符的字符串 "
%xy
" 表示,其中 xy 爲該字節的兩位十六進制表示形式。推薦的編碼機制是 UTF-8。但是,出於兼容性考慮,如果未指定一種編碼,則使用相應平臺的默認編碼。
例如,使用 UTF-8 編碼機制,字符串 "The string ü@foo-bar" 將轉換爲 "The+string+%C3%BC%40foo-bar",因爲在 UTF-8 中,字符 ü 編碼爲兩個字節,C3 (十六進制)和 BC (十六進制),字符 @ 編碼爲一個字節 40 (十六進制)。
從以下版本開始:
JDK1.0
|
|
|
|
從類 java.lang.Object 繼承的方法 |
|
encode
@Deprecated
public static String encode(String s)
已過時。 結果字符串可能因平臺默認編碼不同而不同。因此,改用 encode(String,String) 方法指定編碼。
將字符串轉換爲 x-www-form-urlencoded
格式。該方法使用相應平臺的默認編碼作爲編碼機制以獲取不安全字符的字節。
參數:
s
- 要轉換的 String
。
返回:
轉換好的 String
。
encode
public static String encode(String s,
String enc)
throws UnsupportedEncodingException
使用指定的編碼機制將字符串轉換爲 application/x-www-form-urlencoded
格式。該方法使用提供的編碼機制獲取不安全字符的字節。
注:World Wide Web Consortium Recommendation 聲明應使用 UTF-8。如果不使用該編碼,可能造成不兼容性。
參數:
s
- 要轉換的 String
。
enc
- 所支持的字符編碼名稱。
返回:
已轉換的 String
。
拋出:
UnsupportedEncodingException
- 如果不支持指定的編碼
從以下版本開始:
1.4
另請參見:
URLDecoder.decode(java.lang.String, java.lang.String)