211dde4e08
Motivation: Sometimes DNS responses can be very large which mean they will not fit in a UDP packet. When this is happening the DNS server will set the TC flag (truncated flag) to tell the resolver that the response was truncated. When a truncated response was received we should allow to retry via TCP and use the received response (if possible) as a replacement for the truncated one. See https://tools.ietf.org/html/rfc7766. Modifications: - Add support for TCP fallback by allow to specify a socketChannelFactory / socketChannelType on the DnsNameResolverBuilder. If this is set to something different then null we will try to fallback to TCP. - Add decoder / encoder for TCP - Add unit tests Result: Support for TCP fallback as defined by https://tools.ietf.org/html/rfc7766 when using DnsNameResolver.
65 lines
2.2 KiB
Java
65 lines
2.2 KiB
Java
/*
|
|
* Copyright 2019 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.handler.codec.dns;
|
|
|
|
import io.netty.buffer.ByteBuf;
|
|
import io.netty.channel.ChannelHandler;
|
|
import io.netty.channel.ChannelHandlerContext;
|
|
import io.netty.handler.codec.MessageToByteEncoder;
|
|
import io.netty.util.internal.UnstableApi;
|
|
|
|
@ChannelHandler.Sharable
|
|
@UnstableApi
|
|
public final class TcpDnsQueryEncoder extends MessageToByteEncoder<DnsQuery> {
|
|
|
|
private final DnsQueryEncoder encoder;
|
|
|
|
/**
|
|
* Creates a new encoder with {@linkplain DnsRecordEncoder#DEFAULT the default record encoder}.
|
|
*/
|
|
public TcpDnsQueryEncoder() {
|
|
this(DnsRecordEncoder.DEFAULT);
|
|
}
|
|
|
|
/**
|
|
* Creates a new encoder with the specified {@code recordEncoder}.
|
|
*/
|
|
public TcpDnsQueryEncoder(DnsRecordEncoder recordEncoder) {
|
|
this.encoder = new DnsQueryEncoder(recordEncoder);
|
|
}
|
|
|
|
@Override
|
|
protected void encode(ChannelHandlerContext ctx, DnsQuery msg, ByteBuf out) throws Exception {
|
|
// Length is two octets as defined by RFC-7766
|
|
// See https://tools.ietf.org/html/rfc7766#section-8
|
|
out.writerIndex(out.writerIndex() + 2);
|
|
encoder.encode(msg, out);
|
|
|
|
// Now fill in the correct length based on the amount of data that we wrote the ByteBuf.
|
|
out.setShort(0, out.readableBytes() - 2);
|
|
}
|
|
|
|
@Override
|
|
protected ByteBuf allocateBuffer(ChannelHandlerContext ctx, @SuppressWarnings("unused") DnsQuery msg,
|
|
boolean preferDirect) {
|
|
if (preferDirect) {
|
|
return ctx.alloc().ioBuffer(1024);
|
|
} else {
|
|
return ctx.alloc().heapBuffer(1024);
|
|
}
|
|
}
|
|
}
|