matthiasbeyer/imag
1
0
Fork 0
Code Releases Activity

Doc for Store::create()

Browse source
This commit is contained in:
Matthias Beyer 2017-02-20 16:03:11 +01:00
parent 84dc385749
commit 8896bbb4c5
1 changed files with 19 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
libimagstore/src/store.rs
View file

@ -422,6 +422,25 @@ impl Store {
} }
/// Creates the Entry at the given location (inside the entry) /// Creates the Entry at the given location (inside the entry)
///
/// # Executed Hooks
///
/// - Pre create aspects
/// - post create aspects
///
/// # Return value
///
/// On success: FileLockEntry
///
/// On error:
/// - Errors StoreId::into_storeid() might return
/// - CreateCallError(HookExecutionError(PreHookExecuteError(_)))
/// of the first failing pre hook.
/// - CreateCallError(HookExecutionError(PostHookExecuteError(_)))
/// of the first failing post hook.
/// - CreateCallError(LockPoisoned()) if the internal lock is poisened.
/// - CreateCallError(EntryAlreadyExists()) if the entry exists already.
///
pub fn create<'a, S: IntoStoreId>(&'a self, id: S) -> Result<FileLockEntry<'a>> { pub fn create<'a, S: IntoStoreId>(&'a self, id: S) -> Result<FileLockEntry<'a>> {
let id = try!(id.into_storeid()).with_base(self.path().clone()); let id = try!(id.into_storeid()).with_base(self.path().clone());
if let Err(e) = self.execute_hooks_for_id(self.pre_create_aspects.clone(), &id) { if let Err(e) = self.execute_hooks_for_id(self.pre_create_aspects.clone(), &id) {