/* * Copyright 2015-2020 the original author or authors * * This software is licensed under the Apache License, Version 2.0, * the GNU Lesser General Public License version 2 or later ("LGPL") * and the WTFPL. * You may choose either license to govern your use of this software only * upon the condition that you accept all of the terms of either * the Apache License 2.0, the LGPL 2.1+ or the WTFPL. */ package org.minidns; import org.minidns.dnsmessage.DnsMessage; import org.minidns.dnsname.DnsName; import org.minidns.dnsqueryresult.CachedDnsQueryResult; import org.minidns.dnsqueryresult.DnsQueryResult; /** * Cache for DNS Entries. Implementations must be thread safe. */ public abstract class DnsCache { public static final int DEFAULT_CACHE_SIZE = 512; /** * Add an an dns answer/response for a given dns question. Implementations * should honor the ttl / receive timestamp. * @param query The query message containing a question. * @param result The DNS query result. */ public final void put(DnsMessage query, DnsQueryResult result) { putNormalized(query.asNormalizedVersion(), result); } protected abstract void putNormalized(DnsMessage normalizedQuery, DnsQueryResult result); public abstract void offer(DnsMessage query, DnsQueryResult result, DnsName authoritativeZone); /** * Request a cached dns response. * @param query The query message containing a question. * @return The dns message. */ public final CachedDnsQueryResult get(DnsMessage query) { return getNormalized(query.asNormalizedVersion()); } protected abstract CachedDnsQueryResult getNormalized(DnsMessage normalizedQuery); }