Package com.linecorp.armeria.client

Interface DnsCache

@UnstableApi
public interface DnsCache

A cache for DNS responses.

Method Summary

Modifier and Type	Method	Description
void	addListener(DnsCacheListener listener)	Adds a listener to this DnsCache.
static DnsCacheBuilder	builder()	Returns a new DnsCacheBuilder.
default void	cache(DnsQuestion question, DnsRecord... records)	Caches a successful resolution.
void	cache(DnsQuestion question, Iterable<? extends DnsRecord> records)	Caches a successful resolution.
void	cache(DnsQuestion question, UnknownHostException cause)	Caches a failed resolution.
@Nullable List<DnsRecord>	get(DnsQuestion question)	Returns the DnsRecords associated with the DnsQuestion in this cache.
static DnsCache	of(String cacheSpec)	Returns a newly-created DnsCache using the specified cacheSpec.
static DnsCache	ofDefault()	Returns the default DNS cache.
void	remove(DnsQuestion question)	Discards any cached value for the hostname.
void	removeAll()	Discards all entries in this cache.

Method Details

ofDefault

static DnsCache ofDefault()

Returns the default DNS cache.

of

static DnsCache of(String cacheSpec)

Returns a newly-created DnsCache using the specified cacheSpec.

builder

static DnsCacheBuilder builder()

Returns a new DnsCacheBuilder.

cache

default void cache(DnsQuestion question,
 DnsRecord... records)

Caches a successful resolution.

Parameters:

question - the DNS question.

records - the DNS records associated to the given DnsQuestion.

cache

void cache(DnsQuestion question,
 Iterable<? extends DnsRecord> records)

Caches a successful resolution.

Parameters:

question - the DNS question.

records - the DNS records associated to the given DnsQuestion.

cache

void cache(DnsQuestion question,
 UnknownHostException cause)

Caches a failed resolution.

Parameters:

question - the DNS question.

cause - the resolution failure.

get

@Nullable
@Nullable List<DnsRecord> get(DnsQuestion question)
                       throws UnknownHostException

Returns the DnsRecords associated with the DnsQuestion in this cache. null if this cache contains no resolution for the DnsQuestion.

Throws:

UnknownHostException - if the DnsQuestion previously failed with the UnknownHostException and its negative TTL is valid.

remove

void remove(DnsQuestion question)

Discards any cached value for the hostname.

removeAll

void removeAll()

Discards all entries in this cache.

addListener

void addListener(DnsCacheListener listener)

Adds a listener to this DnsCache. The DnsCacheListener is notified whenever an event occurs.