libdballe  8.3
db/db.h
Go to the documentation of this file.
1 #ifndef DBALLE_DB_DB_H
2 #define DBALLE_DB_DB_H
3 
4 #include <dballe/fwd.h>
5 #include <dballe/core/cursor.h>
6 #include <dballe/db.h>
7 #include <dballe/db/fwd.h>
8 #include <dballe/db/defs.h>
9 #include <dballe/msg/fwd.h>
10 #include <dballe/sql/fwd.h>
11 #include <wreport/varinfo.h>
12 #include <wreport/var.h>
13 #include <string>
14 #include <memory>
15 #include <functional>
16 
23 namespace dballe {
24 
25 namespace impl {
26 
29 {
30  DBImportOptions() = default;
31  DBImportOptions(const DBImportOptions& o) = default;
32  DBImportOptions(DBImportOptions&& o) = default;
33  DBImportOptions& operator=(const DBImportOptions&) = default;
34  DBImportOptions& operator=(DBImportOptions&&) = default;
35 };
36 
39 {
40  DBInsertOptions() = default;
41  DBInsertOptions(const DBInsertOptions& o) = default;
42  DBInsertOptions(DBInsertOptions&& o) = default;
43  DBInsertOptions& operator=(const DBInsertOptions&) = default;
44  DBInsertOptions& operator=(DBInsertOptions&&) = default;
45 };
46 
47 }
48 
49 namespace db {
50 
52 std::string format_format(Format format);
53 
55 Format format_parse(const std::string& str);
56 
57 
59 {
61  virtual void remove() = 0;
62 
68  virtual unsigned test_iterate(FILE* dump=0) = 0;
69 };
70 
72 {
74  virtual void remove() = 0;
75 
77  virtual std::shared_ptr<db::Transaction> get_transaction() const = 0;
78 
83  virtual int attr_reference_id() const = 0;
84 
88  virtual void query_attrs(std::function<void(std::unique_ptr<wreport::Var>)> dest, bool force_read=false) = 0;
89 
91  virtual void insert_attrs(const Values& attrs);
92 
94  virtual void remove_attrs(const db::AttrList& attrs);
95 
101  virtual unsigned test_iterate(FILE* dump=0) = 0;
102 };
103 
105 {
107  virtual void remove() = 0;
108 
110  virtual std::shared_ptr<db::Transaction> get_transaction() const = 0;
111 
116  virtual int attr_reference_id() const = 0;
117 
121  virtual void query_attrs(std::function<void(std::unique_ptr<wreport::Var>)> dest, bool force_read=false) = 0;
122 
124  virtual void insert_attrs(const Values& attrs);
125 
127  virtual void remove_attrs(const db::AttrList& attrs);
128 
134  virtual unsigned test_iterate(FILE* dump=0) = 0;
135 };
136 
138 {
140  virtual void remove() = 0;
141 
147  virtual unsigned test_iterate(FILE* dump=0) = 0;
148 };
149 
150 
152 {
153 public:
154  virtual ~Transaction() {}
155 
163  virtual void clear_cached_state() = 0;
164 
173  virtual void attr_query_station(int data_id, std::function<void(std::unique_ptr<wreport::Var>)> dest) = 0;
174 
183  virtual void attr_query_data(int data_id, std::function<void(std::unique_ptr<wreport::Var>)> dest) = 0;
184 
193  virtual void attr_insert_station(int data_id, const Values& attrs) = 0;
194 
203  virtual void attr_insert_data(int data_id, const Values& attrs) = 0;
204 
214  virtual void attr_remove_station(int data_id, const db::AttrList& attrs) = 0;
215 
225  virtual void attr_remove_data(int data_id, const db::AttrList& attrs) = 0;
226 
244  virtual void update_repinfo(const char* repinfo_file, int* added, int* deleted, int* updated) = 0;
245 
249  virtual void dump(FILE* out) = 0;
250 };
251 
252 class DB: public dballe::DB
253 {
254 public:
255  static db::Format get_default_format();
256  static void set_default_format(db::Format format);
257 
264  static std::shared_ptr<DB> connect_from_file(const char* pathname);
265 
269  static std::shared_ptr<DB> connect_memory();
270 
274  static std::shared_ptr<DB> create(std::unique_ptr<sql::Connection> conn);
275 
284  static bool is_url(const char* str);
285 
287  virtual db::Format format() const = 0;
288 
295  virtual void disappear() = 0;
296 
308  virtual void reset(const char* repinfo_file=0) = 0;
309 
314  virtual std::shared_ptr<dballe::db::Transaction> test_transaction(bool readonly=false) = 0;
315 
325  virtual void vacuum() = 0;
326 
335  virtual void attr_query_station(int data_id, std::function<void(std::unique_ptr<wreport::Var>)>&& dest);
336 
345  virtual void attr_query_data(int data_id, std::function<void(std::unique_ptr<wreport::Var>)>&& dest);
346 
355  void attr_insert_station(int data_id, const Values& attrs);
356 
365  void attr_insert_data(int data_id, const Values& attrs);
366 
376  void attr_remove_station(int data_id, const db::AttrList& attrs);
377 
387  void attr_remove_data(int data_id, const db::AttrList& attrs);
388 
392  void dump(FILE* out);
393 
395  virtual void print_info(FILE* out);
396 
398  static const char* default_repinfo_file();
399 
401  inline static std::unique_ptr<db::DB> downcast(std::unique_ptr<dballe::DB> db)
402  {
403  db::DB* res = dynamic_cast<db::DB*>(db.get());
404  if (!res) throw std::runtime_error("Attempted to downcast the wrong kind of DB");
405  db.release();
406  return std::unique_ptr<db::DB>(res);
407  }
408 
410  inline static std::shared_ptr<db::DB> downcast(std::shared_ptr<dballe::DB> db)
411  {
412  auto res = std::dynamic_pointer_cast<db::DB>(db);
413  if (!res) throw std::runtime_error("Attempted to downcast the wrong kind of DB");
414  return res;
415  }
416 };
417 
418 }
419 }
420 #endif
Forward declarations for public dballe/sql names.
Options controlling how values are inserted in the database.
Definition: db.h:120
Definition: db/db.h:137
Definition: db.h:146
Definition: db/db.h:71
DBInsertOptions with public constructor and copy, safe to use in dballe code but not accessible from ...
Definition: db/db.h:38
Cursor iterating over station data values.
Definition: core/cursor.h:27
Definition: db.h:296
Definition: cmdline.h:18
static std::shared_ptr< db::DB > downcast(std::shared_ptr< dballe::DB > db)
Downcast a shared_ptr pointer.
Definition: db/db.h:410
Definition: db/db.h:252
Definition: db/db.h:58
Definition: db/db.h:104
Definition: db/db.h:151
static std::unique_ptr< db::DB > downcast(std::unique_ptr< dballe::DB > db)
Downcast a unique_ptr pointer.
Definition: db/db.h:401
Cursor iterating over stations.
Definition: core/cursor.h:12
DBImportOptions with public constructor and copy, safe to use in dballe code but not accessible from ...
Definition: db/db.h:28
Cursor iterating over data values.
Definition: core/cursor.h:42
Cursor iterating over summary entries.
Definition: core/cursor.h:57
Collection of Value objects, indexed by wreport::Varcode.
Definition: values.h:176
Options controlling how messages are imported in the database.
Definition: db.h:63