de.schlichtherle.truezip.crypto
Class CipherReadOnlyFile

java.lang.Object
  de.schlichtherle.truezip.rof.AbstractReadOnlyFile
      de.schlichtherle.truezip.rof.DecoratingReadOnlyFile
          de.schlichtherle.truezip.crypto.CipherReadOnlyFile

All Implemented Interfaces:

ReadOnlyFile, Closeable

Direct Known Subclasses:

RaesReadOnlyFile

@NotThreadSafe
@DefaultAnnotation(value=edu.umd.cs.findbugs.annotations.NonNull.class)
public abstract class CipherReadOnlyFile
extends DecoratingReadOnlyFile

A read only file for transparent random read access to an encrypted file.

The client must call init(SeekableBlockCipher, long, long) before it can actually read anything!

Note that this class implements its own virtual file pointer. Thus, if you would like to access the underlying ReadOnlyFile again after you have finished working with an instance of this class, you should synchronize their file pointers using the pattern as described in the base class DecoratingReadOnlyFile.

Author:

Christian Schlichtherle

MAX_WINDOW_LEN

private static final int MAX_WINDOW_LEN

The maximum buffer length of the window to the encrypted file. This value has been adjusted to provide optimum performance at minimal size on a Windows XP computer - results may vary. Note that the actual size of the window is a multiple of the cipher's block size and may be smaller than the maximum window size.

See Also:

Constant Field Values

start

private long start

Start offset of the encrypted data.

length

private long length

The length of the encrypted data.

fp

private long fp

The virtual file pointer in the encrypted data. This is relative to the start.

windowOff

private long windowOff

The current offset in the encrypted file where the buffer window starts. This is always a multiple of the block size.

window

private byte[] window

The buffer window to the encrypted file. Note that this buffer contains encrypted data only. The actual size of the window is a multiple of the cipher's block size and may be slightly smaller than MAX_WINDOW_LEN.

cipher

@Nullable
private SeekableBlockCipher cipher

The seekable block cipher which allows random access.

blockOff

private long blockOff

The current offset in the encrypted file where the data starts that has been decrypted to the block. This is always a multiple of the block size.

block

private byte[] block

The block buffer to use for decryption of partial blocks. Note that this buffer contains decrypted data only.

closed

private boolean closed

Whether this read only file has been closed or not.

CipherReadOnlyFile

public CipherReadOnlyFile(@CheckForNull
                          ReadOnlyFile rof)

Creates a read only file for transparent random read access to an encrypted file. The client must call init(SeekableBlockCipher, long, long) before it can actually read anything!

Parameters:

rof - A read-only file. This may be null, but must be properly initialized before a call to init(de.schlichtherle.truezip.crypto.SeekableBlockCipher, long, long).

min

private static long min(long a,
                        long b)

Returns the smaller parameter.

assertOpen

private void assertOpen()
                 throws IOException

Asserts that this cipher output stream is in open state, which requires that cipher is not null.

Throws:

IOException - If the preconditions do not hold.

init

protected final void init(SeekableBlockCipher cipher,
                          long start,
                          long length)
                   throws IOException

Initializes this cipher read only file - must be called before first read access!

Parameters:

start - The start offset of the encrypted data in this file.

length - The length of the encrypted data in this file.

Throws:

IOException - If this read only file has already been closed. This exception is not recoverable.

IllegalStateException - If this object has already been initialized. This exception is not recoverable.

NullPointerException - If DecoratingReadOnlyFile.delegate or cipher is null. This exception is recoverable.

computeMac

protected byte[] computeMac(Mac mac)
                     throws IOException

Returns the authentication code of the encrypted data in this cipher read only file using the given Message Authentication Code (MAC) object. It is safe to call this method multiple times to detect if the file has been tampered with meanwhile.

Parameters:

mac - A properly initialized MAC object.

Throws:

IOException - On any I/O related issue.

length

public long length()
            throws IOException

Specified by:

length in interface ReadOnlyFile

Overrides:

length in class DecoratingReadOnlyFile

Throws:

IOException

getFilePointer

public long getFilePointer()
                    throws IOException

Specified by:

getFilePointer in interface ReadOnlyFile

Overrides:

getFilePointer in class DecoratingReadOnlyFile

Throws:

IOException

seek

public void seek(long fp)
          throws IOException

Specified by:

seek in interface ReadOnlyFile

Overrides:

seek in class DecoratingReadOnlyFile

Throws:

IOException

read

public int read()
         throws IOException

Specified by:

read in interface ReadOnlyFile

Overrides:

read in class DecoratingReadOnlyFile

Throws:

IOException

read

public int read(byte[] buf,
                int off,
                int len)
         throws IOException

Specified by:

read in interface ReadOnlyFile

Overrides:

read in class DecoratingReadOnlyFile

Throws:

IOException

close

public void close()
           throws IOException

Closes this read only file and releases any resources associated with it. This method invalidates the state of this object, causing any subsequent calls to a public method to fail with an IOException.

Specified by:

close in interface ReadOnlyFile

Specified by:

close in interface Closeable

Overrides:

close in class DecoratingReadOnlyFile

Throws:

IOException - If an I/O error occurs.

positionBlock

private void positionBlock()
                    throws IOException

Positions the block with the decrypted data for partial reading so that it contains the current virtual file pointer in the encrypted file.

Throws:

IOException - On any I/O related issue. The block is not moved in this case.

positionWindow

private void positionWindow()
                     throws IOException

Positions the window so that the block containing the current virtual file pointer in the encrypted file is entirely contained in it.

Throws:

IOException - On any I/O related issue. The window is invalidated in this case.