Class HostsFileParser


  • public final class HostsFileParser
    extends java.lang.Object
    A parser for hosts files. The produced mappings contain only the first entry per hostname. Consider using HostsFileEntriesProvider when mappings with all entries per hostname are needed.
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static HostsFileEntries parse()
      Parse hosts file at standard OS location using the system default Charset for decoding.
      static HostsFileEntries parse​(java.io.File file)
      Parse a hosts file using the system default Charset for decoding.
      static HostsFileEntries parse​(java.io.File file, java.nio.charset.Charset... charsets)
      Parse a hosts file.
      static HostsFileEntries parse​(java.io.Reader reader)
      Parse a reader of hosts file format.
      static HostsFileEntries parseSilently()
      Parse hosts file at standard OS location using the systems default Charset for decoding.
      static HostsFileEntries parseSilently​(java.nio.charset.Charset... charsets)
      Parse hosts file at standard OS location using the given Charsets one after each other until we were able to parse something or none is left.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • parseSilently

        public static HostsFileEntries parseSilently()
        Parse hosts file at standard OS location using the systems default Charset for decoding.
        Returns:
        a HostsFileEntries
      • parseSilently

        public static HostsFileEntries parseSilently​(java.nio.charset.Charset... charsets)
        Parse hosts file at standard OS location using the given Charsets one after each other until we were able to parse something or none is left.
        Parameters:
        charsets - the Charsets to try as file encodings when parsing.
        Returns:
        a HostsFileEntries
      • parse

        public static HostsFileEntries parse()
                                      throws java.io.IOException
        Parse hosts file at standard OS location using the system default Charset for decoding.
        Returns:
        a HostsFileEntries
        Throws:
        java.io.IOException - file could not be read
      • parse

        public static HostsFileEntries parse​(java.io.File file)
                                      throws java.io.IOException
        Parse a hosts file using the system default Charset for decoding.
        Parameters:
        file - the file to be parsed
        Returns:
        a HostsFileEntries
        Throws:
        java.io.IOException - file could not be read
      • parse

        public static HostsFileEntries parse​(java.io.File file,
                                             java.nio.charset.Charset... charsets)
                                      throws java.io.IOException
        Parse a hosts file.
        Parameters:
        file - the file to be parsed
        charsets - the Charsets to try as file encodings when parsing.
        Returns:
        a HostsFileEntries
        Throws:
        java.io.IOException - file could not be read
      • parse

        public static HostsFileEntries parse​(java.io.Reader reader)
                                      throws java.io.IOException
        Parse a reader of hosts file format.
        Parameters:
        reader - the file to be parsed
        Returns:
        a HostsFileEntries
        Throws:
        java.io.IOException - file could not be read