当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

URLEncoder (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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)

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。