ome.util.checksum

Class FileSizeChecksumProviderImpl

java.lang.Object

ome.util.checksum.FileSizeChecksumProviderImpl

All Implemented Interfaces:

ChecksumProvider

public class FileSizeChecksumProviderImpl
extends java.lang.Object
implements ChecksumProvider

Trivial checksum provider whose hash is simply the number of bytes that were put into the calculation.

Since:

5.0.3

Author:

m.t.b.carroll@dundee.ac.uk

Constructor Summary

Constructors

Constructor and Description
FileSizeChecksumProviderImpl()

Method Summary

Modifier and Type	Method and Description
byte[]	checksumAsBytes() Returns a byte array representation of the calculated checksum.
java.lang.String	checksumAsString() Returns a String representing the checksum in hex form.
ChecksumProvider	putBytes(byte[] byteArray) Updates the internal checksum value with data from a byte array.
ChecksumProvider	putBytes(byte[] byteArray, int offset, int length) Updates the internal checksum value with data from a chunk of a byte array.
ChecksumProvider	putBytes(java.nio.ByteBuffer byteBuffer) Updates the internal checksum value with data from a byte buffer.
ChecksumProvider	putFile(java.lang.String filePath) Updates the internal checksum value with data from a file identified by a path.

Methods inherited from class java.lang.Object

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

Constructor Detail

FileSizeChecksumProviderImpl

public FileSizeChecksumProviderImpl()

Method Detail

putBytes

public ChecksumProvider putBytes(byte[] byteArray)

Description copied from interface: ChecksumProvider

Updates the internal checksum value with data from a byte array. If the array is null, throws NPE. Note that, although checksum results are consistent for any given hash function and byte array, different hash functions may calculate different checksums for an empty array despite its lack of content.

Specified by:

putBytes in interface ChecksumProvider

Parameters:

byteArray - The input byte array.

Returns:

ChecksumProvider

putBytes

public ChecksumProvider putBytes(byte[] byteArray,
                                 int offset,
                                 int length)

Description copied from interface: ChecksumProvider

Updates the internal checksum value with data from a chunk of a byte array. First byte read is byteArray[offset], last byte read is byteArray[offset + length - 1]. If the array is null, throws NPE. Throws IOOB if indexes are invalid. Note that, although checksum results are consistent for any given hash function and byte array, different hash functions may calculate different checksums for an empty array despite its lack of content.

Specified by:

putBytes in interface ChecksumProvider

Parameters:

byteArray - The input byte array.

offset - The offset in the byte array at which to start putting bytes.

length - The number of bytes to put, starting from the offset.

Returns:

ChecksumProvider

putBytes

public ChecksumProvider putBytes(java.nio.ByteBuffer byteBuffer)

Description copied from interface: ChecksumProvider

Updates the internal checksum value with data from a byte buffer. If the array underlying the byte buffer is not accessible, throws an IllegalArgumentException.

Specified by:

putBytes in interface ChecksumProvider

Parameters:

byteBuffer - The input byte buffer.

Returns:

ChecksumProvider

putFile

public ChecksumProvider putFile(java.lang.String filePath)

Description copied from interface: ChecksumProvider

Updates the internal checksum value with data from a file identified by a path. Throws a RuntimeException in a case of an IO error. Input previous to this method does not affect the calculated checksum.

Specified by:

putFile in interface ChecksumProvider

Parameters:

filePath - String representing the absolute file path.

Returns:

ChecksumProvider

checksumAsBytes

public byte[] checksumAsBytes()

Description copied from interface: ChecksumProvider

Returns a byte array representation of the calculated checksum. Subsequent calls to this method will return the same object state. After calling this method any invocation of the mutating methods (put*) will cause it to throw IllegalStateException.

Specified by:

checksumAsBytes in interface ChecksumProvider

Returns:

byte[] The checksum in a byte array.

checksumAsString

public java.lang.String checksumAsString()

Description copied from interface: ChecksumProvider

Returns a String representing the checksum in hex form. Subsequent calls to this method will return the same object state. After calling this method any invocation of the mutating methods (put*) will cause it to throw IllegalStateException.

Specified by:

checksumAsString in interface ChecksumProvider

Returns:

String The hexadecimal value of the checksum.