Package com.itextpdf.io.source

Class ThreadSafeRandomAccessSource

java.lang.Object
com.itextpdf.io.source.ThreadSafeRandomAccessSource
All Implemented Interfaces:
IRandomAccessSource
public class ThreadSafeRandomAccessSource extends Object implements IRandomAccessSource
A synchronized wrapper around an IRandomAccessSource.

Each operation is serialized on one lock, including close().

  • Constructor Summary

    Constructors
    Constructor
    Description
    ThreadSafeRandomAccessSource(IRandomAccessSource source)
    Creates a synchronized wrapper for a source.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    close()
    Closes this source.
    int
    get(long position)
    Gets a byte at the specified position
    int
    get(long position, byte[] bytes, int off, int len)
    Read an array of bytes of specified length from the specified position of source to the buffer applying the offset.
    long
    length()
    Gets the length of the source

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • ThreadSafeRandomAccessSource

      public ThreadSafeRandomAccessSource (IRandomAccessSource source)
      Creates a synchronized wrapper for a source.
      Parameters:
      source - the source to access under this wrapper's lock

  • Method Details

    • get

      public int get (long position) throws IOException
      Gets a byte at the specified position
      Specified by:
      get in interface IRandomAccessSource
      Parameters:
      position - byte position
      Returns:
      the byte, or -1 if EOF is reached
      Throws:
      IOException - in case of any reading error.

    • get

      public int get (long position, byte[] bytes, int off, int len) throws IOException
      Read an array of bytes of specified length from the specified position of source to the buffer applying the offset. If the number of bytes requested cannot be read, all the possible bytes will be read to the buffer, and the number of actually read bytes will be returned.
      Specified by:
      get in interface IRandomAccessSource
      Parameters:
      position - the position in the RandomAccessSource to read from
      bytes - output buffer
      off - offset into the output buffer where results will be placed
      len - the number of bytes to read
      Returns:
      the number of bytes actually read, or -1 if the file is at EOF
      Throws:
      IOException - in case of any I/O error.

    • length

      public long length()
      Gets the length of the source
      Specified by:
      length in interface IRandomAccessSource
      Returns:
      the length of this source

    • close

      public void close() throws IOException
      Closes this source. The underlying data structure or source (if any) will also be closed
      Specified by:
      close in interface IRandomAccessSource
      Throws:
      IOException - in case of any reading error.