UrlQuery (hutool 5.8.41 API)

java.lang.Object
- cn.hutool.core.net.url.UrlQuery

```
public class UrlQuery
extends Object
```
URL中查询字符串部分的封装，类似于：
```
   key1=v1&key2=&key3=v3
 
```
查询封装分为解析查询字符串和构建查询字符串，解析可通过charset为null来自定义是否decode编码后的内容，
构建则通过charset是否为null是否encode参数键值对
Since:

5.3.1

Author:

looly

Constructor Summary

Constructors
Constructor and Description
`UrlQuery()` 构造
`UrlQuery(boolean isFormUrlEncoded)` 构造
`UrlQuery(Map<? extends CharSequence,?> queryMap)` 构造
`UrlQuery(Map<? extends CharSequence,?> queryMap, boolean isFormUrlEncoded)` 构造

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`UrlQuery`	`add(CharSequence key, Object value)` 增加键值对
`UrlQuery`	`addAll(Map<? extends CharSequence,?> queryMap)` 批量增加键值对
`String`	`build(Charset charset)` 构建URL查询字符串，即将key-value键值对转换为`key1=v1&key2=v2&key3=v3`形式。
`String`	`build(Charset charset, boolean encodePercent)` 构建URL查询字符串，即将key-value键值对转换为`key1=v1&key2=v2&key3=v3`形式。
`String`	`build(PercentCodec keyCoder, PercentCodec valueCoder, Charset charset)` 构建URL查询字符串，即将key-value键值对转换为`key1=v1&key2=v2&key3=v3`形式。
`String`	`build(PercentCodec keyCoder, PercentCodec valueCoder, Charset charset, boolean encodePercent)` 构建URL查询字符串，即将key-value键值对转换为`key1=v1&key2=v2&key3=v3`形式。
`CharSequence`	`get(CharSequence key)` 获取查询值
`Map<CharSequence,CharSequence>`	`getQueryMap()` 获得查询的Map
`static UrlQuery`	`of(Map<? extends CharSequence,?> queryMap)` 构建UrlQuery
`static UrlQuery`	`of(Map<? extends CharSequence,?> queryMap, boolean isFormUrlEncoded)` 构建UrlQuery
`static UrlQuery`	`of(String queryStr, Charset charset)` 构建UrlQuery
`static UrlQuery`	`of(String queryStr, Charset charset, boolean autoRemovePath)` 构建UrlQuery
`static UrlQuery`	`of(String queryStr, Charset charset, boolean autoRemovePath, boolean isFormUrlEncoded)` 构建UrlQuery
`UrlQuery`	`parse(String queryStr, Charset charset)` 解析URL中的查询字符串
`UrlQuery`	`parse(String queryStr, Charset charset, boolean autoRemovePath)` 解析URL中的查询字符串
`UrlQuery`	`remove(CharSequence key)` 移除键及对应所有的值
`UrlQuery`	`setStrict(boolean strict)` 设置是否严格模式
`String`	`toString()` 生成查询字符串，类似于aaa=111&bbb=222 此方法不对任何特殊字符编码，仅用于输出显示

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

- Constructor Detail
  - UrlQuery
```
public UrlQuery()
```
    构造
  - UrlQuery
```
public UrlQuery(boolean isFormUrlEncoded)
```
    构造
    
    Parameters:
    
    isFormUrlEncoded - 是否为x-www-form-urlencoded模式，此模式下空格会编码为'+'
    
    Since:
    
    5.7.16
  - UrlQuery
```
public UrlQuery(Map<? extends CharSequence,?> queryMap)
```
    构造
    
    Parameters:
    
    queryMap - 初始化的查询键值对
  - UrlQuery
```
public UrlQuery(Map<? extends CharSequence,?> queryMap,
                boolean isFormUrlEncoded)
```
    构造
    
    Parameters:
    
    queryMap - 初始化的查询键值对
    
    isFormUrlEncoded - 是否为x-www-form-urlencoded模式，此模式下空格会编码为'+'
    
    Since:
    
    5.7.16
- Method Detail
  - of
```
public static UrlQuery of(Map<? extends CharSequence,?> queryMap)
```
    构建UrlQuery
    
    Parameters:
    
    queryMap - 初始化的查询键值对
    
    Returns:
    
    UrlQuery
  - of
```
public static UrlQuery of(Map<? extends CharSequence,?> queryMap,
                          boolean isFormUrlEncoded)
```
    构建UrlQuery
    
    Parameters:
    
    queryMap - 初始化的查询键值对
    
    isFormUrlEncoded - 是否为x-www-form-urlencoded模式，此模式下空格会编码为'+'
    
    Returns:
    
    UrlQuery
  - of
```
public static UrlQuery of(String queryStr,
                          Charset charset)
```
    构建UrlQuery
    
    Parameters:
    
    queryStr - 初始化的查询字符串
    
    charset - decode用的编码，null表示不做decode
    
    Returns:
    
    UrlQuery
  - of
```
public static UrlQuery of(String queryStr,
                          Charset charset,
                          boolean autoRemovePath)
```
    构建UrlQuery
    
    Parameters:
    
    queryStr - 初始化的查询字符串
    
    charset - decode用的编码，null表示不做decode
    
    autoRemovePath - 是否自动去除path部分，true则自动去除第一个?前的内容
    
    Returns:
    
    UrlQuery
    
    Since:
    
    5.5.8
  - of
```
public static UrlQuery of(String queryStr,
                          Charset charset,
                          boolean autoRemovePath,
                          boolean isFormUrlEncoded)
```
    构建UrlQuery
    
    Parameters:
    
    queryStr - 初始化的查询字符串
    
    charset - decode用的编码，null表示不做decode
    
    autoRemovePath - 是否自动去除path部分，true则自动去除第一个?前的内容
    
    isFormUrlEncoded - 是否为x-www-form-urlencoded模式，此模式下空格会编码为'+'
    
    Returns:
    
    UrlQuery
    
    Since:
    
    5.7.16
  - setStrict
```
public UrlQuery setStrict(boolean strict)
```
    设置是否严格模式
    
    Parameters:
    
    strict - 是否严格模式
    
    Returns:
    
    this
    
    Since:
    
    5.8.20
  - add
```
public UrlQuery add(CharSequence key,
                    Object value)
```
    增加键值对
    
    Parameters:
    
    key - 键
    
    value - 值，集合和数组转换为逗号分隔形式
    
    Returns:
    
    this
  - addAll
```
public UrlQuery addAll(Map<? extends CharSequence,?> queryMap)
```
    批量增加键值对
    
    Parameters:
    
    queryMap - query中的键值对
    
    Returns:
    
    this
  - remove
```
public UrlQuery remove(CharSequence key)
```
    移除键及对应所有的值
    
    Parameters:
    
    key - 键
    
    Returns:
    
    this
    
    Since:
    
    5.8.30
  - parse
```
public UrlQuery parse(String queryStr,
                      Charset charset)
```
    解析URL中的查询字符串
    
    Parameters:
    
    queryStr - 查询字符串，类似于key1=v1&key2=&key3=v3
    
    charset - decode编码，null表示不做decode
    
    Returns:
    
    this
  - parse
```
public UrlQuery parse(String queryStr,
                      Charset charset,
                      boolean autoRemovePath)
```
    解析URL中的查询字符串
    
    Parameters:
    
    queryStr - 查询字符串，类似于key1=v1&key2=&key3=v3
    
    charset - decode编码，null表示不做decode
    
    autoRemovePath - 是否自动去除path部分，true则自动去除第一个?前的内容
    
    Returns:
    
    this
    
    Since:
    
    5.5.8
  - getQueryMap
```
public Map<CharSequence,CharSequence> getQueryMap()
```
    获得查询的Map
    
    Returns:
    
    查询的Map，只读
  - get
```
public CharSequence get(CharSequence key)
```
    获取查询值
    
    Parameters:
    
    key - 键
    
    Returns:
    
    值
  - build
```
public String build(Charset charset)
```
    构建URL查询字符串，即将key-value键值对转换为key1=v1&key2=v2&key3=v3形式。
    对于null处理规则如下：
    - 如果key为null，则这个键值对忽略
    - 如果value为null，只保留key，如key1对应value为null生成类似于key1&key2=v2形式
    Parameters:
    
    charset - encode编码，null表示不做encode编码
    
    Returns:
    
    URL查询字符串
  - build
```
public String build(Charset charset,
                    boolean encodePercent)
```
    构建URL查询字符串，即将key-value键值对转换为key1=v1&key2=v2&key3=v3形式。
    对于null处理规则如下：
    - 如果key为null，则这个键值对忽略
    - 如果value为null，只保留key，如key1对应value为null生成类似于key1&key2=v2形式
    Parameters:
    
    charset - encode编码，null表示不做encode编码
    
    encodePercent - 是否编码`%`
    
    Returns:
    
    URL查询字符串
  - build
```
public String build(PercentCodec keyCoder,
                    PercentCodec valueCoder,
                    Charset charset)
```
    构建URL查询字符串，即将key-value键值对转换为key1=v1&key2=v2&key3=v3形式。
    对于null处理规则如下：
    - 如果key为null，则这个键值对忽略
    - 如果value为null，只保留key，如key1对应value为null生成类似于key1&key2=v2形式
    Parameters:
    
    keyCoder - 键值对中键的编码器
    
    valueCoder - 键值对中值的编码器
    
    charset - encode编码，null表示不做encode编码
    
    Returns:
    
    URL查询字符串
    
    Since:
    
    5.7.16
  - build
```
public String build(PercentCodec keyCoder,
                    PercentCodec valueCoder,
                    Charset charset,
                    boolean encodePercent)
```
    构建URL查询字符串，即将key-value键值对转换为key1=v1&key2=v2&key3=v3形式。
    对于null处理规则如下：
    - 如果key为null，则这个键值对忽略
    - 如果value为null，只保留key，如key1对应value为null生成类似于key1&key2=v2形式
    Parameters:
    
    keyCoder - 键值对中键的编码器
    
    valueCoder - 键值对中值的编码器
    
    charset - encode编码，null表示不做encode编码
    
    encodePercent - 是否编码`%`
    
    Returns:
    
    URL查询字符串
    
    Since:
    
    5.8.0
  - toString
```
public String toString()
```
    生成查询字符串，类似于aaa=111&bbb=222
    此方法不对任何特殊字符编码，仅用于输出显示
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    查询字符串

Class UrlQuery

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

UrlQuery

UrlQuery

UrlQuery

UrlQuery

Method Detail

of

of

of

of

of

setStrict

add

addAll

remove

parse

parse

getQueryMap

get

build

build

build

build

toString