rippled
Backend.h
1 //------------------------------------------------------------------------------
2 /*
3  This file is part of rippled: https://github.com/ripple/rippled
4  Copyright (c) 2012, 2013 Ripple Labs Inc.
5 
6  Permission to use, copy, modify, and/or distribute this software for any
7  purpose with or without fee is hereby granted, provided that the above
8  copyright notice and this permission notice appear in all copies.
9 
10  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16  OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 */
18 //==============================================================================
19 
20 #ifndef RIPPLE_NODESTORE_BACKEND_H_INCLUDED
21 #define RIPPLE_NODESTORE_BACKEND_H_INCLUDED
22 
23 #include <ripple/nodestore/Types.h>
24 
25 namespace ripple {
26 namespace NodeStore {
27 
37 class Backend
38 {
39 public:
46  virtual ~Backend() = default;
47 
51  virtual std::string getName() = 0;
52 
57  virtual void open(bool createIfMissing = true) = 0;
58 
62  virtual void close() = 0;
63 
72  virtual Status fetch (void const* key, std::shared_ptr<NodeObject>* pObject) = 0;
73 
75  virtual
76  bool
77  canFetchBatch() = 0;
78 
80  virtual
82  fetchBatch (std::size_t n, void const* const* keys) = 0;
83 
90  virtual void store (std::shared_ptr<NodeObject> const& object) = 0;
91 
96  virtual void storeBatch (Batch const& batch) = 0;
97 
104  virtual void for_each (std::function <void (std::shared_ptr<NodeObject>)> f) = 0;
105 
107  virtual int getWriteLoad () = 0;
108 
110  virtual void setDeletePath() = 0;
111 
113  virtual void verify() = 0;
114 
116  virtual int fdRequired() const = 0;
117 
119  bool
120  backed() const
121  {
122  return fdRequired();
123  }
124 };
125 
126 }
127 }
128 
129 #endif
ripple::NodeStore::Backend::backed
bool backed() const
Returns true if the backend uses permanent storage.
Definition: Backend.h:120
std::string
STL class.
std::shared_ptr< NodeObject >
ripple::NodeStore::Backend::getWriteLoad
virtual int getWriteLoad()=0
Estimate the number of write operations pending.
std::vector
STL class.
std::function
ripple::NodeStore::Backend::store
virtual void store(std::shared_ptr< NodeObject > const &object)=0
Store a single object.
ripple::NodeStore::Backend::close
virtual void close()=0
Close the backend.
ripple::NodeStore::Backend::for_each
virtual void for_each(std::function< void(std::shared_ptr< NodeObject >)> f)=0
Visit every object in the database This is usually called during import.
ripple::NodeStore::Backend::~Backend
virtual ~Backend()=default
Destroy the backend.
ripple::NodeStore::Status
Status
Return codes from Backend operations.
Definition: nodestore/Types.h:45
ripple::NodeStore::Backend::setDeletePath
virtual void setDeletePath()=0
Remove contents on disk upon destruction.
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: RCLCensorshipDetector.h:29
ripple::NodeStore::Backend::fdRequired
virtual int fdRequired() const =0
Returns the number of file descriptors the backend expects to need.
ripple::NodeStore::Backend::getName
virtual std::string getName()=0
Get the human-readable name of this backend.
ripple::NodeStore::Backend::fetchBatch
virtual std::vector< std::shared_ptr< NodeObject > > fetchBatch(std::size_t n, void const *const *keys)=0
Fetch a batch synchronously.
std::size_t
ripple::NodeStore::Backend::canFetchBatch
virtual bool canFetchBatch()=0
Return true if batch fetches are optimized.
ripple::NodeStore::Backend::storeBatch
virtual void storeBatch(Batch const &batch)=0
Store a group of objects.
ripple::NodeStore::Backend::open
virtual void open(bool createIfMissing=true)=0
Open the backend.
ripple::NodeStore::Backend::verify
virtual void verify()=0
Perform consistency checks on database.
ripple::NodeStore::Backend::fetch
virtual Status fetch(void const *key, std::shared_ptr< NodeObject > *pObject)=0
Fetch a single object.
ripple::NodeStore::Backend
A backend used for the NodeStore.
Definition: Backend.h:37