Interface BucketMetadataOperations<T>

Type Parameters:
T - The provider-native metadata representation type.
public interface BucketMetadataOperations<T>
Portable metadata persistence contract for buckets and containers.

save(BucketMetadataWrite) uses replace/upsert semantics for the portable metadata snapshot. delete(String) is idempotent.

Since:
3.0.0
Author:
Álvaro Sánchez-Mariscal

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    delete(@NonNull String name)
    Deletes the metadata snapshot for a bucket or container.
    default boolean
    exists(@NonNull String name)
    Checks whether a metadata snapshot exists for a bucket or container.
    @NonNull Optional<BucketMetadataEntry<T>>
    retrieve(@NonNull String name)
    Retrieves the stored metadata snapshot for a bucket or container.
    void
    save(@NonNull BucketMetadataWrite write)
    Saves a metadata snapshot for a bucket or container.

  • Method Details

    • retrieve

      @NonNull Optional<BucketMetadataEntry<T>> retrieve(@NonNull String name)
      Retrieves the stored metadata snapshot for a bucket or container.
      Parameters:
      name - The bucket or container name.
      Returns:
      The metadata entry, or Optional.empty() if no metadata snapshot exists.

    • save

      void save(@NonNull BucketMetadataWrite write)
      Saves a metadata snapshot for a bucket or container.
      Parameters:
      write - The metadata snapshot to persist.

    • delete

      void delete(@NonNull String name)
      Deletes the metadata snapshot for a bucket or container.
      Parameters:
      name - The bucket or container name.

    • exists

      default boolean exists(@NonNull String name)
      Checks whether a metadata snapshot exists for a bucket or container.
      Parameters:
      name - The bucket or container name.
      Returns:
      true if metadata exists for the bucket or container.