io.netty.resolver.dns

接口 DnsCache

所有已知实现类:

DefaultDnsCache, NoopDnsCache

public interface DnsCache

A cache for DNS resolution entries.

方法概要

限定符和类型	方法和说明
DnsCacheEntry	cache(java.lang.String hostname, DnsRecord[] additionals, java.net.InetAddress address, long originalTtl, EventLoop loop) Create a new DnsCacheEntry and cache a resolved address for a given hostname.
DnsCacheEntry	cache(java.lang.String hostname, DnsRecord[] additionals, java.lang.Throwable cause, EventLoop loop) Cache the resolution failure for a given hostname.
void	clear() Clears all the resolved addresses cached by this resolver.
boolean	clear(java.lang.String hostname) Clears the resolved addresses of the specified host name from the cache of this resolver.
java.util.List<? extends DnsCacheEntry>	get(java.lang.String hostname, DnsRecord[] additionals) Return the cached entries for the given hostname.

方法详细资料

clear

void clear()

Clears all the resolved addresses cached by this resolver.

另请参阅:

clear(String)

clear

boolean clear(java.lang.String hostname)

Clears the resolved addresses of the specified host name from the cache of this resolver.

返回:

true if and only if there was an entry for the specified host name in the cache and it has been removed by this method

get

java.util.List<? extends DnsCacheEntry> get(java.lang.String hostname,
                                            DnsRecord[] additionals)

Return the cached entries for the given hostname.

参数:

hostname - the hostname

additionals - the additional records

返回:

the cached entries

cache

DnsCacheEntry cache(java.lang.String hostname,
                    DnsRecord[] additionals,
                    java.net.InetAddress address,
                    long originalTtl,
                    EventLoop loop)

Create a new DnsCacheEntry and cache a resolved address for a given hostname.

参数:

hostname - the hostname

additionals - the additional records

address - the resolved address

originalTtl - the TTL as returned by the DNS server

loop - the EventLoop used to register the TTL timeout

返回:

The DnsCacheEntry corresponding to this cache entry.

cache

DnsCacheEntry cache(java.lang.String hostname,
                    DnsRecord[] additionals,
                    java.lang.Throwable cause,
                    EventLoop loop)

Cache the resolution failure for a given hostname. Be aware this won't be called with timeout / cancel / transport exceptions.

参数:

hostname - the hostname

additionals - the additional records

cause - the resolution failure

loop - the EventLoop used to register the TTL timeout

返回:

The DnsCacheEntry corresponding to this cache entry, or null if this cache doesn't support caching failed responses.