Related issues: - #3971 - #3973 - #3976 - #4035 Motivation: 1. Previously, DnsNameResolver.query() retried the request query by its own. It prevents a user from deciding when to retry or stop. It is also impossible to get the response object whose code is not NOERROR. 2. NameResolver does not have an operation that resolves a host name into multiple addresses, like InetAddress.getAllByName() Modifications: - Changes related with DnsNameResolver.query() - Make query() not retry - Move the retry logic to DnsNameResolver.resolve() instead. - Make query() fail the promise only when I/O error occurred or it failed to get a response - Add DnsNameResolverException and use it when query() fails so that the resolver can give more information about the failure - query() does not cache anymore. - Changes related with NameResolver.resolveAll() - Add NameResolver.resolveAll() - Add SimpleNameResolver.doResolveAll() - Changes related with DnsNameResolver.resolve() and resolveAll() - Make DnsNameResolveContext abstract so that DnsNameResolver can decide to get single or multiple addresses from it - Re-implement cache so that the cache works for resolve() and resolveAll() - Add 'traceEnabled' property to enable/disable trace information - Miscellaneous changes - Use ObjectUtil.checkNotNull() wherever possible - Add InternetProtocolFamily.addressType() to remove repetitive switch-case blocks in DnsNameResolver(Context) - Do not raise an exception when decoding a truncated DNS response Result: - Full control over query() - A user can now retrieve all addresses via (Dns)NameResolver.resolveAll() - DNS cache works only for resolve() and resolveAll() now.
77 lines
2.1 KiB
Java
77 lines
2.1 KiB
Java
/*
|
|
* Copyright 2015 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.channel.EventLoop;
|
|
import io.netty.util.concurrent.ScheduledFuture;
|
|
|
|
import java.net.InetAddress;
|
|
import java.util.concurrent.TimeUnit;
|
|
|
|
final class DnsCacheEntry {
|
|
|
|
private final String hostname;
|
|
private final InetAddress address;
|
|
private final Throwable cause;
|
|
private volatile ScheduledFuture<?> expirationFuture;
|
|
|
|
DnsCacheEntry(String hostname, InetAddress address) {
|
|
this.hostname = hostname;
|
|
this.address = address;
|
|
cause = null;
|
|
}
|
|
|
|
DnsCacheEntry(String hostname, Throwable cause) {
|
|
this.hostname = hostname;
|
|
this.cause = cause;
|
|
address = null;
|
|
}
|
|
|
|
String hostname() {
|
|
return hostname;
|
|
}
|
|
|
|
InetAddress address() {
|
|
return address;
|
|
}
|
|
|
|
Throwable cause() {
|
|
return cause;
|
|
}
|
|
|
|
void scheduleExpiration(EventLoop loop, Runnable task, long delay, TimeUnit unit) {
|
|
assert expirationFuture == null: "expiration task scheduled already";
|
|
expirationFuture = loop.schedule(task, delay, unit);
|
|
}
|
|
|
|
void cancelExpiration() {
|
|
ScheduledFuture<?> expirationFuture = this.expirationFuture;
|
|
if (expirationFuture != null) {
|
|
expirationFuture.cancel(false);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public String toString() {
|
|
if (cause != null) {
|
|
return hostname + '/' + cause;
|
|
} else {
|
|
return address.toString();
|
|
}
|
|
}
|
|
}
|