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 
63  virtual bool
64  isOpen() = 0;
65 
69  virtual void
70  close() = 0;
71 
80  virtual Status
81  fetch(void const* key, std::shared_ptr<NodeObject>* pObject) = 0;
82 
89  virtual void
90  store(std::shared_ptr<NodeObject> const& object) = 0;
91 
96  virtual void
97  storeBatch(Batch const& batch) = 0;
98 
105  virtual void
107 
109  virtual int
110  getWriteLoad() = 0;
111 
113  virtual void
114  setDeletePath() = 0;
115 
117  virtual void
118  verify() = 0;
119 
121  virtual int
122  fdRequired() const = 0;
123 
125  bool
126  backed() const
127  {
128  return fdRequired();
129  }
130 };
131 
132 } // namespace NodeStore
133 } // namespace ripple
134 
135 #endif
ripple::NodeStore::Backend::backed
bool backed() const
Returns true if the backend uses permanent storage.
Definition: Backend.h:126
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< std::shared_ptr< NodeObject > >
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::Backend::isOpen
virtual bool isOpen()=0
Returns true is the database is open.
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::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