DefaultDnsOptEcsRecord Class — netty Architecture

Source Code

codec-dns/src/main/java/io/netty/handler/codec/dns/DefaultDnsOptEcsRecord.java lines 28–128

public final class DefaultDnsOptEcsRecord extends AbstractDnsOptPseudoRrRecord implements DnsOptEcsRecord {
    private final int srcPrefixLength;
    private final byte[] address;

    /**
     * Creates a new instance.
     *
     * @param maxPayloadSize the suggested max payload size in bytes
     * @param extendedRcode the extended rcode
     * @param version the version
     * @param srcPrefixLength the prefix length
     * @param address the bytes of the {@link InetAddress} to use
     */
    public DefaultDnsOptEcsRecord(int maxPayloadSize, int extendedRcode, int version,
                                  int srcPrefixLength, byte[] address) {
        super(maxPayloadSize, extendedRcode, version);
        this.srcPrefixLength = srcPrefixLength;
        this.address = verifyAddress(address).clone();
    }

    /**
     * Creates a new instance.
     *
     * @param maxPayloadSize the suggested max payload size in bytes
     * @param srcPrefixLength the prefix length
     * @param address the bytes of the {@link InetAddress} to use
     */
    public DefaultDnsOptEcsRecord(int maxPayloadSize, int srcPrefixLength, byte[] address) {
        this(maxPayloadSize, 0, 0, srcPrefixLength, address);
    }

    /**
     * Creates a new instance.
     *
     * @param maxPayloadSize    the suggested max payload size in bytes
     * @param protocolFamily    the {@link InternetProtocolFamily} to use. This should be the same as the one used to
     *                          send the query.
     * @deprecated              use {@link DefaultDnsOptEcsRecord#DefaultDnsOptEcsRecord(int, SocketProtocolFamily)}
     */
    @Deprecated
    public DefaultDnsOptEcsRecord(int maxPayloadSize, InternetProtocolFamily protocolFamily) {
        this(maxPayloadSize, 0, 0, 0, protocolFamily.localhost().getAddress());
    }

    /**
     * Creates a new instance.
     *
     * @param maxPayloadSize        the suggested max payload size in bytes
     * @param socketProtocolFamily  the {@link SocketProtocolFamily} to use. This should be the same as the one used to
     *                              send the query.
     */
    public DefaultDnsOptEcsRecord(int maxPayloadSize, SocketProtocolFamily socketProtocolFamily) {
        this(maxPayloadSize, 0, 0, 0, localAddress(socketProtocolFamily));
    }

    private static byte[] localAddress(SocketProtocolFamily family) {
        switch (family) {
            case INET:
                return NetUtil.LOCALHOST4.getAddress();
            case INET6:
                return NetUtil.LOCALHOST6.getAddress();
            default:
                return null;
        }
    }

    private static byte[] verifyAddress(byte[] bytes) {
        if (bytes != null && bytes.length == 4 || bytes.length == 16) {
            return bytes;
        }
        throw new IllegalArgumentException("bytes.length must either 4 or 16");
    }

    @Override
    public int sourcePrefixLength() {
        return srcPrefixLength;
    }

    @Override
    public int scopePrefixLength() {
        return 0;