Home / Class/ ResolvConf Class — netty Architecture

ResolvConf Class — netty Architecture

Architecture documentation for the ResolvConf class in ResolvConf.java from the netty codebase.

Entity Profile

Dependency Diagram

graph TD
  d7a3abe8_6a1f_bc69_6659_e7c2a9ad8b41["ResolvConf"]
  6af6ec5e_dff7_c270_5843_e94c28d1d31d["ResolvConf.java"]
  d7a3abe8_6a1f_bc69_6659_e7c2a9ad8b41 -->|defined in| 6af6ec5e_dff7_c270_5843_e94c28d1d31d
  8495dcb6_7715_47a5_476c_b504f9fb63ee["ResolvConf()"]
  d7a3abe8_6a1f_bc69_6659_e7c2a9ad8b41 -->|method| 8495dcb6_7715_47a5_476c_b504f9fb63ee
  4fc96aa0_de84_7646_af41_b7ed344f419f["getNameservers()"]
  d7a3abe8_6a1f_bc69_6659_e7c2a9ad8b41 -->|method| 4fc96aa0_de84_7646_af41_b7ed344f419f

Relationship Graph

Source Code

resolver-dns/src/main/java/io/netty/resolver/dns/ResolvConf.java lines 32–112

final class ResolvConf {
    private final List<InetSocketAddress> nameservers;

    /**
     * Reads from the given reader and extracts the {@code nameserver}s using the syntax of the
     * {@code /etc/resolv.conf} file, see {@code man resolv.conf}.
     *
     * @param reader contents of {@code resolv.conf} are read from this {@link BufferedReader},
     *              up to the caller to close it
     */
    static ResolvConf fromReader(BufferedReader reader) throws IOException {
        return new ResolvConf(reader);
    }

    /**
     * Reads the given file and extracts the {@code nameserver}s using the syntax of the
     * {@code /etc/resolv.conf} file, see {@code man resolv.conf}.
     */
    static ResolvConf fromFile(String file) throws IOException {
        // Use 1 MB to be a bit conservative
        try (BufferedReader reader = new BufferedReader(new InputStreamReader(
                new BoundedInputStream(new FileInputStream(file), 1024 * 1024)))) {
            return fromReader(reader);
        }
    }

    /**
     * Returns the {@code nameserver}s from the {@code /etc/resolv.conf} file. The file is only read once
     * during the lifetime of this class.
     */
    static ResolvConf system() {
        ResolvConf resolvConv = ResolvConfLazy.machineResolvConf;
        if (resolvConv != null) {
            return resolvConv;
        }
        throw new IllegalStateException("/etc/resolv.conf could not be read");
    }

    private ResolvConf(BufferedReader reader) throws IOException {
        List<InetSocketAddress> nameservers = new ArrayList<>();
        String ln;
        while ((ln = reader.readLine()) != null) {
            ln = ln.trim();
            if (ln.isEmpty()) {
                continue;
            }

            if (ln.startsWith("nameserver")) {
                ln = ln.substring("nameserver".length());
                int cIndex = ln.indexOf('#');
                if (cIndex != -1) {
                    ln = ln.substring(0, cIndex);
                }
                ln = ln.trim();
                if (ln.isEmpty()) {
                    continue;
                }
                nameservers.add(new InetSocketAddress(ln, 53));
            }
        }
        this.nameservers = Collections.unmodifiableList(nameservers);
    }

    List<InetSocketAddress> getNameservers() {
        return nameservers;
    }

    private static final class ResolvConfLazy {
        static final ResolvConf machineResolvConf;

        static {
            ResolvConf resolvConf;
            try {
                resolvConf = ResolvConf.fromFile("/etc/resolv.conf");
            } catch (IOException | SecurityException e) {
                resolvConf = null;
            }
            machineResolvConf = resolvConf;
        }
    }
}

Frequently Asked Questions

What is the ResolvConf class?
ResolvConf is a class in the netty codebase, defined in resolver-dns/src/main/java/io/netty/resolver/dns/ResolvConf.java.
Where is ResolvConf defined?
ResolvConf is defined in resolver-dns/src/main/java/io/netty/resolver/dns/ResolvConf.java at line 32.

Analyze Your Own Codebase

Get architecture documentation, dependency graphs, and domain analysis for your codebase in minutes.

Try Supermodel Free