QueryStringDecoder (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.handler.codec.http.QueryStringDecoder

```
public class QueryStringDecoder
extends java.lang.Object
```
将HTTP查询字符串拆分为路径字符串和键值参数对。该解码器仅供一次使用。为每个URI创建一个新的实例：
```
  QueryStringDecoder decoder = new QueryStringDecoder("/hello?recipient=world&x=1;y=2");
 assert decoder.path().equals("/hello");
 assert decoder.parameters().get("recipient").get(0).equals("world");
 assert decoder.parameters().get("x").get(0).equals("1");
 assert decoder.parameters().get("y").get(0).equals("2"); 
```
该解码器还可以解码内容类型为application/x-www-form-urlencoded的HTTP POST请求的内容：
```
  QueryStringDecoder decoder = new QueryStringDecoder("recipient=world&x=1;y=2", false);
 ... 
```
HashDOS漏洞修复
作为解决HashDOS漏洞的解决方法，解码器限制解码的键值参数对的最大数量，默认最大为1024，并且您可以在通过传递附加整数参数构造解码器时对其进行配置。
另请参见：

QueryStringEncoder

构造方法摘要

构造方法
Constructor and Description
`QueryStringDecoder(java.lang.String uri)` 创建一个解码指定URI的新解码器。
`QueryStringDecoder(java.lang.String uri, boolean hasPath)` 创建一个新的解码器，用于解码指定字符集中编码的指定URI。
`QueryStringDecoder(java.lang.String uri, java.nio.charset.Charset charset)` 创建一个新的解码器，用于解码指定字符集中编码的指定URI。
`QueryStringDecoder(java.lang.String uri, java.nio.charset.Charset charset, boolean hasPath)` 创建一个新的解码器，用于解码指定字符集中编码的指定URI。
`QueryStringDecoder(java.lang.String uri, java.nio.charset.Charset charset, boolean hasPath, int maxParams)` 创建一个新的解码器，用于解码指定字符集中编码的指定URI。
`QueryStringDecoder(java.net.URI uri)` 创建一个解码指定URI的新解码器。
`QueryStringDecoder(java.net.URI uri, java.nio.charset.Charset charset)` 创建一个新的解码器，用于解码指定字符集中编码的指定URI。
`QueryStringDecoder(java.net.URI uri, java.nio.charset.Charset charset, int maxParams)` 创建一个新的解码器，用于解码指定字符集中编码的指定URI。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`static java.lang.String`	`decodeComponent(java.lang.String s)` 解码浏览器编码的URL的一小部分。
`static java.lang.String`	`decodeComponent(java.lang.String s, java.nio.charset.Charset charset)` 解码由浏览器编码的URL的一小部分。
`java.util.Map<java.lang.String,java.util.List<java.lang.String>>`	`parameters()` 返回URI的解码键值参数对。
`java.lang.String`	`path()` 返回URI的解码路径字符串。
`java.lang.String`	`rawPath()` 返回URI的原始路径字符串。
`java.lang.String`	`rawQuery()` 返回URI的原始查询字符串。
`java.lang.String`	`toString()`
`java.lang.String`	`uri()` 返回用于初始化此`QueryStringDecoder`的uri。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - QueryStringDecoder
```
public QueryStringDecoder(java.lang.String uri)
```
    创建一个解码指定URI的新解码器。解码器将假定查询字符串以UTF-8编码。
  - QueryStringDecoder
```
public QueryStringDecoder(java.lang.String uri,
                          boolean hasPath)
```
    创建一个新的解码器，用于解码指定字符集中编码的指定URI。
  - QueryStringDecoder
```
public QueryStringDecoder(java.lang.String uri,
                          java.nio.charset.Charset charset)
```
    创建一个新的解码器，用于解码指定字符集中编码的指定URI。
  - QueryStringDecoder
```
public QueryStringDecoder(java.lang.String uri,
                          java.nio.charset.Charset charset,
                          boolean hasPath)
```
    创建一个新的解码器，用于解码指定字符集中编码的指定URI。
  - QueryStringDecoder
```
public QueryStringDecoder(java.lang.String uri,
                          java.nio.charset.Charset charset,
                          boolean hasPath,
                          int maxParams)
```
    创建一个新的解码器，用于解码指定字符集中编码的指定URI。
  - QueryStringDecoder
```
public QueryStringDecoder(java.net.URI uri)
```
    创建一个解码指定URI的新解码器。解码器将假定查询字符串以UTF-8编码。
  - QueryStringDecoder
```
public QueryStringDecoder(java.net.URI uri,
                          java.nio.charset.Charset charset)
```
    创建一个新的解码器，用于解码指定字符集中编码的指定URI。
  - QueryStringDecoder
```
public QueryStringDecoder(java.net.URI uri,
                          java.nio.charset.Charset charset,
                          int maxParams)
```
    创建一个新的解码器，用于解码指定字符集中编码的指定URI。
- 方法详细信息
  - toString
```
public java.lang.String toString()
```
    重写：
    
    toString在课程 java.lang.Object
  - uri
```
public java.lang.String uri()
```
    返回用于初始化此QueryStringDecoder的uri。
  - path
```
public java.lang.String path()
```
    返回URI的解码路径字符串。
  - parameters
```
public java.util.Map<java.lang.String,java.util.List<java.lang.String>> parameters()
```
    返回URI的解码键值参数对。
  - rawPath
```
public java.lang.String rawPath()
```
    返回URI的原始路径字符串。
  - rawQuery
```
public java.lang.String rawQuery()
```
    返回URI的原始查询字符串。
  - decodeComponent
```
public static java.lang.String decodeComponent(java.lang.String s)
```
    解码由浏览器编码的URL的一小部分。
    这相当于使用UTF-8字符集调用decodeComponent(String, Charset) （建议遵守RFC 3986，第2节）。
    
    参数
    
    s - 要解码的字符串（可以为空）。
    
    结果
    
    解码的字符串，或者s如果没有任何解码。如果要解码的字符串是null ，则返回空字符串。
    
    异常
    
    java.lang.IllegalArgumentException - 如果该字符串包含格式不正确的转义序列。
  - decodeComponent
```
public static java.lang.String decodeComponent(java.lang.String s,
                                               java.nio.charset.Charset charset)
```
    解码由浏览器编码的URL的一小部分。
    该字符串预计将按照RFC 3986第2部分进行编码。这是JavaScript函数encodeURI和encodeURIComponent使用的编码，但不是escape 。例如在此编码中，Ã（Unicode U+00E9或UTF-8 0xC3 0xA9 ）编码为%C3%A9或%c3%a9 。
    
    这基本上等同于调用URLDecoder.decode(String, String)不同之处在于它的速度提高了2倍以上，并为GC生成更少的垃圾。其实这个函数不分配任何内存，如果没有任何解码，参数本身返回。
    
    参数
    
    s - 要解码的字符串（可以为空）。
    
    charset - 用于解码字符串的字符集（应该是 CharsetUtil.UTF_8 。
    
    结果
    
    解码的字符串，或者s如果没有解码的话。如果要解码的字符串是null ，则返回空字符串。
    
    异常
    
    java.lang.IllegalArgumentException - 如果该字符串包含格式错误的转义序列。

Class QueryStringDecoder

HashDOS漏洞修复

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

QueryStringDecoder

QueryStringDecoder

QueryStringDecoder

QueryStringDecoder

QueryStringDecoder

QueryStringDecoder

QueryStringDecoder

QueryStringDecoder

方法详细信息

toString

uri

path

parameters

rawPath

rawQuery

decodeComponent

decodeComponent