Struct PosixBackend 

pub struct PosixBackend { /* private fields */ }

State of the backend needed to satisfy the storage APIs.

Implementations

impl PosixBackend

pub fn new<P: AsRef<Path>>( base: P, cache: StorageCacheConfig, options: &FileBackendConfig, ) -> Self

Instantiates a new backend.

Parameters

• base: Directory in which we keep the files. shared among all instances of the backend.

pub fn path(&self) -> &Path

Returns the directory in which the backend creates files.

Trait Implementations

impl StorageBackend for PosixBackend

fn create_named( &self, name: &StoragePath, ) -> Result<Box<dyn FileWriter>, StorageError>

Create a new file with the given name, automatically creating any parent directories within name that don’t already exist.

fn open(&self, name: &StoragePath) -> Result<Arc<dyn FileReader>, StorageError>

Opens name for reading.

fn list( &self, parent: &StoragePath, cb: &mut dyn FnMut(&StoragePath, StorageFileType), ) -> Result<(), StorageError>

Calls cb with the name of each of the files under parent. This is a non-recursive list: it does not include files under sub-directories of parent.

fn delete(&self, name: &StoragePath) -> Result<(), StorageError>

fn delete_recursive(&self, name: &StoragePath) -> Result<(), StorageError>

fn usage(&self) -> Arc<AtomicI64>

Returns a value that represents the number of bytes of storage in use. The storage backend updates this value when its own functions cause more or less storage to be used:

fn file_system_path(&self) -> Option<&Path>

Returns the base directory path on the local file system if the storage backend uses local disk.

fn create(&self) -> Result<Box<dyn FileWriter>, StorageError>

Creates a new persistent file used for writing data. The backend selects a name.

fn create_with_prefix( &self, prefix: &Path, ) -> Result<Box<dyn FileWriter>, StorageError>

Creates a new persistent file used for writing data, giving the file’s name the specified prefix. See also create.

fn delete_if_exists(&self, name: &Path) -> Result<(), StorageError>

fn exists(&self, name: &Path) -> Result<bool, StorageError>

fn read(&self, name: &Path) -> Result<Arc<FBuf>, StorageError>

Reads name and returns its contents. The file name is relative to the base of the storage backend.

fn write(&self, name: &Path, content: FBuf) -> Result<(), StorageError>

Writes content to name, automatically creating any parent directories within name that don’t already exist.