Module java.base

软件包 java.net

Class URLEncoder

java.lang.Object

java.net.URLEncoder

public class URLEncoder
extends Object

HTML表单编码的实用类。 这个类包含一个字符串转换为静态方法application/x-www-form-urlencoded MIME格式。 有关HTML表单编码的更多信息，请参阅HTML specification 。

编码字符串时，适用以下规则：

• “ a ”至“ z ”，“ A ”至“ Z ”和“ 0 ”至“ 9 ”的字母数字字符保持不变。
• 特殊字符“ . ”，“ - ”，“ * ”和“ _ ”保持不变。
• 空格字符“”被转换为加号“ + ”。
• 所有其他字符都不安全，并且首先使用一些编码方案将其转换为一个或多个字节。 然后每个字节由3个字符串“ %xy ”表示，其中xy是字节的两位十六进制表示。 推荐使用的编码方案是UTF-8。 但是，出于兼容性原因，如果未指定编码，则使用平台的默认编码。

例如，使用UTF-8作为编码方案，字符串“Ã@ foo-bar”将被转换为“The + string +％C3％BC％40foo-bar”，因为在UTF-8中，字符¼被编码为2字节C3（十六进制）和BC（十六进制），字符@被编码为一个字节40（十六进制）。

从以下版本开始：

1.0

方法摘要

Modifier and Type	方法	描述
static String	encode(String s)	已过时。 结果字符串可能会因平台的默认编码而异。 而是使用encode（String，String）方法来指定编码。
static String	encode(String s, String enc)	使用特定的编码方案将字符串转换为 application/x-www-form-urlencoded格式。

Methods inherited from class 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 - 支持的名称 character encoding 。

结果

翻译 String 。

异常

UnsupportedEncodingException - 如果不支持命名编码

从以下版本开始：

1.4

另请参见：

URLDecoder.decode(java.lang.String, java.lang.String)