Class ByteArrayProvider

  • All Implemented Interfaces:
    ByteProvider, java.io.Closeable, java.lang.AutoCloseable

    public class ByteArrayProvider
    extends java.lang.Object
    implements ByteProvider
    An implementation of ByteProvider where the underlying bytes are supplied by a static byte array. NOTE: Use of this class is discouraged when the byte array could be large.
    • Constructor Summary

      Constructors 
      Constructor Description
      ByteArrayProvider​(byte[] bytes)
      Constructs a byte array provider using the specified byte array
      ByteArrayProvider​(java.lang.String name, byte[] bytes)
      Constructs a byte array provider using the specified byte array
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void close()
      Releases any resources the provider may have occupied.
      java.lang.String getAbsolutePath()
      Returns the absolute path (similar to, but not a, URI) to the byte provider.
      java.io.File getFile()
      Returns the underlying file for this byte provider.
      java.io.InputStream getInputStream​(long index)
      Returns an input stream to the underlying byte provider starting at the specified index
      java.lang.String getName()
      Returns the name of the byte provider.
      boolean isValidIndex​(long index)
      Returns true if the specified index is valid.
      long length()
      Returns the length of the underlying provider.
      byte readByte​(long index)
      Reads a byte at the specified index.
      byte[] readBytes​(long index, long length)
      Reads a byte array at the specified index.
      • Methods inherited from class java.lang.Object

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

      • ByteArrayProvider

        public ByteArrayProvider​(byte[] bytes)
        Constructs a byte array provider using the specified byte array
        Parameters:
        bytes - the underlying byte array.
      • ByteArrayProvider

        public ByteArrayProvider​(java.lang.String name,
                                 byte[] bytes)
        Constructs a byte array provider using the specified byte array
        Parameters:
        bytes - the underlying byte array.
    • Method Detail

      • close

        public void close()
        Description copied from interface: ByteProvider
        Releases any resources the provider may have occupied.
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface ByteProvider
        Specified by:
        close in interface java.io.Closeable
      • getFile

        public java.io.File getFile()
        Description copied from interface: ByteProvider
        Returns the underlying file for this byte provider. Or null if this byte provider is not associated with a file.
        Specified by:
        getFile in interface ByteProvider
        Returns:
        the underlying file for this byte provider
      • getName

        public java.lang.String getName()
        Description copied from interface: ByteProvider
        Returns the name of the byte provider. For example, the underlying file name.
        Specified by:
        getName in interface ByteProvider
        Returns:
        the name of the byte provider or null
      • getAbsolutePath

        public java.lang.String getAbsolutePath()
        Description copied from interface: ByteProvider
        Returns the absolute path (similar to, but not a, URI) to the byte provider. For example, the complete path to the file.
        Specified by:
        getAbsolutePath in interface ByteProvider
        Returns:
        the absolute path to the byte provider or null
      • getInputStream

        public java.io.InputStream getInputStream​(long index)
                                           throws java.io.IOException
        Description copied from interface: ByteProvider
        Returns an input stream to the underlying byte provider starting at the specified index

        The caller is responsible for closing the returned InputStream instance.

        Specified by:
        getInputStream in interface ByteProvider
        Parameters:
        index - the index to initialize the input stream
        Returns:
        the input stream
        Throws:
        java.io.IOException - if an I/O error occurs
      • length

        public long length()
        Description copied from interface: ByteProvider
        Returns the length of the underlying provider.
        Specified by:
        length in interface ByteProvider
        Returns:
        the length of the underlying provider
      • isValidIndex

        public boolean isValidIndex​(long index)
        Description copied from interface: ByteProvider
        Returns true if the specified index is valid.
        Specified by:
        isValidIndex in interface ByteProvider
        Parameters:
        index - the index in the byte provider
        Returns:
        returns true if the specified index is valid
      • readByte

        public byte readByte​(long index)
                      throws java.io.IOException
        Description copied from interface: ByteProvider
        Reads a byte at the specified index.
        Specified by:
        readByte in interface ByteProvider
        Parameters:
        index - the index to read the byte
        Returns:
        the byte read from the specified index
        Throws:
        java.io.IOException - if an I/O error occurs
      • readBytes

        public byte[] readBytes​(long index,
                                long length)
                         throws java.io.IOException
        Description copied from interface: ByteProvider
        Reads a byte array at the specified index.
        Specified by:
        readBytes in interface ByteProvider
        Parameters:
        index - the index to read the byte array
        length - the number of elements to read
        Returns:
        the byte array read from the specified index
        Throws:
        java.io.IOException - if an I/O error occurs