com.artipie.asto

Class LoggingStorage

java.lang.Object

com.artipie.asto.LoggingStorage

All Implemented Interfaces:

Storage

public final class LoggingStorage
extends Object
implements Storage

Storage that logs performed operations.

Since:

0.20.4

Nested Class Summary

Nested classes/interfaces inherited from interface com.artipie.asto.Storage

Storage.Wrap

Constructor Summary

Constructors

Constructor and Description
LoggingStorage(Level level, Storage storage) Ctor.
LoggingStorage(Storage storage) Ctor.

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Void>	delete(Key key) Removes value from storage.
<T> CompletionStage<T>	exclusively(Key key, Function<Storage,CompletionStage<T>> operation) Runs operation exclusively for specified key.
CompletableFuture<Boolean>	exists(Key key) This file exists?
CompletableFuture<Collection<Key>>	list(Key prefix) Return the list of keys that start with this prefix, for example "foo/bar/".
CompletableFuture<Void>	move(Key source, Key destination) Moves value from one location to another.
CompletableFuture<Void>	save(Key key, Content content) Saves the bytes to the specified key.
CompletableFuture<Long>	size(Key key) Get value size.
CompletableFuture<Content>	value(Key key) Obtain bytes by key.

Methods inherited from class java.lang.Object

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

Constructor Detail

LoggingStorage

public LoggingStorage(Storage storage)

Ctor.

Parameters:

storage - Delegate storage.

LoggingStorage

public LoggingStorage(Level level,
                      Storage storage)

Ctor.

Parameters:

level - Logging level.

storage - Delegate storage.

Method Detail

exists

public CompletableFuture<Boolean> exists(Key key)

Description copied from interface: Storage

This file exists?

Specified by:

exists in interface Storage

Parameters:

key - The key (file name)

Returns:

TRUE if exists, FALSE otherwise

list

public CompletableFuture<Collection<Key>> list(Key prefix)

Description copied from interface: Storage

Return the list of keys that start with this prefix, for example "foo/bar/".

Specified by:

list in interface Storage

Parameters:

prefix - The prefix.

Returns:

Collection of relative keys.

save

public CompletableFuture<Void> save(Key key,
                                    Content content)

Description copied from interface: Storage

Saves the bytes to the specified key.

Specified by:

save in interface Storage

Parameters:

key - The key

content - Bytes to save

Returns:

Completion or error signal.

move

public CompletableFuture<Void> move(Key source,
                                    Key destination)

Description copied from interface: Storage

Moves value from one location to another.

Specified by:

move in interface Storage

Parameters:

source - Source key.

destination - Destination key.

Returns:

Completion or error signal.

size

public CompletableFuture<Long> size(Key key)

Description copied from interface: Storage

Get value size.

Specified by:

size in interface Storage

Parameters:

key - The key of value.

Returns:

Size of value in bytes.

value

public CompletableFuture<Content> value(Key key)

Description copied from interface: Storage

Obtain bytes by key.

Specified by:

value in interface Storage

Parameters:

key - The key

Returns:

Bytes.

delete

public CompletableFuture<Void> delete(Key key)

Description copied from interface: Storage

Removes value from storage. Fails if value does not exist.

Specified by:

delete in interface Storage

Parameters:

key - Key for value to be deleted.

Returns:

Completion or error signal.

exclusively

public <T> CompletionStage<T> exclusively(Key key,
                                          Function<Storage,CompletionStage<T>> operation)

Description copied from interface: Storage

Runs operation exclusively for specified key.

Specified by:

exclusively in interface Storage

Type Parameters:

T - Operation result type.

Parameters:

key - Key which is scope of operation.

operation - Operation to be performed exclusively.

Returns:

Result of operation.