org.apache.http.client.utils

## Class URIBuilder

- java.lang.Object
- - org.apache.http.client.utils.URIBuilder

-     public class URIBuilder
      extends Object

  Builder为`URI`实例。
  从以下版本开始：
    4.2

- - ### 构造方法摘要

    构造方法
    Constructor and Description
    `URIBuilder()` 构造一个空实例。
    `URIBuilder(String string)` 从字符串构造一个必须是有效URI的实例。
    `URIBuilder(URI uri)` 从提供的URI构造一个实例。

  - ### 方法摘要

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `URIBuilder` | `addParameter(String param, String value)` 将参数添加到URI查询。
    `URIBuilder` | `addParameters(List<NameValuePair> nvps)` 添加URI查询参数。
    `URI` | `build()` 构建一个`URI`实例。
    `URIBuilder` | `clearParameters()` 清除URI查询参数。
    `Charset` | `getCharset()`
    `String` | `getFragment()`
    `String` | `getHost()`
    `String` | `getPath()`
    `int` | `getPort()`
    `List<NameValuePair>` | `getQueryParams()`
    `String` | `getScheme()`
    `String` | `getUserInfo()`
    `boolean` | `isAbsolute()`
    `boolean` | `isOpaque()`
    `URIBuilder` | `removeQuery()` 删除URI查询。
    `URIBuilder` | `setCharset(Charset charset)`
    `URIBuilder` | `setCustomQuery(String query)` 设置自定义URI查询。
    `URIBuilder` | `setFragment(String fragment)` 设置URI片段。
    `URIBuilder` | `setHost(String host)` 设置URI主机。
    `URIBuilder` | `setParameter(String param, String value)` 设置URI查询覆盖现有值的参数。
    `URIBuilder` | `setParameters(List<NameValuePair> nvps)` 设置URI查询参数。
    `URIBuilder` | `setParameters(NameValuePair... nvps)` 设置URI查询参数。
    `URIBuilder` | `setPath(String path)` 设置URI路径。
    `URIBuilder` | `setPort(int port)` 设置URI端口。
    `URIBuilder` | `setQuery(String query)` 已过时。 （4.3）使用`setParameters(List)`或`setParameters(NameValuePair...)`
    `URIBuilder` | `setScheme(String scheme)` 设置URI方案。
    `URIBuilder` | `setUserInfo(String userInfo)` 设置URI用户信息。
    `URIBuilder` | `setUserInfo(String username, String password)` 将URI用户信息设置为用户名和密码的组合。
    `String` | `toString()`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### 构造方法详细信息

    - #### URIBuilder

          public URIBuilder()

      构造一个空实例。

    - #### URIBuilder

          public URIBuilder(String string)
                     throws URISyntaxException

      从字符串构造一个必须是有效URI的实例。
      参数
        `string` - 字符串形式的有效URI
      异常
        `URISyntaxException` - 如果输入不是有效的URI

    - #### URIBuilder

          public URIBuilder(URI uri)

      从提供的URI构造一个实例。
      参数
        `uri` -

  - ### 方法详细信息

    - #### setCharset

          public URIBuilder setCharset(Charset charset)

      从以下版本开始：
        4.4

    - #### getCharset

          public Charset getCharset()

      从以下版本开始：
        4.4

    - #### build

          public URI build()
                    throws URISyntaxException

      构建一个`URI`实例。
      异常
        `URISyntaxException`

    - #### setScheme

          public URIBuilder setScheme(String scheme)

      设置URI方案。

    - #### setUserInfo

          public URIBuilder setUserInfo(String userInfo)

      设置URI用户信息。 该值预期为未转义，并且可能包含非ASCII字符。

    - #### setUserInfo

          public URIBuilder setUserInfo(String username,
                               String password)

      将URI用户信息设置为用户名和密码的组合。 这些值预期为未转义，并且可能包含非ASCII字符。

    - #### setHost

          public URIBuilder setHost(String host)

      设置URI主机。

    - #### setPort

          public URIBuilder setPort(int port)

      设置URI端口。

    - #### setPath

          public URIBuilder setPath(String path)

      设置URI路径。 该值预期为未转义，并且可能包含非ASCII字符。

    - #### removeQuery

          public URIBuilder removeQuery()

      删除URI查询。

    - #### setQuery

          @Deprecated
          public URIBuilder setQuery(String query)

      已过时。 （4.3）使用`setParameters(List)`或`setParameters(NameValuePair...)`
      设置URI查询。

      该值预计是编码表单数据。

      另请参见：
        `URLEncodedUtils.parse(java.net.URI, java.lang.String)`

    - #### setParameters

          public URIBuilder setParameters(List<NameValuePair> nvps)

      设置URI查询参数。 参数名称/值将被预先转义，并且可能包含非ASCII字符。

      请注意查询参数和自定义查询组件是互斥的。 此方法将删除自定义查询（如果存在）。

      从以下版本开始：
        4.3

    - #### addParameters

          public URIBuilder addParameters(List<NameValuePair> nvps)

      添加URI查询参数。 参数名称/值将被预先转义，并且可能包含非ASCII字符。

      请注意查询参数和自定义查询组件是互斥的。 此方法将删除自定义查询（如果存在）。

      从以下版本开始：
        4.3

    - #### setParameters

          public URIBuilder setParameters(NameValuePair... nvps)

      设置URI查询参数。 参数名称/值将被预先转义，并且可能包含非ASCII字符。

      请注意查询参数和自定义查询组件是互斥的。 此方法将删除自定义查询（如果存在）。

      从以下版本开始：
        4.3

    - #### addParameter

          public URIBuilder addParameter(String param,
                                String value)

      将参数添加到URI查询。 参数名称和值将被预先转义，并且可能包含非ASCII字符。

      请注意查询参数和自定义查询组件是互斥的。 此方法将删除自定义查询（如果存在）。

    - #### setParameter

          public URIBuilder setParameter(String param,
                                String value)

      设置URI查询覆盖现有值的参数。 参数名称和值将被预先转义，并且可能包含非ASCII字符。

      请注意查询参数和自定义查询组件是互斥的。 此方法将删除自定义查询（如果存在）。

    - #### clearParameters

          public URIBuilder clearParameters()

      清除URI查询参数。
      从以下版本开始：
        4.3

    - #### setCustomQuery

          public URIBuilder setCustomQuery(String query)

      设置自定义URI查询。 该值预期为未转义，并且可能包含非ASCII字符。

      请注意查询参数和自定义查询组件是互斥的。 此方法将删除查询参数（如果存在）。

      从以下版本开始：
        4.3

    - #### setFragment

          public URIBuilder setFragment(String fragment)

      设置URI片段。 该值预期为未转义，并且可能包含非ASCII字符。

    - #### isAbsolute

          public boolean isAbsolute()

      从以下版本开始：
        4.3

    - #### isOpaque

          public boolean isOpaque()

      从以下版本开始：
        4.3

    - #### getScheme

          public String getScheme()

    - #### getUserInfo

          public String getUserInfo()

    - #### getHost

          public String getHost()

    - #### getPort

          public int getPort()

    - #### getPath

          public String getPath()

    - #### getQueryParams

          public List<NameValuePair> getQueryParams()

    - #### getFragment

          public String getFragment()

    - #### toString

          public String toString()

      重写：
        `toString`类 `Object`

Copyright © 1999–2017 The Apache Software Foundation. All rights reserved.

本帮助文档是使用 《谷歌翻译》翻译，请与英文版配合使用 by--QQ:654638585