UrlBuilder (hutool-core 5.8.9 API)

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

所有已实现的接口:: Builder<String>, Serializable

public final class UrlBuilder
extends Object
implements Builder<String>

URL 生成器，格式形如：

 [scheme:]scheme-specific-part[#fragment]
 [scheme:][//authority][path][?query][#fragment]
 [scheme:][//host:port][path][?query][#fragment]

从以下版本开始:: 5.3.1
作者:: looly
另请参阅:: Uniform Resource Identifier, 序列化表格

构造器概要

构造器
构造器和说明
`UrlBuilder()` 构造
`UrlBuilder(String scheme, String host, int port, UrlPath path, UrlQuery query, String fragment, Charset charset)` 构造

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`UrlBuilder`	`addPath(CharSequence path)` 增加路径，在现有路径基础上追加路径
`UrlBuilder`	`addPathSegment(CharSequence segment)` 增加路径节点，路径节点中的"/"会被转义为"%2F"
`UrlBuilder`	`addQuery(String key, Object value)` 添加查询项，支持重复键
`UrlBuilder`	`appendPath(CharSequence path)` 已过时。方法重复，请使用`addPath(CharSequence)`
`String`	`build()` 创建URL字符串
`static UrlBuilder`	`create()` 已过时。请使用 `of()`
`String`	`getAuthority()` 获得authority部分
`Charset`	`getCharset()` 获取编码，用于URLEncode和URLDecode
`String`	`getFragment()` 获取标识符，#后边的部分
`String`	`getFragmentEncoded()` 获取标识符，#后边的部分
`String`	`getHost()` 获取主机，例如127.0.0.1
`UrlPath`	`getPath()` 获取路径，例如/aa/bb/cc
`String`	`getPathStr()` 获得路径，例如/aa/bb/cc
`int`	`getPort()` 获取端口，默认-1
`int`	`getPortWithDefault()` 获取端口，如果未自定义返回协议默认端口
`UrlQuery`	`getQuery()` 获取查询语句，例如a=1&b=2 可能为`null`
`String`	`getQueryStr()` 获取查询语句，例如a=1&b=2
`String`	`getScheme()` 获取协议，例如http
`String`	`getSchemeWithDefault()` 获取协议，例如http，如果用户未定义协议，使用默认的http协议
`static UrlBuilder`	`of()` 创建空的UrlBuilder
`static UrlBuilder`	`of(String url)` 使用URL字符串构建UrlBuilder，默认使用UTF-8编码
`static UrlBuilder`	`of(String url, Charset charset)` 使用URL字符串构建UrlBuilder
`static UrlBuilder`	`of(String scheme, String host, int port, String path, String query, String fragment, Charset charset)` 构建UrlBuilder
`static UrlBuilder`	`of(String scheme, String host, int port, UrlPath path, UrlQuery query, String fragment, Charset charset)` 构建UrlBuilder
`static UrlBuilder`	`of(URI uri, Charset charset)` 使用URI构建UrlBuilder
`static UrlBuilder`	`of(URL url, Charset charset)` 使用URL构建UrlBuilder
`static UrlBuilder`	`ofHttp(String httpUrl)` 使用URL字符串构建UrlBuilder，当传入的URL没有协议时，按照http协议对待，编码默认使用UTF-8
`static UrlBuilder`	`ofHttp(String httpUrl, Charset charset)` 使用URL字符串构建UrlBuilder，当传入的URL没有协议时，按照http协议对待。
`static UrlBuilder`	`ofHttpWithoutEncode(String httpUrl)` 使用URL字符串构建UrlBuilder，当传入的URL没有协议时，按照http协议对待此方法不对URL编码
`UrlBuilder`	`setCharset(Charset charset)` 设置编码，用于URLEncode和URLDecode
`UrlBuilder`	`setFragment(String fragment)` 设置标识符，例如#后边的部分
`UrlBuilder`	`setHost(String host)` 设置主机，例如127.0.0.1
`UrlBuilder`	`setPath(UrlPath path)` 设置路径，例如/aa/bb/cc，将覆盖之前所有的path相关设置
`UrlBuilder`	`setPort(int port)` 设置端口，默认-1
`UrlBuilder`	`setQuery(UrlQuery query)` 设置查询语句，例如a=1&b=2，将覆盖之前所有的query相关设置
`UrlBuilder`	`setScheme(String scheme)` 设置协议，例如http
`UrlBuilder`	`setWithEndTag(boolean withEngTag)` 是否path的末尾加 /
`String`	`toString()`
`URI`	`toURI()` 转换为URI
`URL`	`toURL()` 转换为`URL` 对象
`URL`	`toURL(URLStreamHandler handler)` 转换为`URL` 对象

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - UrlBuilder
```
public UrlBuilder()
```
    构造
  - UrlBuilder
```
public UrlBuilder(String scheme,
                  String host,
                  int port,
                  UrlPath path,
                  UrlQuery query,
                  String fragment,
                  Charset charset)
```
    构造
    
    参数:
    
    scheme - 协议，默认http
    
    host - 主机，例如127.0.0.1
    
    port - 端口，-1表示默认端口
    
    path - 路径，例如/aa/bb/cc
    
    query - 查询，例如a=1&b=2
    
    fragment - 标识符例如#后边的部分
    
    charset - 编码，用于URLEncode和URLDecode，null表示不编码
- 方法详细资料
  - of
```
public static UrlBuilder of(URI uri,
                            Charset charset)
```
    使用URI构建UrlBuilder
    
    参数:
    
    uri - URI
    
    charset - 编码，用于URLEncode和URLDecode
    
    返回:
    
    UrlBuilder
  - ofHttpWithoutEncode
```
public static UrlBuilder ofHttpWithoutEncode(String httpUrl)
```
    使用URL字符串构建UrlBuilder，当传入的URL没有协议时，按照http协议对待
    此方法不对URL编码
    
    参数:
    
    httpUrl - URL字符串
    
    返回:
    
    UrlBuilder
    
    从以下版本开始:
    
    5.4.3
  - ofHttp
```
public static UrlBuilder ofHttp(String httpUrl)
```
    使用URL字符串构建UrlBuilder，当传入的URL没有协议时，按照http协议对待，编码默认使用UTF-8
    
    参数:
    
    httpUrl - URL字符串
    
    返回:
    
    UrlBuilder
    
    从以下版本开始:
    
    5.6.3
  - ofHttp
```
public static UrlBuilder ofHttp(String httpUrl,
                                Charset charset)
```
    使用URL字符串构建UrlBuilder，当传入的URL没有协议时，按照http协议对待。
    
    参数:
    
    httpUrl - URL字符串
    
    charset - 编码，用于URLEncode和URLDecode
    
    返回:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(String url)
```
    使用URL字符串构建UrlBuilder，默认使用UTF-8编码
    
    参数:
    
    url - URL字符串
    
    返回:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(String url,
                            Charset charset)
```
    使用URL字符串构建UrlBuilder
    
    参数:
    
    url - URL字符串
    
    charset - 编码，用于URLEncode和URLDecode
    
    返回:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(URL url,
                            Charset charset)
```
    使用URL构建UrlBuilder
    
    参数:
    
    url - URL
    
    charset - 编码，用于URLEncode和URLDecode
    
    返回:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(String scheme,
                            String host,
                            int port,
                            String path,
                            String query,
                            String fragment,
                            Charset charset)
```
    构建UrlBuilder
    
    参数:
    
    scheme - 协议，默认http
    
    host - 主机，例如127.0.0.1
    
    port - 端口，-1表示默认端口
    
    path - 路径，例如/aa/bb/cc
    
    query - 查询，例如a=1&b=2
    
    fragment - 标识符例如#后边的部分
    
    charset - 编码，用于URLEncode和URLDecode
    
    返回:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(String scheme,
                            String host,
                            int port,
                            UrlPath path,
                            UrlQuery query,
                            String fragment,
                            Charset charset)
```
    构建UrlBuilder
    
    参数:
    
    scheme - 协议，默认http
    
    host - 主机，例如127.0.0.1
    
    port - 端口，-1表示默认端口
    
    path - 路径，例如/aa/bb/cc
    
    query - 查询，例如a=1&b=2
    
    fragment - 标识符例如#后边的部分
    
    charset - 编码，用于URLEncode和URLDecode
    
    返回:
    
    UrlBuilder
  - create
```
@Deprecated
public static UrlBuilder create()
```
    已过时。请使用 of()
    
    创建空的UrlBuilder
    
    返回:
    
    UrlBuilder
  - of
```
public static UrlBuilder of()
```
    创建空的UrlBuilder
    
    返回:
    
    UrlBuilder
  - getScheme
```
public String getScheme()
```
    获取协议，例如http
    
    返回:
    
    协议，例如http
  - getSchemeWithDefault
```
public String getSchemeWithDefault()
```
    获取协议，例如http，如果用户未定义协议，使用默认的http协议
    
    返回:
    
    协议，例如http
  - setScheme
```
public UrlBuilder setScheme(String scheme)
```
    设置协议，例如http
    
    参数:
    
    scheme - 协议，例如http
    
    返回:
    
    this
  - getHost
```
public String getHost()
```
    获取主机，例如127.0.0.1
    
    返回:
    
    主机，例如127.0.0.1
  - setHost
```
public UrlBuilder setHost(String host)
```
    设置主机，例如127.0.0.1
    
    参数:
    
    host - 主机，例如127.0.0.1
    
    返回:
    
    this
  - getPort
```
public int getPort()
```
    获取端口，默认-1
    
    返回:
    
    端口，默认-1
  - getPortWithDefault
```
public int getPortWithDefault()
```
    获取端口，如果未自定义返回协议默认端口
    
    返回:
    
    端口
  - setPort
```
public UrlBuilder setPort(int port)
```
    设置端口，默认-1
    
    参数:
    
    port - 端口，默认-1
    
    返回:
    
    this
  - getAuthority
```
public String getAuthority()
```
    获得authority部分
    
    返回:
    
    authority部分
  - getPath
```
public UrlPath getPath()
```
    获取路径，例如/aa/bb/cc
    
    返回:
    
    路径，例如/aa/bb/cc
  - getPathStr
```
public String getPathStr()
```
    获得路径，例如/aa/bb/cc
    
    返回:
    
    路径，例如/aa/bb/cc
  - setWithEndTag
```
public UrlBuilder setWithEndTag(boolean withEngTag)
```
    是否path的末尾加 /
    
    参数:
    
    withEngTag - 是否path的末尾加 /
    
    返回:
    
    this
    
    从以下版本开始:
    
    5.8.5
  - setPath
```
public UrlBuilder setPath(UrlPath path)
```
    设置路径，例如/aa/bb/cc，将覆盖之前所有的path相关设置
    
    参数:
    
    path - 路径，例如/aa/bb/cc
    
    返回:
    
    this
  - addPath
```
public UrlBuilder addPath(CharSequence path)
```
    增加路径，在现有路径基础上追加路径
    
    参数:
    
    path - 路径，例如aaa/bbb/ccc
    
    返回:
    
    this
  - addPathSegment
```
public UrlBuilder addPathSegment(CharSequence segment)
```
    增加路径节点，路径节点中的"/"会被转义为"%2F"
    
    参数:
    
    segment - 路径节点
    
    返回:
    
    this
    
    从以下版本开始:
    
    5.7.16
  - appendPath
```
@Deprecated
public UrlBuilder appendPath(CharSequence path)
```
    已过时。方法重复，请使用addPath(CharSequence)
    
    追加path节点
    
    参数:
    
    path - path节点
    
    返回:
    
    this
  - getQuery
```
public UrlQuery getQuery()
```
    获取查询语句，例如a=1&b=2
    可能为null
    
    返回:
    
    查询语句，例如a=1&b=2，可能为null
  - getQueryStr
```
public String getQueryStr()
```
    获取查询语句，例如a=1&b=2
    
    返回:
    
    查询语句，例如a=1&b=2
  - setQuery
```
public UrlBuilder setQuery(UrlQuery query)
```
    设置查询语句，例如a=1&b=2，将覆盖之前所有的query相关设置
    
    参数:
    
    query - 查询语句，例如a=1&b=2
    
    返回:
    
    this
  - addQuery
```
public UrlBuilder addQuery(String key,
                           Object value)
```
    添加查询项，支持重复键
    
    参数:
    
    key - 键
    
    value - 值
    
    返回:
    
    this
  - getFragment
```
public String getFragment()
```
    获取标识符，#后边的部分
    
    返回:
    
    标识符，例如#后边的部分
  - getFragmentEncoded
```
public String getFragmentEncoded()
```
    获取标识符，#后边的部分
    
    返回:
    
    标识符，例如#后边的部分
  - setFragment
```
public UrlBuilder setFragment(String fragment)
```
    设置标识符，例如#后边的部分
    
    参数:
    
    fragment - 标识符，例如#后边的部分
    
    返回:
    
    this
  - getCharset
```
public Charset getCharset()
```
    获取编码，用于URLEncode和URLDecode
    
    返回:
    
    编码
  - setCharset
```
public UrlBuilder setCharset(Charset charset)
```
    设置编码，用于URLEncode和URLDecode
    
    参数:
    
    charset - 编码
    
    返回:
    
    this
  - build
```
public String build()
```
    创建URL字符串
    
    指定者:
    
    build 在接口中 Builder<String>
    
    返回:
    
    URL字符串
  - toURL
```
public URL toURL()
```
    转换为URL 对象
    
    返回:
    
    URL
  - toURL
```
public URL toURL(URLStreamHandler handler)
```
    转换为URL 对象
    
    参数:
    
    handler - URLStreamHandler，null表示默认
    
    返回:
    
    URL
  - toURI
```
public URI toURI()
```
    转换为URI
    
    返回:
    
    URI
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object

类 UrlBuilder

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

UrlBuilder

UrlBuilder

方法详细资料

of

ofHttpWithoutEncode

ofHttp

ofHttp

of

of

of

of

of

create

of

getScheme

getSchemeWithDefault

setScheme

getHost

setHost

getPort

getPortWithDefault

setPort

getAuthority

getPath

getPathStr

setWithEndTag

setPath

addPath

addPathSegment

appendPath

getQuery

getQueryStr

setQuery

addQuery

getFragment

getFragmentEncoded

setFragment

getCharset

setCharset

build

toURL

toURL

toURI

toString