URLEncoder类api_java.net.URLEncoder

java.net
类 URLEncoder

java.lang.Object
  java.net.URLEncoder

---

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

---

方法摘要
static String	encode(String s)           已过时。 结果字符串可能因平台默认编码不同而不同。因此，改用 encode(String,String) 方法指定编码。
static String	encode(String s, String enc)           使用指定的编码机制将字符串转换为 application/x-www-form-urlencoded 格式。

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

方法详细信息

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)