com.atlassian.httpclient.apache.httpcomponents

Class BannedHostResolver

java.lang.Object

com.atlassian.httpclient.apache.httpcomponents.BannedHostResolver

All Implemented Interfaces:

HostResolver

public class BannedHostResolver
extends Object
implements HostResolver

Banned host resolver can be used to restrict the IPs that a host may resolve to. When utilised in a http client each call will at some point will pass the endpoint to connect to through the resolve(String) method.

This implementation will throw an exception if it receives a host that resolves to an IP in the restricted list.

Do note, that even if a specific IP is to be connected to, the IP will still be resolved through this class and eventually be blocked if required.

Constructor Summary

Constructors

Constructor and Description
BannedHostResolver(List<String> bannedCidrs)

Method Summary

Modifier and Type	Method and Description
InetAddress[]	resolve(String host) Get an array of IP addresses for a host

Methods inherited from class java.lang.Object

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

Constructor Detail

BannedHostResolver

public BannedHostResolver(List<String> bannedCidrs)

Parameters:

bannedCidrs - list of cidrs to block from resolving

Method Detail

resolve

public InetAddress[] resolve(String host)
                      throws UnknownHostException

Description copied from interface: HostResolver

Get an array of IP addresses for a host

Specified by:

resolve in interface HostResolver

Parameters:

host - host to get ip for. Can just be an ip itself

Returns:

resolved addresses for the host

Throws:

UnknownHostException - if the host cannot be found, or BannedHostException if the ip is blacklisted