org.apache.http.client.utils

Class URIUtils

java.lang.Object

org.apache.http.client.utils.URIUtils

public class URIUtils
extends Object

用于URIs的实用程序的集合 ，用于解决课堂内的解决方法错误或易于使用的功能。

从以下版本开始：

4

方法摘要

Methods

Modifier and Type	Method and Description
static URI	createURI(String scheme, String host, int port, String path, String query, String fragment) 已过时。 （4.2）使用URIBuilder 。
static HttpHost	extractHost(URI uri) 从给定的URI提取目标主机。
static URI	resolve(URI originalURI, HttpHost target, List<URI> redirects) 导出用于生成最后一个请求的解释（绝对）URI。
static URI	resolve(URI baseURI, String reference) 针对基本URI解析URI引用。
static URI	resolve(URI baseURI, URI reference) 针对基本URI解析URI引用。
static URI	rewriteURI(URI uri) 创建新的URI的方便方法，其方案，主机，端口，路径，查询取自现有的URI，丢弃任何片段或用户信息。
static URI	rewriteURI(URI uri, HttpHost target) rewriteURI(URI, HttpHost, boolean)的方便方法，始终保持片段。
static URI	rewriteURI(URI uri, HttpHost target, boolean dropFragment) 一种方便的方法，用于创建一个新的URI，其方案，主机和端口取自目标主机，但其路径，查询和片段从现有URI中获取。
static URI	rewriteURIForRoute(URI uri, RouteInfo route) 一种方便的方法，可以将原始的URI转换为指定路由所要求的相对或绝对形式。

Methods inherited from class java.lang.Object

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

方法详细信息

createURI

@Deprecated
public static URI createURI(String scheme,
                       String host,
                       int port,
                       String path,
                       String query,
                       String fragment)
                     throws URISyntaxException

已过时。 （4.2）使用URIBuilder 。

使用所有参数构造URI 。 应该使用这个代替URI.URI(String, String, String, int, String, String, String)或任何其他URI多参数URI构造函数。

参数

scheme - 方案名称

host - 主机名

port - 端口号

path - 路径

query - 查询

fragment - 片段

异常

URISyntaxException - 如果给定方案和路径，但路径是相对的，如果从给定组件构造的URI字符串违反RFC 2396，或者如果字符串的权限组件存在但不能被解析为基于服务器的权限

rewriteURI

public static URI rewriteURI(URI uri,
             HttpHost target,
             boolean dropFragment)
                      throws URISyntaxException

一种方便的方法，用于创建一个新的URI，其方案，主机和端口是从目标主机获取的，但是其路径，查询和片段是从现有URI中获取的。 仅当dropFragment为false时才使用该片段。 如果未明确指定路径，则设置为“/”。

参数

uri - 包含要使用的路径，查询和片段。

target - 包含要使用的方案，主机和端口。

dropFragment - 如果片段不被复制， dropFragment真。

异常

URISyntaxException - 如果生成的URI无效。

rewriteURI

public static URI rewriteURI(URI uri,
             HttpHost target)
                      throws URISyntaxException

rewriteURI(URI, HttpHost, boolean)的方便方法，始终保持片段。

异常

URISyntaxException

rewriteURI

public static URI rewriteURI(URI uri)
                      throws URISyntaxException

创建一个新的URI的方法，其方案，主机，端口，路径，查询取自现有的URI，丢弃任何片段或用户信息。 如果未明确指定路径，则设置为“/”。 如果现有URI没有片段或用户信息，并且具有路径，那么它将被未修改地返回。

参数

uri - 原始URI。

异常

URISyntaxException - 如果生成的URI无效。

rewriteURIForRoute

public static URI rewriteURIForRoute(URI uri,
                     RouteInfo route)
                              throws URISyntaxException

一种方便的方法，可以将原始的URI转换为指定路由所要求的相对或绝对形式。

参数

uri - 原始URI。

异常

URISyntaxException - 如果生成的URI无效。

从以下版本开始：

4.4

resolve

public static URI resolve(URI baseURI,
          String reference)

针对基本URI解析URI引用。 解决java.net.URI中的错误（http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4708535）

参数

baseURI - 基本URI

reference - URI引用

结果

生成的URI

resolve

public static URI resolve(URI baseURI,
          URI reference)

针对基本URI解析URI引用。 解决java.net.URI中的错误（例如http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4708535）

参数

baseURI - 基本URI

reference - URI引用

结果

生成的URI

extractHost

public static HttpHost extractHost(URI uri)

从给定的URI中提取目标主机。

参数

uri -

结果

如果URI是绝对的，则是目标主机，如果URI是相对的或不包含有效的主机名， null 。

从以下版本开始：

4.1

resolve

public static URI resolve(URI originalURI,
          HttpHost target,
          List<URI> redirects)
                   throws URISyntaxException

导出用于生成最后一个请求的解释（绝对）URI。 这是通过提取最后一个请求的请求uri和目标源，并扫描最后一个片段标识符的所有重定向位置，然后将结果合并成URI 。

参数

originalURI - 任何重定向之前的原始请求

target - 如果最后一个URI是相对的，则会针对该目标进行解析，如果不可用， null 。

redirects - 自原始请求以来的重定向位置的收集或 null如果不可用）。

结果

解释（绝对）URI

异常

URISyntaxException