UrlBuilder (hutool-码云(gitee.com))

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

All Implemented Interfaces:: Serializable

public final class UrlBuilder
extends Object
implements Serializable

URL 生成器，格式形如：

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

Since:: 5.3.1
Author:: looly
See Also:: Uniform Resource Identifier, Serialized Form

Constructor Summary

Constructors
Constructor and Description
`UrlBuilder()` 构造
`UrlBuilder(String scheme, String host, int port, UrlPath path, UrlQuery query, String fragment, Charset charset)` 构造

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`UrlBuilder`	`addPath(String segment)` 增加路径节点
`UrlBuilder`	`addQuery(String key, String value)` 添加查询项，支持重复键
`UrlBuilder`	`appendPath(CharSequence segment)` 追加path节点
`String`	`build()` 创建URL字符串
`static UrlBuilder`	`create()` 创建空的UrlBuilder
`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
`UrlQuery`	`getQuery()` 获取查询语句，例如a=1&b=2
`String`	`getQueryStr()` 获取查询语句，例如a=1&b=2
`String`	`getScheme()` 获取协议，例如http
`String`	`getSchemeWithDefault()` 获取协议，例如http，如果用户未定义协议，使用默认的http协议
`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, 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
`String`	`toString()`
`URI`	`toURI()` 转换为URI
`URL`	`toURL()` 转换为`URL` 对象
`URL`	`toURL(URLStreamHandler handler)` 转换为`URL` 对象

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

- Constructor Detail
  - UrlBuilder
```
public UrlBuilder()
```
    构造
  - UrlBuilder
```
public UrlBuilder(String scheme,
                  String host,
                  int port,
                  UrlPath path,
                  UrlQuery query,
                  String fragment,
                  Charset charset)
```
    构造
    
    Parameters:
    
    scheme - 协议，默认http
    
    host - 主机，例如127.0.0.1
    
    port - 端口，-1表示默认端口
    
    path - 路径，例如/aa/bb/cc
    
    query - 查询，例如a=1&b=2
    
    fragment - 标识符例如#后边的部分
    
    charset - 编码，用于URLEncode和URLDecode
- Method Detail
  - of
```
public static UrlBuilder of(URI uri,
                            Charset charset)
```
    使用URI构建UrlBuilder
    
    Parameters:
    
    uri - URI
    
    charset - 编码，用于URLEncode和URLDecode
    
    Returns:
    
    UrlBuilder
  - ofHttpWithoutEncode
```
public static UrlBuilder ofHttpWithoutEncode(String httpUrl)
```
    使用URL字符串构建UrlBuilder，当传入的URL没有协议时，按照http协议对待
    此方法不对URL编码
    
    Parameters:
    
    httpUrl - URL字符串
    
    Returns:
    
    UrlBuilder
    
    Since:
    
    5.4.3
  - ofHttp
```
public static UrlBuilder ofHttp(String httpUrl,
                                Charset charset)
```
    使用URL字符串构建UrlBuilder，当传入的URL没有协议时，按照http协议对待。
    
    Parameters:
    
    httpUrl - URL字符串
    
    charset - 编码，用于URLEncode和URLDecode
    
    Returns:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(String url,
                            Charset charset)
```
    使用URL字符串构建UrlBuilder
    
    Parameters:
    
    url - URL字符串
    
    charset - 编码，用于URLEncode和URLDecode
    
    Returns:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(URL url,
                            Charset charset)
```
    使用URL构建UrlBuilder
    
    Parameters:
    
    url - URL
    
    charset - 编码，用于URLEncode和URLDecode
    
    Returns:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(String scheme,
                            String host,
                            int port,
                            String path,
                            String query,
                            String fragment,
                            Charset charset)
```
    构建UrlBuilder
    
    Parameters:
    
    scheme - 协议，默认http
    
    host - 主机，例如127.0.0.1
    
    port - 端口，-1表示默认端口
    
    path - 路径，例如/aa/bb/cc
    
    query - 查询，例如a=1&b=2
    
    fragment - 标识符例如#后边的部分
    
    charset - 编码，用于URLEncode和URLDecode
    
    Returns:
    
    UrlBuilder
  - of
```
public static UrlBuilder of(String scheme,
                            String host,
                            int port,
                            UrlPath path,
                            UrlQuery query,
                            String fragment,
                            Charset charset)
```
    构建UrlBuilder
    
    Parameters:
    
    scheme - 协议，默认http
    
    host - 主机，例如127.0.0.1
    
    port - 端口，-1表示默认端口
    
    path - 路径，例如/aa/bb/cc
    
    query - 查询，例如a=1&b=2
    
    fragment - 标识符例如#后边的部分
    
    charset - 编码，用于URLEncode和URLDecode
    
    Returns:
    
    UrlBuilder
  - create
```
public static UrlBuilder create()
```
    创建空的UrlBuilder
    
    Returns:
    
    UrlBuilder
  - getScheme
```
public String getScheme()
```
    获取协议，例如http
    
    Returns:
    
    协议，例如http
  - getSchemeWithDefault
```
public String getSchemeWithDefault()
```
    获取协议，例如http，如果用户未定义协议，使用默认的http协议
    
    Returns:
    
    协议，例如http
  - setScheme
```
public UrlBuilder setScheme(String scheme)
```
    设置协议，例如http
    
    Parameters:
    
    scheme - 协议，例如http
    
    Returns:
    
    this
  - getHost
```
public String getHost()
```
    获取主机，例如127.0.0.1
    
    Returns:
    
    主机，例如127.0.0.1
  - setHost
```
public UrlBuilder setHost(String host)
```
    设置主机，例如127.0.0.1
    
    Parameters:
    
    host - 主机，例如127.0.0.1
    
    Returns:
    
    this
  - getPort
```
public int getPort()
```
    获取端口，默认-1
    
    Returns:
    
    端口，默认-1
  - setPort
```
public UrlBuilder setPort(int port)
```
    设置端口，默认-1
    
    Parameters:
    
    port - 端口，默认-1
    
    Returns:
    
    this
  - getAuthority
```
public String getAuthority()
```
    获得authority部分
    
    Returns:
    
    authority部分
  - getPath
```
public UrlPath getPath()
```
    获取路径，例如/aa/bb/cc
    
    Returns:
    
    路径，例如/aa/bb/cc
  - getPathStr
```
public String getPathStr()
```
    获得路径，例如/aa/bb/cc
    
    Returns:
    
    路径，例如/aa/bb/cc
  - setPath
```
public UrlBuilder setPath(UrlPath path)
```
    设置路径，例如/aa/bb/cc，将覆盖之前所有的path相关设置
    
    Parameters:
    
    path - 路径，例如/aa/bb/cc
    
    Returns:
    
    this
  - addPath
```
public UrlBuilder addPath(String segment)
```
    增加路径节点
    
    Parameters:
    
    segment - 路径节点
    
    Returns:
    
    this
  - appendPath
```
public UrlBuilder appendPath(CharSequence segment)
```
    追加path节点
    
    Parameters:
    
    segment - path节点
    
    Returns:
    
    this
  - getQuery
```
public UrlQuery getQuery()
```
    获取查询语句，例如a=1&b=2
    
    Returns:
    
    查询语句，例如a=1&b=2
  - getQueryStr
```
public String getQueryStr()
```
    获取查询语句，例如a=1&b=2
    
    Returns:
    
    查询语句，例如a=1&b=2
  - setQuery
```
public UrlBuilder setQuery(UrlQuery query)
```
    设置查询语句，例如a=1&b=2，将覆盖之前所有的query相关设置
    
    Parameters:
    
    query - 查询语句，例如a=1&b=2
    
    Returns:
    
    this
  - addQuery
```
public UrlBuilder addQuery(String key,
                           String value)
```
    添加查询项，支持重复键
    
    Parameters:
    
    key - 键
    
    value - 值
    
    Returns:
    
    this
  - getFragment
```
public String getFragment()
```
    获取标识符，#后边的部分
    
    Returns:
    
    标识符，例如#后边的部分
  - getFragmentEncoded
```
public String getFragmentEncoded()
```
    获取标识符，#后边的部分
    
    Returns:
    
    标识符，例如#后边的部分
  - setFragment
```
public UrlBuilder setFragment(String fragment)
```
    设置标识符，例如#后边的部分
    
    Parameters:
    
    fragment - 标识符，例如#后边的部分
    
    Returns:
    
    this
  - getCharset
```
public Charset getCharset()
```
    获取编码，用于URLEncode和URLDecode
    
    Returns:
    
    编码
  - setCharset
```
public UrlBuilder setCharset(Charset charset)
```
    设置编码，用于URLEncode和URLDecode
    
    Parameters:
    
    charset - 编码
    
    Returns:
    
    this
  - build
```
public String build()
```
    创建URL字符串
    
    Returns:
    
    URL字符串
  - toURL
```
public URL toURL()
```
    转换为URL 对象
    
    Returns:
    
    URL
  - toURL
```
public URL toURL(URLStreamHandler handler)
```
    转换为URL 对象
    
    Parameters:
    
    handler - URLStreamHandler，null表示默认
    
    Returns:
    
    URL
  - toURI
```
public URI toURI()
```
    转换为URI
    
    Returns:
    
    URI
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class UrlBuilder

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

UrlBuilder

UrlBuilder

Method Detail

of

ofHttpWithoutEncode

ofHttp

of

of

of

of

create

getScheme

getSchemeWithDefault

setScheme

getHost

setHost

getPort

setPort

getAuthority

getPath

getPathStr

setPath

addPath

appendPath

getQuery

getQueryStr

setQuery

addQuery

getFragment

getFragmentEncoded

setFragment

getCharset

setCharset

build

toURL

toURL

toURI

toString