org.apache.http.conn.routing

Class HttpRoute

java.lang.Object

org.apache.http.conn.routing.HttpRoute

All Implemented Interfaces:

Cloneable ， RouteInfo

@Contract(threading=IMMUTABLE)
public final class HttpRoute
extends Object
implements RouteInfo, Cloneable

请求的路由。

从以下版本开始：

4

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.http.conn.routing.RouteInfo

RouteInfo.LayerType, RouteInfo.TunnelType

构造方法摘要

构造方法

Constructor and Description
HttpRoute(HttpHost target) 创造一个新的直接不安全的路线。
HttpRoute(HttpHost target, HttpHost proxy) 通过代理创建新的简单路由。
HttpRoute(HttpHost target, InetAddress local, boolean secure) 创建一条新的直达路线。
HttpRoute(HttpHost target, InetAddress local, HttpHost[] proxies, boolean secure, RouteInfo.TunnelType tunnelled, RouteInfo.LayerType layered) 创建一个具有明确指定的所有属性的新路由。
HttpRoute(HttpHost target, InetAddress local, HttpHost proxy, boolean secure) 通过代理创建新路由。
HttpRoute(HttpHost target, InetAddress local, HttpHost proxy, boolean secure, RouteInfo.TunnelType tunnelled, RouteInfo.LayerType layered) 创建一个最多一个代理的新路由。

方法摘要

Methods

Modifier and Type	Method and Description
Object	clone()
boolean	equals(Object obj) 将此路由与另一路径进行比较。
int	getHopCount() 获取此路由中的跳数。
HttpHost	getHopTarget(int hop) 获得这条路线中的跳跃目标。
RouteInfo.LayerType	getLayerType() 获取此路由的分层类型。
InetAddress	getLocalAddress() 获取要连接的本地地址。
InetSocketAddress	getLocalSocketAddress()
HttpHost	getProxyHost() 获取第一个代理主机。
HttpHost	getTargetHost() 获取目标主机。
RouteInfo.TunnelType	getTunnelType() 获取此路由的隧道类型。
int	hashCode() 生成此路由的哈希码。
boolean	isLayered() 检查此路由是否包含分层协议。
boolean	isSecure() 检查这条路线是否安全。
boolean	isTunnelled() 检查此路由是否通过代理隧道通过。
String	toString() 获取此路线的描述。

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

构造方法详细信息

HttpRoute

public HttpRoute(HttpHost target,
         InetAddress local,
         HttpHost[] proxies,
         boolean secure,
         RouteInfo.TunnelType tunnelled,
         RouteInfo.LayerType layered)

创建一个具有明确指定的所有属性的新路由。

参数

target - 要路由的主机

local - 要路由的本地地址，或 null为 null

proxies - 要使用的代理链，或 null用于直接路由

secure - true如果路由是（待）安全的， false否则

tunnelled - 此路由的隧道类型

layered - 此路由的分层类型

HttpRoute

public HttpRoute(HttpHost target,
         InetAddress local,
         HttpHost proxy,
         boolean secure,
         RouteInfo.TunnelType tunnelled,
         RouteInfo.LayerType layered)

创建一个最多一个代理的新路由。

参数

target - 要路由的主机

local - 要路由的本地地址，或 null为 null

proxy - 要使用的代理，或 null直接路由

secure - true如果路由是（待）安全的， false否则

tunnelled - true如果路由是（将被）通过代理隧道， false否则

layered - true如果路由包含分层协议， false否则

HttpRoute

public HttpRoute(HttpHost target,
         InetAddress local,
         boolean secure)

创建一条新的直达路线。 这是没有代理的路由。

参数

target - 要路由的主机

local - 要路由的本地地址，或 null为 null

secure - true如果路由是（待）安全的， false否则

HttpRoute

public HttpRoute(HttpHost target)

创造一个新的直接不安全的路线。

参数

target - 要路由的主机

HttpRoute

public HttpRoute(HttpHost target,
         InetAddress local,
         HttpHost proxy,
         boolean secure)

通过代理创建新路由。 当使用这个构造函数时，必须给出proxy 。 为了方便起见，假设安全连接将通过代理在隧道上分层。

参数

target - 要路由的主机

local - 要路由的本地地址，或 null为 null

proxy - 要使用的代理

secure - true如果路由是（待）安全的， false否则

HttpRoute

public HttpRoute(HttpHost target,
         HttpHost proxy)

通过代理创建新的简单路由。

参数

target - 要路由的主机

proxy - 代理使用

从以下版本开始：

4.3

方法详细信息

getTargetHost

public final HttpHost getTargetHost()

描述从接口RouteInfo复制

获取目标主机。

Specified by:

getTargetHost在接口 RouteInfo

结果

目标主机

getLocalAddress

public final InetAddress getLocalAddress()

描述从接口RouteInfo复制

获取要连接的本地地址。

Specified by:

getLocalAddress在接口 RouteInfo

结果

本地地址，或 null

getLocalSocketAddress

public final InetSocketAddress getLocalSocketAddress()

getHopCount

public final int getHopCount()

描述从接口RouteInfo复制

获取此路由中的跳数。 直达路线有一跳。 通过代理的路由有两个跳。 通过n个代理链的路线具有n + 1跳。

Specified by:

getHopCount在接口 RouteInfo

结果

这条路线中的跳数

getHopTarget

public final HttpHost getHopTarget(int hop)

描述从接口RouteInfo复制

获得这条路线中的跳跃目标。 最后一跳的目标是target host ，以前的啤酒花的目标是链中的相应代理。 对于通过一个代理的路由，跳转目标0是代理，跳1的目标是目标主机。

Specified by:

getHopTarget在接口 RouteInfo

参数

hop - 获取目标的跳数索引，第一个为0

结果

给定跳的目标

getProxyHost

public final HttpHost getProxyHost()

描述从接口RouteInfo复制

获取第一个代理主机。

Specified by:

getProxyHost在接口 RouteInfo

结果

代理链中的第一个代理，或 null如果此路由是直接的

getTunnelType

public final RouteInfo.TunnelType getTunnelType()

描述从接口RouteInfo复制

获取此路由的隧道类型。 如果有代理链，则只考虑端到端隧道。

Specified by:

getTunnelType在接口 RouteInfo

结果

隧道式

isTunnelled

public final boolean isTunnelled()

描述从接口RouteInfo复制

检查此路由是否通过代理隧道通过。 如果有代理链，则只考虑端到端隧道。

Specified by:

isTunnelled在接口 RouteInfo

结果

true如果通过至少一个代理端到端隧道， false否则

getLayerType

public final RouteInfo.LayerType getLayerType()

描述从接口RouteInfo复制

获取此路由的分层类型。 在代理存在的情况下，仅考虑端到端隧道的分层。

Specified by:

getLayerType在接口 RouteInfo

结果

分层类型

isLayered

public final boolean isLayered()

描述从接口RouteInfo复制

检查此路由是否包含分层协议。 在代理存在的情况下，仅考虑端到端隧道的分层。

Specified by:

isLayered在接口 RouteInfo

结果

true如果分层， false否则

isSecure

public final boolean isSecure()

描述从接口RouteInfo复制

检查这条路线是否安全。

Specified by:

isSecure在接口 RouteInfo

结果

true如果安全， false否则

equals

public final boolean equals(Object obj)

将此路由与另一路径进行比较。

重写：

equals在 Object类

参数

obj - 要比较的对象

结果

true如果参数是相同的路由， false

hashCode

public final int hashCode()

生成此路由的哈希码。

重写：

hashCode在 Object类

结果

哈希码

toString

public final String toString()

获取此路线的描述。

重写：

toString在 Object

结果

这条路线的人类可读表示

clone

public Object clone()
             throws CloneNotSupportedException

重写：

clone在 Object

异常

CloneNotSupportedException