Interface IFileStore

All Known Implementing Classes:
MemoryFileStore, SimpleFSFileStore

public interface IFileStore
Definition of a binary file store: a store where artifacts are byte arrays uniquely identified by a key.
  • Method Summary

    Modifier and Type
    Method
    Description
    byte[]
    get(String key)
    Retrieve the contents of a file from the store.
    Get the store location.
    default String
    Deprecated.
    use getLocation() instead
    boolean
    has(String key)
    Verify if the given file is contained in the store.
    List all the files in this store.
    put(byte[] data)
    Store a new file in the store under a store-decided key.
    put(String key, byte[] data)
    Store a new file in the store under the given key.
    boolean
    Remove a file from the store.
  • Method Details

    • getLocation

      String getLocation()
      Get the store location. Example: a root folder, a base url.
      Returns:
      the optional store location; may be null
    • getStoreLocation

      @Deprecated default String getStoreLocation()
      Deprecated.
      use getLocation() instead
    • has

      boolean has(String key)
      Verify if the given file is contained in the store.
      Parameters:
      key - file key
      Returns:
      presence indicator
    • remove

      boolean remove(String key)
      Remove a file from the store.
      Parameters:
      key - file key
      Returns:
      success indicator
    • get

      byte[] get(String key)
      Retrieve the contents of a file from the store.
      Parameters:
      key - file key
      Returns:
      file data, null on error
    • put

      String put(String key, byte[] data)
      Store a new file in the store under the given key.
      Parameters:
      key - file key, null to let the implementor create a new key
      data - file data
      Returns:
      the file key, null on error
    • put

      String put(byte[] data)
      Store a new file in the store under a store-decided key.
      Parameters:
      data - file data
      Returns:
      the file key, null on error
    • list

      List<String> list()
      List all the files in this store.
      Returns:
      a list of file keys