src/database/database-postgresql.h

   1 /*
   2 Minetest
   3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 #pragma once
  21
  22 #include <string>
  23 #include <libpq-fe.h>
  24 #include "database.h"
  25 #include "util/basic_macros.h"
  26
  27 class Settings;
  28
  29 class Database_PostgreSQL: public Database
  30 {
  31 public:
  32         Database_PostgreSQL(const std::string &connect_string);
  33         ~Database_PostgreSQL();
  34
  35         void beginSave();
  36         void endSave();
  37
  38         bool initialized() const;
  39
  40
  41 protected:
  42         // Conversion helpers
  43         inline int pg_to_int(PGresult *res, int row, int col)
  44         {
  45                 return atoi(PQgetvalue(res, row, col));
  46         }
  47
  48         inline u32 pg_to_uint(PGresult *res, int row, int col)
  49         {
  50                 return (u32) atoi(PQgetvalue(res, row, col));
  51         }
  52
  53         inline float pg_to_float(PGresult *res, int row, int col)
  54         {
  55                 return (float) atof(PQgetvalue(res, row, col));
  56         }
  57
  58         inline v3s16 pg_to_v3s16(PGresult *res, int row, int col)
  59         {
  60                 return v3s16(
  61                         pg_to_int(res, row, col),
  62                         pg_to_int(res, row, col + 1),
  63                         pg_to_int(res, row, col + 2)
  64                 );
  65         }
  66
  67         inline PGresult *execPrepared(const char *stmtName, const int paramsNumber,
  68                 const void **params,
  69                 const int *paramsLengths = NULL, const int *paramsFormats = NULL,
  70                 bool clear = true, bool nobinary = true)
  71         {
  72                 return checkResults(PQexecPrepared(m_conn, stmtName, paramsNumber,
  73                         (const char* const*) params, paramsLengths, paramsFormats,
  74                         nobinary ? 1 : 0), clear);
  75         }
  76
  77         inline PGresult *execPrepared(const char *stmtName, const int paramsNumber,
  78                 const char **params, bool clear = true, bool nobinary = true)
  79         {
  80                 return execPrepared(stmtName, paramsNumber,
  81                         (const void **)params, NULL, NULL, clear, nobinary);
  82         }
  83
  84         void createTableIfNotExists(const std::string &table_name, const std::string &definition);
  85         void verifyDatabase();
  86
  87         // Database initialization
  88         void connectToDatabase();
  89         virtual void createDatabase() = 0;
  90         virtual void initStatements() = 0;
  91         inline void prepareStatement(const std::string &name, const std::string &sql)
  92         {
  93                 checkResults(PQprepare(m_conn, name.c_str(), sql.c_str(), 0, NULL));
  94         }
  95
  96         const int getPGVersion() const { return m_pgversion; }
  97 private:
  98         // Database connectivity checks
  99         void ping();
 100
 101         // Database usage
 102         PGresult *checkResults(PGresult *res, bool clear = true);
 103
 104         // Attributes
 105         std::string m_connect_string;
 106         PGconn *m_conn = nullptr;
 107         int m_pgversion = 0;
 108 };
 109
 110 class MapDatabasePostgreSQL : private Database_PostgreSQL, public MapDatabase
 111 {
 112 public:
 113         MapDatabasePostgreSQL(const std::string &connect_string);
 114         virtual ~MapDatabasePostgreSQL() = default;
 115
 116         bool saveBlock(const v3s16 &pos, const std::string &data);
 117         void loadBlock(const v3s16 &pos, std::string *block);
 118         bool deleteBlock(const v3s16 &pos);
 119         void listAllLoadableBlocks(std::vector<v3s16> &dst);
 120
 121         void beginSave() { Database_PostgreSQL::beginSave(); }
 122         void endSave() { Database_PostgreSQL::endSave(); }
 123
 124 protected:
 125         virtual void createDatabase();
 126         virtual void initStatements();
 127 };
 128
 129 class PlayerDatabasePostgreSQL : private Database_PostgreSQL, public PlayerDatabase
 130 {
 131 public:
 132         PlayerDatabasePostgreSQL(const std::string &connect_string);
 133         virtual ~PlayerDatabasePostgreSQL() = default;
 134
 135         void savePlayer(RemotePlayer *player);
 136         bool loadPlayer(RemotePlayer *player, PlayerSAO *sao);
 137         bool removePlayer(const std::string &name);
 138         void listPlayers(std::vector<std::string> &res);
 139
 140 protected:
 141         virtual void createDatabase();
 142         virtual void initStatements();
 143
 144 private:
 145         bool playerDataExists(const std::string &playername);
 146 };