io.netty.resolver.dns

Class DnsServerAddresses

java.lang.Object

io.netty.resolver.dns.DnsServerAddresses

public final class DnsServerAddresses
extends Object

Provides a sequence of DNS server addresses to DnsNameResolver. The Iterator created by the Iterables returned by the factory methods of this class is infinite, which means Iterator.hasNext() will never return false and Iterator.next() will never raise a NoSuchElementException.

Method Summary

Methods

Modifier and Type	Method and Description
static List<InetSocketAddress>	defaultAddresses() Returns the list of the system DNS server addresses.
static Iterable<InetSocketAddress>	rotational(InetSocketAddress... addresses) Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a rotational order.
static Iterable<InetSocketAddress>	rotational(Iterable<? extends InetSocketAddress> addresses) Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a rotational order.
static Iterable<InetSocketAddress>	sequential(InetSocketAddress... addresses) Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a sequential order.
static Iterable<InetSocketAddress>	sequential(Iterable<? extends InetSocketAddress> addresses) Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a sequential order.
static Iterable<InetSocketAddress>	shuffled(InetSocketAddress... addresses) Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a shuffled order.
static Iterable<InetSocketAddress>	shuffled(Iterable<? extends InetSocketAddress> addresses) Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a shuffled order.
static Iterable<InetSocketAddress>	singleton(InetSocketAddress address) Returns an infinite Iterable of the specified DNS server address, whose Iterator always return the same DNS server address.

Methods inherited from class java.lang.Object

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

Method Detail

defaultAddresses

public static List<InetSocketAddress> defaultAddresses()

Returns the list of the system DNS server addresses. If it failed to retrieve the list of the system DNS server addresses from the environment, it will return "8.8.8.8" and "8.8.4.4", the addresses of the Google public DNS servers. Note that the Iterator of the returned list is not infinite unlike other factory methods in this class. To make the returned list infinite, pass it to the other factory method. e.g.

 addresses = sequential(defaultAddresses());
 

sequential

public static Iterable<InetSocketAddress> sequential(Iterable<? extends InetSocketAddress> addresses)

Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a sequential order.

sequential

public static Iterable<InetSocketAddress> sequential(InetSocketAddress... addresses)

Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a sequential order.

shuffled

public static Iterable<InetSocketAddress> shuffled(Iterable<? extends InetSocketAddress> addresses)

Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a shuffled order.

shuffled

public static Iterable<InetSocketAddress> shuffled(InetSocketAddress... addresses)

Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a shuffled order.

rotational

public static Iterable<InetSocketAddress> rotational(Iterable<? extends InetSocketAddress> addresses)

Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a rotational order. It is similar to sequential(Iterable), but each Iterator starts from a different starting point. For example, the first Iterable.iterator() will iterate from the first DNS server address, the second one will iterate from the second DNS server address, and so on.

rotational

public static Iterable<InetSocketAddress> rotational(InetSocketAddress... addresses)

Returns an infinite Iterable of the specified DNS server addresses, whose Iterator iterates the DNS server addresses in a rotational order. It is similar to sequential(Iterable), but each Iterator starts from a different starting point. For example, the first Iterable.iterator() will iterate from the first DNS server address, the second one will iterate from the second DNS server address, and so on.

singleton

public static Iterable<InetSocketAddress> singleton(InetSocketAddress address)

Returns an infinite Iterable of the specified DNS server address, whose Iterator always return the same DNS server address.