Class GridFilesystem


  • @Deprecated
    public class GridFilesystem
    extends Object
    Deprecated.
    since 10.0
    Entry point for GridFile and GridInputStream / GridOutputStream
    Author:
    Bela Ban, Marko Luksa
    • Field Detail

      • data

        protected final Cache<String,​byte[]> data
        Deprecated.
      • defaultChunkSize

        protected final int defaultChunkSize
        Deprecated.
    • Constructor Detail

      • GridFilesystem

        public GridFilesystem​(Cache<String,​byte[]> data,
                              Cache<String,​GridFile.Metadata> metadata,
                              int defaultChunkSize)
        Deprecated.
        Creates an instance. The data and metadata caches should already have been setup and started
        Parameters:
        data - the cache where the actual file contents are stored
        metadata - the cache where file meta-data is stored
        defaultChunkSize - the default size of the file chunks
    • Method Detail

      • getFile

        public File getFile​(String pathname)
        Deprecated.
        Returns the file denoted by pathname.
        Parameters:
        pathname - the full path of the requested file
        Returns:
        the File stored at pathname
      • getFile

        public File getFile​(String pathname,
                            int chunkSize)
        Deprecated.
        Returns the file denoted by pathname. If the file does not yet exist, it is initialized with the given chunkSize. However, if the file at pathname already exists, the chunkSize parameter is ignored and the file's actual chunkSize is used.
        Parameters:
        pathname - the full path of the requested file
        chunkSize - the size of the file's chunks. This parameter is only used for non-existing files.
        Returns:
        the File stored at pathname
      • getFile

        public File getFile​(String parent,
                            String child,
                            int chunkSize)
        Deprecated.
      • getFile

        public File getFile​(File parent,
                            String child)
        Deprecated.
      • getFile

        public File getFile​(File parent,
                            String child,
                            int chunkSize)
        Deprecated.
      • getOutput

        public OutputStream getOutput​(String pathname)
                               throws IOException
        Deprecated.
        Opens an OutputStream for writing to the file denoted by pathname. If a file at pathname already exists, writing to the returned OutputStream will overwrite the contents of the file.
        Parameters:
        pathname - the path to write to
        Returns:
        an OutputStream for writing to the file at pathname
        Throws:
        IOException - if an error occurs
      • getOutput

        public OutputStream getOutput​(String pathname,
                                      boolean append)
                               throws IOException
        Deprecated.
        Opens an OutputStream for writing to the file denoted by pathname. The OutputStream can either overwrite the existing file or append to it.
        Parameters:
        pathname - the path to write to
        append - if true, the bytes written to the OutputStream will be appended to the end of the file. If false, the bytes will overwrite the original contents.
        Returns:
        an OutputStream for writing to the file at pathname
        Throws:
        IOException - if an error occurs
      • getOutput

        public OutputStream getOutput​(String pathname,
                                      boolean append,
                                      int chunkSize)
                               throws IOException
        Deprecated.
        Opens an OutputStream for writing to the file denoted by pathname.
        Parameters:
        pathname - the file to write to
        append - if true, the bytes written to the OutputStream will be appended to the end of the file
        chunkSize - the size of the file's chunks. This parameter is honored only when the file at pathname does not yet exist. If the file already exists, the file's own chunkSize has precedence.
        Returns:
        the OutputStream for writing to the file
        Throws:
        IOException - if the file is a directory, cannot be created or some other error occurs
      • getOutput

        public OutputStream getOutput​(GridFile file)
                               throws IOException
        Deprecated.
        Opens an OutputStream for writing to the given file.
        Parameters:
        file - the file to write to
        Returns:
        an OutputStream for writing to the file
        Throws:
        IOException - if an error occurs
      • getInput

        public InputStream getInput​(String pathname)
                             throws FileNotFoundException
        Deprecated.
        Opens an InputStream for reading from the file denoted by pathname.
        Parameters:
        pathname - the full path of the file to read from
        Returns:
        an InputStream for reading from the file
        Throws:
        FileNotFoundException - if the file does not exist or is a directory
      • getInput

        public InputStream getInput​(File file)
                             throws FileNotFoundException
        Deprecated.
        Opens an InputStream for reading from the given file.
        Parameters:
        file - the file to open for reading
        Returns:
        an InputStream for reading from the file
        Throws:
        FileNotFoundException - if the file does not exist or is a directory
      • getReadableChannel

        public ReadableGridFileChannel getReadableChannel​(String pathname)
                                                   throws FileNotFoundException
        Deprecated.
        Opens a ReadableGridFileChannel for reading from the file denoted by the given file path. One of the benefits of using a channel over an InputStream is the possibility to randomly seek to any position in the file (see #ReadableGridChannel.position()).
        Parameters:
        pathname - path of the file to open for reading
        Returns:
        a ReadableGridFileChannel for reading from the file
        Throws:
        FileNotFoundException - if the file does not exist or is a directory
      • getWritableChannel

        public WritableGridFileChannel getWritableChannel​(String pathname)
                                                   throws IOException
        Deprecated.
        Opens a WritableGridFileChannel for writing to the file denoted by pathname. If a file at pathname already exists, writing to the returned channel will overwrite the contents of the file.
        Parameters:
        pathname - the path to write to
        Returns:
        a WritableGridFileChannel for writing to the file at pathname
        Throws:
        IOException - if an error occurs
      • getWritableChannel

        public WritableGridFileChannel getWritableChannel​(String pathname,
                                                          boolean append)
                                                   throws IOException
        Deprecated.
        Opens a WritableGridFileChannel for writing to the file denoted by pathname. The channel can either overwrite the existing file or append to it.
        Parameters:
        pathname - the path to write to
        append - if true, the bytes written to the WritableGridFileChannel will be appended to the end of the file. If false, the bytes will overwrite the original contents.
        Returns:
        a WritableGridFileChannel for writing to the file at pathname
        Throws:
        IOException - if an error occurs
      • getWritableChannel

        public WritableGridFileChannel getWritableChannel​(String pathname,
                                                          boolean append,
                                                          int chunkSize)
                                                   throws IOException
        Deprecated.
        Opens a WritableGridFileChannel for writing to the file denoted by pathname.
        Parameters:
        pathname - the file to write to
        append - if true, the bytes written to the channel will be appended to the end of the file
        chunkSize - the size of the file's chunks. This parameter is honored only when the file at pathname does not yet exist. If the file already exists, the file's own chunkSize has precedence.
        Returns:
        a WritableGridFileChannel for writing to the file
        Throws:
        IOException - if the file is a directory, cannot be created or some other error occurs