de.adorsys.datasafe.storage.api.actions

Interface StorageWriteService

All Known Subinterfaces:

StorageService

All Known Implementing Classes:

BaseDelegatingStorage, RegexDelegatingStorage, SchemeDelegatingStorage, UriBasedAuthStorageService, UserBasedDelegatingStorage

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface StorageWriteService

Raw file write operation at a given location. Paths use URL-encoding.

Method Summary

Modifier and Type	Method and Description
default Optional<Integer>	flushChunkSize(AbsoluteLocation location) For some storages that cache data before writing it (i.e.
OutputStream	write(WithCallback<AbsoluteLocation,? extends ResourceWriteCallback> locationWithCallback)

Method Detail

write

OutputStream write(WithCallback<AbsoluteLocation,? extends ResourceWriteCallback> locationWithCallback)

Parameters:

locationWithCallback - absolute bucket path with credentials (if necessary) plus callbacks to be executed when file is written, i.e. notify callee that we assigned some file version

Returns:

data stream of resource to write to

flushChunkSize

default Optional<Integer> flushChunkSize(AbsoluteLocation location)

For some storages that cache data before writing it (i.e. S3StorageService) this should indicate buffer size, so that callers can optimize some parts of their logic.

Parameters:

location - resource to check for buffer size

Returns:

Buffer size in bytes, or -1 if undefined