Class NoOpFileStorageAdapter

Creates new file at key if it doesn't already exist. Fails if key already exists (use put for upsert or update for existing files). Content is loaded entirely in memory - use addStream for large files.

Creates new file at key using streaming content if it doesn't already exist. Fails if key already exists (use putStream for upsert or updateStream for existing files). Content is streamed - efficient for large files or continuous data sources.

Copies source file to destination path if destination doesn't exist. Destination is left unchanged if source not found or destination already exists.

Copies source file to destination path, overwriting destination if it exists. Returns false if source doesn't exist; destination remains unchanged.

Checks whether a file exists at the given key.

Retrieves complete file content as a byte array. The entire file must fit in memory - use getStream for large files. Returns null if the file does not exist.

Retrieves file metadata (ETag, content type, size, modification date). Returns null if the file does not exist. Useful for cache validation and file information endpoints.

Generates a public, permanently-accessible URL for a file. Returns null if the file does not exist or public access is not supported by the adapter.

Generates a temporary signed URL for downloading a file. The URL expires after the configured duration and becomes invalid. Returns null when the adapter verifies that the file does not exist. Some backends may return a signed URL that fails when accessed if existence checks are disabled.

Generates a temporary signed URL for uploading a file. The URL expires after the configured duration and becomes invalid. Throws if URL generation fails (storage system misconfiguration).

Retrieves file content as an async stream of byte chunks. Memory-efficient for large files - content is streamed rather than loaded entirely. Returns null if the file does not exist.

Moves (renames) source file to destination path if destination doesn't exist. Destination is left unchanged if source not found or destination already exists. Effectively deletes the source file after successful copy.

Moves (renames) source file to destination path, overwriting destination if it exists. Returns false if source doesn't exist; destination remains unchanged. Effectively deletes the source file after successful copy.

Creates or overwrites file (upsert) at key with content. Always succeeds: creates file if doesn't exist, overwrites if exists. Content is loaded entirely in memory - use putStream for large files.

Creates or overwrites file (upsert) at key using streaming content. Always succeeds: creates file if doesn't exist, overwrites if exists. Content is streamed - efficient for large files or continuous data sources.

Removes all files whose keys start with the given prefix. Useful for batch deletion by directory or namespace. Silently succeeds if no keys match the prefix.

Removes multiple specific files by key.

Updates existing file at key with new content. Fails if key doesn't exist (use put for upsert or add for new files). Content is loaded entirely in memory - use updateStream for large files.

Updates existing file at key using streaming content. Fails if key doesn't exist (use putStream for upsert or addStream for new files). Content is streamed - efficient for large files or continuous data sources.