| java.lang.Object | |
| ↳ | org.apache.http.conn.routing.RouteTracker | 
Helps tracking the steps in establishing a route.
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 
          | 
        
          
          Creates a new route tracker.
          
         | 
       ||||||||||
| 
          | 
        
          
          Creates a new tracker for the given route.
          
         | 
       ||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 
          | 
        
          
          Creates and returns a copy of this
           
        
           Object
          
          .
          | 
       ||||||||||
| 
          | 
        
          
          Tracks connecting to the first proxy.
          
         | 
       ||||||||||
| 
          | 
        
          
          Tracks connecting to the target.
          
         | 
       ||||||||||
| 
          | 
        
          
          Compares this tracked route to another.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains the number of hops in this route.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains the target of a hop in this route.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains the layering type of this route.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains the local address to connect from.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains the first proxy host.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains the target host.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains the tunnel type of this route.
          
         | 
       ||||||||||
| 
          | 
        
          
          Generates a hash code for this tracked route.
          
         | 
       ||||||||||
| 
          | 
        
          | 
       ||||||||||
| 
          | 
        
          
          Checks whether this route includes a layered protocol.
          
         | 
       ||||||||||
| 
          | 
        
          
          Checks whether this route is secure.
          
         | 
       ||||||||||
| 
          | 
        
          
          Checks whether this route is tunnelled through a proxy.
          
         | 
       ||||||||||
| 
          | 
        
          
          Tracks layering a protocol.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains the tracked route.
          
         | 
       ||||||||||
| 
          | 
        
          
          Obtains a description of the tracked route.
          
         | 
       ||||||||||
| 
          | 
        
          
          Tracks tunnelling to a proxy in a proxy chain.
          
         | 
       ||||||||||
| 
          | 
        
          
          Tracks tunnelling to the target.
          
         | 
       ||||||||||
| 
         
          [Expand]
         
          
          Inherited Methods
          
         | 
       |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
         
           
         
         From class
         
          java.lang.Object
         
          | 
       |||||||||||
         
           
         
         From interface
         
          org.apache.http.conn.routing.RouteInfo
         
          | 
       |||||||||||
Creates a new route tracker. The target and origin need to be specified at creation time.
| target | the host to which to route | 
|---|---|
| local | 
           the local address to route from, or
           
            null
           
           for the default
           | 
         
Creates a new tracker for the given route. Only target and origin are taken from the route, everything else remains to be tracked.
| route | the route to track | 
|---|
         Creates and returns a copy of this
         
          Object
         
         . The default
 implementation returns a so-called "shallow" copy: It creates a new
 instance of the same class and then copies the field values (including
 object references) from this instance to the new instance. A "deep" copy,
 in contrast, would also recursively clone nested objects. A subclass that
 needs to implement this kind of cloning should call
         
          super.clone()
         
         to create the new instance and then create deep copies of the nested,
 mutable objects.
        
| CloneNotSupportedException | 
|---|
Tracks connecting to the first proxy.
| proxy | the proxy connected to | 
|---|---|
| secure | 
           
            true
           
           if the route is secure,
           
            false
           
           otherwise
           | 
         
Tracks connecting to the target.
| secure | 
           
            true
           
           if the route is secure,
           
            false
           
           otherwise
           | 
         
|---|
Compares this tracked route to another.
| o | the object to compare with | 
|---|
           true
          
          if the argument is the same tracked route,
          
           false
          
         Obtains the number of hops in this route. A direct route has one hop. A route through a proxy has two hops. A route through a chain of n proxies has n+1 hops.
         Obtains the target of a hop in this route.
 The target of the last hop is the
         
          
           target host
          
         
         ,
 the target of previous hops is the respective proxy in the chain.
 For a route through exactly one proxy, target of hop 0 is the proxy
 and target of hop 1 is the target host.
        
| hop | index of the hop for which to get the target, 0 for first | 
|---|
Obtains the layering type of this route. In the presence of proxies, only layering over an end-to-end tunnel is considered.
Obtains the local address to connect from.
           null
          
         Obtains the first proxy host.
           null
          
          if this route is direct
         Obtains the target host.
Obtains the tunnel type of this route. If there is a proxy chain, only end-to-end tunnels are considered.
         Generates a hash code for this tracked route.
 Route trackers are modifiable and should therefore not be used
 as lookup keys. Use
         
          
           toRoute
          
         
         to obtain an
 unmodifiable representation of the tracked route.
        
Checks whether this route includes a layered protocol. In the presence of proxies, only layering over an end-to-end tunnel is considered.
           true
          
          if layered,
          
           false
          
          otherwise
         Checks whether this route is secure.
           true
          
          if secure,
          
           false
          
          otherwise
         Checks whether this route is tunnelled through a proxy. If there is a proxy chain, only end-to-end tunnels are considered.
           true
          
          if tunnelled end-to-end through at least
          one proxy,
          
           false
          
          otherwise
         Tracks layering a protocol.
| secure | 
           
            true
           
           if the route is secure,
           
            false
           
           otherwise
           | 
         
|---|
         Obtains the tracked route.
 If a route has been tracked, it is
         
          
           connected
          
         
         .
 If not connected, nothing has been tracked so far.
        
           null
          
          if nothing has been tracked so far
         Obtains a description of the tracked route.
Tracks tunnelling to a proxy in a proxy chain. This will extend the tracked proxy chain, but it does not mark the route as tunnelled. Only end-to-end tunnels are considered there.
| proxy | the proxy tunnelled to | 
|---|---|
| secure | 
           
            true
           
           if the route is secure,
           
            false
           
           otherwise
           | 
         
Tracks tunnelling to the target.
| secure | 
           
            true
           
           if the route is secure,
           
            false
           
           otherwise
           | 
         
|---|