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
52  getName() = 0;
53 
58  virtual void
59  open(bool createIfMissing = true) = 0;
60 
64  virtual void
65  close() = 0;
66 
75  virtual Status
76  fetch(void const* key, std::shared_ptr<NodeObject>* pObject) = 0;
77 
79  virtual bool
80  canFetchBatch() = 0;
81 
84  fetchBatch(std::size_t n, void const* const* keys) = 0;
85 
92  virtual void
93  store(std::shared_ptr<NodeObject> const& object) = 0;
94 
99  virtual void
100  storeBatch(Batch const& batch) = 0;
101 
108  virtual void
110 
112  virtual int
113  getWriteLoad() = 0;
114 
116  virtual void
117  setDeletePath() = 0;
118 
120  virtual void
121  verify() = 0;
122 
124  virtual int
125  fdRequired() const = 0;
126 
128  bool
129  backed() const
130  {
131  return fdRequired();
132  }
133 };
134 
135 } // namespace NodeStore
136 } // namespace ripple
137 
138 #endif
ripple::NodeStore::Backend::backed
bool backed() const
Returns true if the backend uses permanent storage.
Definition: Backend.h:129
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:44
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