eve.io.block.secure

Class SecureBlockInputStream

java.lang.Object

eve.io.block.BlockInputStream

eve.io.block.secure.SecureBlockInputStream

All Implemented Interfaces:

IBlockInput

public class SecureBlockInputStream
extends BlockInputStream

A SecureBlockInputStream is used to read in discrete blocks of data as sent by BlockOutputStream. The data sent by the BlockOutputStream may be Secure Documents as represented by eve.security.SecureDocument and this BlockInputStream will then attempt to decode and validate them using the encryption parameters as provided by setPassword() and setKeys().

Field Summary

Fields

Modifier and Type	Field and Description
protected SecureDocument	secureDocument

Fields inherited from class eve.io.block.BlockInputStream

in, intBuff, maximumInputBlockSize

Constructor Summary

Constructors

Constructor and Description
SecureBlockInputStream(InputStream in) Create a SecureBlockInputStream using the provided InputStream for reading in data.

Method Summary

Modifier and Type	Method and Description
protected SecureDocument	createSecureDocument()
protected void	decrypt(byte[] data, int offset, int length, ByteArray dest) This decrypts the incoming data.
protected SecureDocument	getSecureDocument()
void	setDecryptor(DataProcessor decryptor) Set the decryptor to be used explicitly.
void	setDecryptor(String password) Set the decryptor by creating a new Decryptor which uses the provided password.
void	setKeys(EncryptionKey myPrivateKey, EncryptionKey remotePublicKey) Set the Public/Private keys.

Methods inherited from class eve.io.block.BlockInputStream

blockRead, close, readBlock, readBlock

Methods inherited from class java.lang.Object

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

Field Detail

secureDocument

protected SecureDocument secureDocument

Constructor Detail

SecureBlockInputStream

public SecureBlockInputStream(InputStream in)

Create a SecureBlockInputStream using the provided InputStream for reading in data.

Method Detail

getSecureDocument

protected SecureDocument getSecureDocument()

createSecureDocument

protected SecureDocument createSecureDocument()

setDecryptor

public void setDecryptor(DataProcessor decryptor)
                  throws IOException

Set the decryptor to be used explicitly.

Throws:

IOException

setDecryptor

public void setDecryptor(String password)
                  throws IOException

Set the decryptor by creating a new Decryptor which uses the provided password.

Throws:

IOException

setKeys

public void setKeys(EncryptionKey myPrivateKey,
                    EncryptionKey remotePublicKey)

Set the Public/Private keys.

Parameters:

myPrivateKey - This is used to decrypt the symmetric session key for each block of data.

remotePublicKey - The remotePublicKey is used to verify the signature of data signed by the sender. If it is null signatures will not be verified.

decrypt

protected void decrypt(byte[] data,
                       int offset,
                       int length,
                       ByteArray dest)
                throws UnknownEncodingException,
                       IOException

This decrypts the incoming data.

Overrides:

decrypt in class BlockInputStream

Parameters:

data - the data bytes read in.

offset - the offset of the data.

length - the number of bytes of data.

dest - a destination ByteArray that will not be null and would have been cleared before being passed here.

Throws:

UnknownEncodingException - if the data could not be decoded/decrypted.

IOException - if there was a problem decrypting the data.