CipherReadOnlyFile (TrueZIP Driver ZIP 7.5.2 API)

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

All Implemented Interfaces:

ReadOnlyFile, Closeable, AutoCloseable

Direct Known Subclasses:

WinZipAesEntryReadOnlyFile
```
@NotThreadSafe
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

See Also:
CipherOutputStream

Field Summary

Fields
Modifier and Type	Field and Description
`private byte[]`	`block` The buffer for the decrypted file data.
`private long`	`blockStart` The current offset in the encrypted file where the data starts that has been decrypted to the block.
`private byte[]`	`buffer` The buffer for the encrypted file data.
`private long`	`bufferStart` The current offset in the encrypted file where the buffer window starts.
`private SeekableBlockCipher`	`cipher` The seekable block cipher which allows random access.
`private static long`	`INVALID`
`private long`	`length` The length of the encrypted data.
`private long`	`pos` The virtual file pointer in the encrypted data.
`private long`	`start` Start offset of the encrypted data.

Fields inherited from class de.schlichtherle.truezip.rof.DecoratingReadOnlyFile
delegate

Constructor Summary

Constructors
Modifier Constructor and Description

protected CipherReadOnlyFile(ReadOnlyFile rof)
Creates a read only file for transparent random read access to an encrypted file.

Constructors
Modifier	Constructor and Description
`protected`	`CipherReadOnlyFile(ReadOnlyFile rof)` Creates a read only file for transparent random read access to an encrypted file.

Method Summary

Methods
Modifier and Type	Method and Description
`private void`	`checkOpen()` Asserts that this cipher output stream is in open state, which requires that `cipher` is not `null`.
`void`	`close()` Closes this read only file and releases any resources associated with it.
`protected byte[]`	`computeMac(Mac mac)` Returns the authentication code of the encrypted data in this cipher read-only file using the given Message Authentication Code (MAC) object.
`long`	`getFilePointer()`
`protected void`	`init(SeekableBlockCipher cipher, long start, long length)` Initializes this cipher read only file - must be called before first read access!
`long`	`length()`
`private void`	`positionBlock()` Positions the block with the decrypted data for partial reading so that it contains the current virtual file pointer in the encrypted file.
`private void`	`positionBuffer()` Positions the window so that the block containing the current virtual file pointer in the encrypted file is entirely contained in it.
`int`	`read()`
`int`	`read(byte[] dst, int offset, int remaining)`
`void`	`seek(long pos)`

Methods inherited from class de.schlichtherle.truezip.rof.DecoratingReadOnlyFile
toString

Methods inherited from class de.schlichtherle.truezip.rof.AbstractReadOnlyFile
read, readFully, readFully

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - block
```
private byte[] block
```
    The buffer for the decrypted file data.
  - blockStart
```
private long blockStart
```
    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.
  - buffer
```
private byte[] buffer
```
    The buffer for the encrypted file data. The size of the buffer is a multiple of the cipher's block size.
  - bufferStart
```
private long bufferStart
```
    The current offset in the encrypted file where the buffer window starts. This is always a multiple of the block size.
  - cipher
```
@Nullable
private SeekableBlockCipher cipher
```
    The seekable block cipher which allows random access.
  - INVALID
```
private static final long INVALID
```
    See Also:
    Constant Field Values
  - length
```
private long length
```
    The length of the encrypted data.
  - pos
```
private long pos
```
    The virtual file pointer in the encrypted data.
  - start
```
private long start
```
    Start offset of the encrypted data.
- Constructor Detail
  - CipherReadOnlyFile
```
@CreatesObligation
protected CipherReadOnlyFile(@Nullable@WillCloseWhenClosed
                                    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).
- Method Detail
  - checkOpen
```
private void checkOpen()
                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.
  - 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
    
    Specified by:
    
    close in interface AutoCloseable
    
    Overrides:
    
    close in class DecoratingReadOnlyFile
    
    Throws:
    
    IOException - If an I/O error occurs.
  - 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.
    
    Returns:
    A byte array with the authentication code.
    
    Throws:
    
    IOException - on any I/O error.
  - getFilePointer
```
public long getFilePointer()
                    throws IOException
```
    Specified by:
    
    getFilePointer in interface ReadOnlyFile
    
    Overrides:
    
    getFilePointer in class DecoratingReadOnlyFile
    
    Throws:
    
    IOException
  - 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:
    cipher - the seekable block cipher.
    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 DecoratingReadOnlyFile.delegate is null or if this object has already been initialized.
    
    IllegalArgumentException - if cipher is null or if start or length are less than zero.
  - length
```
public long length()
            throws IOException
```
    Specified by:
    
    length in interface ReadOnlyFile
    
    Overrides:
    
    length in class DecoratingReadOnlyFile
    
    Throws:
    
    IOException
  - 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 error. The block is not moved in this case.
  - positionBuffer
```
private void positionBuffer()
                     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 error. The buffer gets invalidated in this case.
  - read
```
public int read()
         throws IOException
```
    Specified by:
    
    read in interface ReadOnlyFile
    
    Overrides:
    
    read in class DecoratingReadOnlyFile
    
    Throws:
    
    IOException
  - read
```
public int read(byte[] dst,
       int offset,
       int remaining)
         throws IOException
```
    Specified by:
    
    read in interface ReadOnlyFile
    
    Overrides:
    
    read in class DecoratingReadOnlyFile
    
    Throws:
    
    IOException
  - seek
```
public void seek(long pos)
          throws IOException
```
    Specified by:
    
    seek in interface ReadOnlyFile
    
    Overrides:
    
    seek in class DecoratingReadOnlyFile
    
    Throws:
    
    IOException

Class CipherReadOnlyFile

Field Summary

Fields inherited from class de.schlichtherle.truezip.rof.DecoratingReadOnlyFile

Constructor Summary

Method Summary

Methods inherited from class de.schlichtherle.truezip.rof.DecoratingReadOnlyFile

Methods inherited from class de.schlichtherle.truezip.rof.AbstractReadOnlyFile

Methods inherited from class java.lang.Object

Field Detail

block

blockStart

buffer

bufferStart

cipher

INVALID

length

pos

start

Constructor Detail

CipherReadOnlyFile

Method Detail

checkOpen

close

computeMac

getFilePointer

init

length

positionBlock

positionBuffer

read

read

seek