sila_java.library.server_base.binary_transfer.database

Interface BinaryDatabase

All Superinterfaces:

AutoCloseable

All Known Implementing Classes:

H2BinaryDatabase

public interface BinaryDatabase
extends AutoCloseable

Interface of a binary database

Implementation Note:

The implementer must take care of removing expired entries

Method Summary

Modifier and Type	Method and Description
Duration	addBinary(@NonNull UUID binaryId, byte[] bytes) Add a binary into the database
Duration	addBinary(UUID binaryId, InputStream stream) Add a binary into the database
static BinaryDatabase	current() Get a reference to the current BinaryDatabase from the Context.current()
Duration	extendBinaryExpiration(UUID binaryId) Extend the expiration date of a binary
Binary	getBinary(UUID binaryId) Get a binary by its identifier
BinaryInfo	getBinaryInfo(UUID binaryId) Get the information of a binary by its identifier
void	removeAllBinaries() Remove all binaries from the database
void	removeBinary(UUID binaryId) Remove a binary from the database

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

getBinary

Binary getBinary(UUID binaryId)
          throws BinaryDatabaseException

Get a binary by its identifier

Parameters:

binaryId - The binary identifier

Returns:

The binary with the specified identifier

Throws:

BinaryDatabaseException - when the binary does not exist or cannot be retrieved

getBinaryInfo

BinaryInfo getBinaryInfo(UUID binaryId)
                  throws BinaryDatabaseException

Get the information of a binary by its identifier

Parameters:

binaryId - the binary identifier

Returns:

The information of the binary with the specified identifier

Throws:

BinaryDatabaseException - when the binary does not exist or cannot be retrieved

addBinary

Duration addBinary(@NonNull
                   @NonNull UUID binaryId,
                   byte[] bytes)
            throws BinaryDatabaseException

Add a binary into the database

Parameters:

binaryId - The binary identifier

bytes - The data to save in the database

Returns:

The expiration duration of the binary

Throws:

BinaryDatabaseException - when the binary cannot be added into database

addBinary

Duration addBinary(UUID binaryId,
                   InputStream stream)
            throws BinaryDatabaseException

Add a binary into the database

Parameters:

binaryId - The binary identifier

stream - The data stream to save in the database

Returns:

The expiration duration of the binary

Throws:

BinaryDatabaseException - when the binary cannot be added into database

extendBinaryExpiration

Duration extendBinaryExpiration(UUID binaryId)
                         throws BinaryDatabaseException

Extend the expiration date of a binary

Parameters:

binaryId - The binary identifier

Returns:

The extended expiration duration

Throws:

BinaryDatabaseException - when the binary expiration cannot be extended

removeAllBinaries

void removeAllBinaries()
                throws BinaryDatabaseException

Remove all binaries from the database

Throws:

BinaryDatabaseException - when the binaries cannot be removed from the database

removeBinary

void removeBinary(UUID binaryId)
           throws BinaryDatabaseException

Remove a binary from the database

Parameters:

binaryId - The binary identifier to remove

Throws:

BinaryDatabaseException - when the binary cannot be removed from the database

current

static BinaryDatabase current()

Get a reference to the current BinaryDatabase from the Context.current()

Returns:

The current BinaryDatabase