// Copyright 2015, 2016 Ethcore (UK) Ltd. // This file is part of Parity. // Parity is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Parity is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with Parity. If not, see . //! Extras db utils. use std::ops::Deref; use std::hash::Hash; use std::sync::RwLock; use std::collections::HashMap; use util::{DBTransaction, Database, RwLockable}; use util::rlp::{encode, Encodable, decode, Decodable}; #[derive(Clone, Copy)] pub enum CacheUpdatePolicy { Overwrite, Remove, } pub trait Cache { fn insert(&mut self, k: K, v: V) -> Option; fn remove(&mut self, k: &K) -> Option; fn get(&self, k: &K) -> Option<&V>; } impl Cache for HashMap where K: Hash + Eq { fn insert(&mut self, k: K, v: V) -> Option { HashMap::insert(self, k, v) } fn remove(&mut self, k: &K) -> Option { HashMap::remove(self, k) } fn get(&self, k: &K) -> Option<&V> { HashMap::get(self, k) } } /// Should be used to get database key associated with given value. pub trait Key { type Target: Deref; /// Returns db key. fn key(&self) -> Self::Target; } /// Should be used to write value into database. pub trait Writable { /// Writes the value into the database. fn write(&self, key: &Key, value: &T) where T: Encodable, R: Deref; /// Writes the value into the database and updates the cache. fn write_with_cache(&self, cache: &mut Cache, key: K, value: T, policy: CacheUpdatePolicy) where K: Key + Hash + Eq, T: Encodable, R: Deref { self.write(&key, &value); match policy { CacheUpdatePolicy::Overwrite => { cache.insert(key, value); }, CacheUpdatePolicy::Remove => { cache.remove(&key); } } } /// Writes the values into the database and updates the cache. fn extend_with_cache(&self, cache: &mut Cache, values: HashMap, policy: CacheUpdatePolicy) where K: Key + Hash + Eq, T: Encodable, R: Deref { match policy { CacheUpdatePolicy::Overwrite => { for (key, value) in values.into_iter() { self.write(&key, &value); cache.insert(key, value); } }, CacheUpdatePolicy::Remove => { for (key, value) in &values { self.write(key, value); cache.remove(key); } }, } } } /// Should be used to read values from database. pub trait Readable { /// Returns value for given key. fn read(&self, key: &Key) -> Option where T: Decodable, R: Deref; /// Returns value for given key either in cache or in database. fn read_with_cache(&self, cache: &RwLock, key: &K) -> Option where K: Key + Eq + Hash + Clone, T: Clone + Decodable, C: Cache { { let read = cache.unwrapped_read(); if let Some(v) = read.get(key) { return Some(v.clone()); } } self.read(key).map(|value: T|{ let mut write = cache.unwrapped_write(); write.insert(key.clone(), value.clone()); value }) } /// Returns true if given value exists. fn exists(&self, key: &Key) -> bool where R: Deref; /// Returns true if given value exists either in cache or in database. fn exists_with_cache(&self, cache: &RwLock, key: &K) -> bool where K: Eq + Hash + Key, R: Deref, C: Cache { { let read = cache.unwrapped_read(); if read.get(key).is_some() { return true; } } self.exists::(key) } } impl Writable for DBTransaction { fn write(&self, key: &Key, value: &T) where T: Encodable, R: Deref { let result = self.put(&key.key(), &encode(value)); if let Err(err) = result { panic!("db put failed, key: {:?}, err: {:?}", &key.key() as &[u8], err); } } } impl Readable for Database { fn read(&self, key: &Key) -> Option where T: Decodable, R: Deref { let result = self.get(&key.key()); match result { Ok(option) => option.map(|v| decode(&v)), Err(err) => { panic!("db get failed, key: {:?}, err: {:?}", &key.key() as &[u8], err); } } } fn exists(&self, key: &Key) -> bool where R: Deref { let result = self.get(&key.key()); match result { Ok(v) => v.is_some(), Err(err) => { panic!("db get failed, key: {:?}, err: {:?}", &key.key() as &[u8], err); } } } }