Package io.virtdata.util

Class VirtDataResources

  • public class VirtDataResources
extends java.lang.Object

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String DATA_DIR  

    • Method Summary

      Modifier and Type Method Description
      static java.util.Optional<java.nio.file.Path> findOptionalDirPath​(java.lang.String pathName)  
      static java.util.Optional<java.io.Reader> findOptionalReader​(java.lang.String basename, java.lang.String extenion, java.lang.String... searchPaths)  
      static java.util.Optional<java.io.InputStream> findOptionalStreamOrFile​(java.lang.String basename, java.lang.String extension, java.lang.String... searchPaths)  
      static java.nio.file.Path findPathIn​(java.lang.String... pathspecs)
      Look in all the provided path specifiers for an extant Path, and return the first one found.
      static java.io.Reader findRequiredReader​(java.lang.String basename, java.lang.String extension, java.lang.String... searchPaths)  
      static java.io.InputStream findRequiredStreamOrFile​(java.lang.String basename, java.lang.String extension, java.lang.String... searchPaths)  
      static java.util.Optional<java.io.InputStream> getInputStream​(java.lang.String path)  
      static java.util.Optional<java.io.InputStream> getInputStreamForUrl​(java.lang.String path)  
      static java.nio.CharBuffer loadFileToCharBuffer​(java.lang.String filename, java.lang.String... searchPaths)  
      static java.util.List<java.lang.String> readDataFileLines​(java.lang.String basename)  
      static java.lang.String readDataFileString​(java.lang.String basename)  
      static java.nio.CharBuffer readDataFileToCharBuffer​(java.lang.String basename)  
      static org.apache.commons.csv.CSVParser readFileCSV​(java.lang.String basename, java.lang.String... searchPaths)  
      static java.util.List<java.lang.String> readFileLines​(java.lang.String basename, java.lang.String... searchPaths)  
      static java.lang.String readFileString​(java.lang.String basename, java.lang.String... searchPaths)  

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • VirtDataResources

        public VirtDataResources()

    • Method Detail

      • readDataFileToCharBuffer

        public static java.nio.CharBuffer readDataFileToCharBuffer​(java.lang.String basename)

      • readDataFileLines

        public static java.util.List<java.lang.String> readDataFileLines​(java.lang.String basename)

      • readDataFileString

        public static java.lang.String readDataFileString​(java.lang.String basename)

      • findRequiredStreamOrFile

        public static java.io.InputStream findRequiredStreamOrFile​(java.lang.String basename,
                                                           java.lang.String extension,
                                                           java.lang.String... searchPaths)

      • findRequiredReader

        public static java.io.Reader findRequiredReader​(java.lang.String basename,
                                                java.lang.String extension,
                                                java.lang.String... searchPaths)

      • findOptionalReader

        public static java.util.Optional<java.io.Reader> findOptionalReader​(java.lang.String basename,
                                                                    java.lang.String extenion,
                                                                    java.lang.String... searchPaths)

      • findOptionalDirPath

        public static java.util.Optional<java.nio.file.Path> findOptionalDirPath​(java.lang.String pathName)

      • findOptionalStreamOrFile

        public static java.util.Optional<java.io.InputStream> findOptionalStreamOrFile​(java.lang.String basename,
                                                                               java.lang.String extension,
                                                                               java.lang.String... searchPaths)

      • getInputStream

        public static java.util.Optional<java.io.InputStream> getInputStream​(java.lang.String path)

      • getInputStreamForUrl

        public static java.util.Optional<java.io.InputStream> getInputStreamForUrl​(java.lang.String path)

      • readFileLines

        public static java.util.List<java.lang.String> readFileLines​(java.lang.String basename,
                                                             java.lang.String... searchPaths)

      • readFileString

        public static java.lang.String readFileString​(java.lang.String basename,
                                              java.lang.String... searchPaths)

      • readFileCSV

        public static org.apache.commons.csv.CSVParser readFileCSV​(java.lang.String basename,
                                                           java.lang.String... searchPaths)

      • loadFileToCharBuffer

        public static java.nio.CharBuffer loadFileToCharBuffer​(java.lang.String filename,
                                                       java.lang.String... searchPaths)

      • findPathIn

        public static java.nio.file.Path findPathIn​(java.lang.String... pathspecs)

        Look in all the provided path specifiers for an extant Path, and return the first one found.

        If the final character of any path specifier is the default file separator, then the request is for a directory. During searching, if a directory is found when a file is requested, or vice-versa, then an error is thrown withouth looking further.

        The locations that are searched include:

        1. URLs. If the path specifier is a URI, then it is checked for a positive response before the path is returned. URLs can not be used for directories.
        2. The local filesystem, starting from the current directory of the process.
        3. The class path.
        Parameters:
        pathspecs - A specifier for a URL, a directory with a trailing slash, or a file with no trailing slash.
        Returns:
        A Path
        Throws:
        java.lang.RuntimeException - if none of the specified paths is found in any of the locations