5a2d04684e
Motivation: A single DNS query may follow many different paths through resolver-dns. The query may fail for various reasons related to the DNS protocol, general IO errors, it may be cancelled due to the query count being exceeded, or other reasons. A query may also result in other queries as we follow the DNS protocol (e.g. redirects, CNAME, etc...). It is currently impossible to collect information about the life cycle of an individual query though resolver-dns. This information may be valuable when considering which DNS servers are preferred over others. Modifications: - Introduce an interface which can provide visibility into all the potential outcomes of an individual DNS query Result: resolver-dns provides visibility into individual DNS queries which can be used to avoid poorly performing DNS servers.
33 lines
1.2 KiB
Java
33 lines
1.2 KiB
Java
/*
|
|
* Copyright 2017 The Netty Project
|
|
*
|
|
* The Netty Project licenses this file to you under the Apache License,
|
|
* version 2.0 (the "License"); you may not use this file except in compliance
|
|
* with the License. You may obtain a copy of the License at:
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*/
|
|
package io.netty.resolver.dns;
|
|
|
|
import io.netty.handler.codec.dns.DnsQuestion;
|
|
import io.netty.util.internal.UnstableApi;
|
|
|
|
/**
|
|
* Used to generate new instances of {@link DnsQueryLifecycleObserver}.
|
|
*/
|
|
@UnstableApi
|
|
public interface DnsQueryLifecycleObserverFactory {
|
|
/**
|
|
* Create a new instance of a {@link DnsQueryLifecycleObserver}. This will be called at the start of a new query.
|
|
* @param question The question being asked.
|
|
* @return a new instance of a {@link DnsQueryLifecycleObserver}.
|
|
*/
|
|
DnsQueryLifecycleObserver newDnsQueryLifecycleObserver(DnsQuestion question);
|
|
}
|