Class RangedByteWriter

  • All Implemented Interfaces:
    ByteReader, ByteWriter

    public class RangedByteWriter
    extends FilterByteWriter
    Wraps a ByteWriter and makes it appear to start from the offset given during construction.
    • Field Summary

      • Fields inherited from interface com.adobe.internal.io.ByteReader

        EOF
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      long length()
      Returns the number of total bytes in the repository that are visible through this API.
      int read​(long position)
      Read a single byte from the underlying bytes at the given position.
      int read​(long position, byte[] b, int offset, int length)
      Transfers bytes from the underlying repository into the given destination array.
      void write​(long position, byte[] b, int offset, int length)
      Write an array of bytes at the position given.
      void write​(long position, int b)
      Write the byte given at the position given.
      • Methods inherited from class java.lang.Object

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

      • RangedByteWriter

        public RangedByteWriter​(ByteWriter byteWriter,
                                long offset)
        Constructor
        Parameters:
        byteWriter - the original ByteWriter
        offset - the offset in the original ByteWriter
    • Method Detail

      • length

        public long length()
                    throws java.io.IOException
        Description copied from interface: ByteReader
        Returns the number of total bytes in the repository that are visible through this API.
        Specified by:
        length in interface ByteReader
        Overrides:
        length in class FilterByteWriter
        Returns:
        the number of bytes in the repository.
        Throws:
        java.io.IOException - if an error occurs while trying to determine the length
      • read

        public int read​(long position,
                        byte[] b,
                        int offset,
                        int length)
                 throws java.io.IOException
        Description copied from interface: ByteReader
        Transfers bytes from the underlying repository into the given destination array. Copy up to length bytes from the repository starting at the postion given into the given array starting at the given offset.
        Specified by:
        read in interface ByteReader
        Overrides:
        read in class FilterByteWriter
        Parameters:
        position - the position to read the byte from.
        b - the array to write the bytes into.
        offset - the offset in the array at which the first byte is written.
        length - the maximum number of bytes to write into the array.
        Returns:
        the number of bytes actually written to the array.
        Throws:
        java.io.IOException - if an error occurs during the read operation
      • read

        public int read​(long position)
                 throws java.io.IOException
        Description copied from interface: ByteReader
        Read a single byte from the underlying bytes at the given position.
        Specified by:
        read in interface ByteReader
        Overrides:
        read in class FilterByteWriter
        Parameters:
        position - the position to read the byte from.
        Returns:
        the byte at the postion or EOF if the position is outside of the legal range.
        Throws:
        java.io.IOException - if an error occurs during the read operation
      • write

        public void write​(long position,
                          byte[] b,
                          int offset,
                          int length)
                   throws java.io.IOException
        Description copied from interface: ByteWriter
        Write an array of bytes at the position given. If during the write operation any of the bytes are to be written beyond the end of the virtual array visible through this interface then the length of that virtual array becomes the position of the byte written plus one (because of zero based counting). for each byte written : length of virtual array = max(length of virtual array, position of byte written + 1)
        Specified by:
        write in interface ByteWriter
        Overrides:
        write in class FilterByteWriter
        Parameters:
        position - the zero-based offset within the byte array.
        b - the array of bytes to write from.
        offset - the offset within the byte array to start writing from.
        length - the number of bytes to write from the byte array.
        Throws:
        java.io.IOException - if an error occurs during the write operation
      • write

        public void write​(long position,
                          int b)
                   throws java.io.IOException
        Description copied from interface: ByteWriter
        Write the byte given at the position given. If during the write operation the byte to be written is beyond the end of the virtual array visible through this interface then the length of that virtual array becomes the position of the byte written plus one (because of zero based counting). length of virtual array = max(length of virtual array, position of byte written + 1)
        Specified by:
        write in interface ByteWriter
        Overrides:
        write in class FilterByteWriter
        Parameters:
        position - the zero-based offset within the byte array.
        b - the byte to write.
        Throws:
        java.io.IOException - if an error occurs during the write operation