UrlBuilder (hutool-core 5.3.3 API)

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

所有已实现的接口:: 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]

从以下版本开始:: 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(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协议对待。
`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` 对象

从类继承的方法 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
- 方法详细资料
  - of
```
public static UrlBuilder of(URI uri,
                            Charset charset)
```
    使用URI构建UrlBuilder
    
    参数:
    
    uri - URI
    
    charset - 编码，用于URLEncode和URLDecode
    
    返回:
    
    UrlBuilder
  - 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,
                            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
```
public static UrlBuilder create()
```
    创建空的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
  - 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
  - setPath
```
public UrlBuilder setPath(UrlPath path)
```
    设置路径，例如/aa/bb/cc，将覆盖之前所有的path相关设置
    
    参数:
    
    path - 路径，例如/aa/bb/cc
    
    返回:
    
    this
  - addPath
```
public UrlBuilder addPath(String segment)
```
    增加路径节点
    
    参数:
    
    segment - 路径节点
    
    返回:
    
    this
  - appendPath
```
public UrlBuilder appendPath(CharSequence segment)
```
    追加path节点
    
    参数:
    
    segment - path节点
    
    返回:
    
    this
  - getQuery
```
public UrlQuery getQuery()
```
    获取查询语句，例如a=1&b=2
    
    返回:
    
    查询语句，例如a=1&b=2
  - 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,
                           String 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字符串
    
    返回:
    
    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

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