ch.epfl.dedis.ocs

Class Document

java.lang.Object

ch.epfl.dedis.ocs.Document

public class Document
extends Object

Constructor Summary

Constructors

Constructor and Description
Document(byte[] dataEncrypted, byte[] keyMaterial, byte[] dataPublic, Darc readers) Initialises a document.
Document(byte[] dataEncrypted, byte[] keyMaterial, byte[] dataPublic, Darc readers, WriteRequestId writeRequestId) Initialises a document.
Document(byte[] data, int keylen, Darc readers) Convenience method without the public data.
Document(byte[] data, int keylen, Darc readers, byte[] dataPublic) Creates a new document from data, creates a new Darc, a symmetric symmetricKey and encrypts the data using CBC-RSA.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object other) Compares this document with another document.
byte[]	getDataEncrypted()
byte[]	getDataPublic()
byte[]	getKeyMaterial()
Darc	getReaders()
WriteRequest	getWriteRequest()
WriteRequestId	getWriteRequestId()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Document

public Document(byte[] dataEncrypted,
                byte[] keyMaterial,
                byte[] dataPublic,
                Darc readers,
                WriteRequestId writeRequestId)

Initialises a document. The data already has to be encrypted. The writeRequestId can be null if there hasn't been done a write request yet.

Parameters:

dataEncrypted - the encrypted data of the document

keyMaterial - key-material necessary for the unencryption of the document. This will be encrypted before the transmission to the skipchain.

dataPublic - any public data that will be stored unencrypted on the skipchain.

readers - the readers allowed to create a read-request on this document.

writeRequestId - the writeRequest, if this represents a document already on the skipchain.

Document

public Document(byte[] dataEncrypted,
                byte[] keyMaterial,
                byte[] dataPublic,
                Darc readers)

Initialises a document. The data already has to be encrypted.

Parameters:

dataEncrypted - the encrypted data of the document

keyMaterial - key-material necessary for the unencryption of the document. This will be encrypted before the transmission to the skipchain.

dataPublic - any public data that will be stored unencrypted on the skipchain.

readers - the readers allowed to create a read-request on this document.

Document

public Document(byte[] data,
                int keylen,
                Darc readers,
                byte[] dataPublic)
         throws CothorityCryptoException

Creates a new document from data, creates a new Darc, a symmetric symmetricKey and encrypts the data using CBC-RSA.

Parameters:

data - any data that will be stored encrypted on the skipchain. There is a 10MB-limit on how much data can be stored. If you need more, this must be a pointer to an off-chain storage.

keylen - how long the symmetric symmetricKey should be, in bytes. 16 bytes should be a safe guess for the moment.

dataPublic - any public data that will not be encrypted

Throws:

CothorityCryptoException - in the case the encryption doesn't work

Document

public Document(byte[] data,
                int keylen,
                Darc readers)
         throws CothorityCryptoException

Convenience method without the public data.

Parameters:

data -

keylen -

readers -

Throws:

CothorityCryptoException

Method Detail

equals

public boolean equals(Object other)

Compares this document with another document. If this document has a writeRequestId, it will be compared against the other document's writeRequestId, else it will be ignored.

Overrides:

equals in class Object

Parameters:

other - another Document

Returns:

true if both are equal

getWriteRequest

public WriteRequest getWriteRequest()

getDataEncrypted

public byte[] getDataEncrypted()

getKeyMaterial

public byte[] getKeyMaterial()

getDataPublic

public byte[] getDataPublic()

getWriteRequestId

public WriteRequestId getWriteRequestId()

getReaders

public Darc getReaders()

toString

public String toString()

Overrides:

toString in class Object