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         virtual void pingDatabase();
  36
  37         void beginSave();
  38         void endSave();
  39
  40         bool initialized() const;
  41
  42 protected:
  43         // Conversion helpers
  44         inline int pg_to_int(PGresult *res, int row, int col)
  45         {
  46                 return atoi(PQgetvalue(res, row, col));
  47         }
  48
  49         inline u32 pg_to_uint(PGresult *res, int row, int col)
  50         {
  51                 return (u32) atoi(PQgetvalue(res, row, col));
  52         }
  53
  54         inline float pg_to_float(PGresult *res, int row, int col)
  55         {
  56                 return (float) atof(PQgetvalue(res, row, col));
  57         }
  58
  59         inline v3s16 pg_to_v3s16(PGresult *res, int row, int col)
  60         {
  61                 return v3s16(
  62                         pg_to_int(res, row, col),
  63                         pg_to_int(res, row, col + 1),
  64                         pg_to_int(res, row, col + 2)
  65                 );
  66         }
  67
  68         inline PGresult *execPrepared(const char *stmtName, const int paramsNumber,
  69                 const void **params,
  70                 const int *paramsLengths = NULL, const int *paramsFormats = NULL,
  71                 bool clear = true, bool nobinary = true)
  72         {
  73                 return checkResults(PQexecPrepared(m_conn, stmtName, paramsNumber,
  74                         (const char* const*) params, paramsLengths, paramsFormats,
  75                         nobinary ? 1 : 0), clear);
  76         }
  77
  78         inline PGresult *execPrepared(const char *stmtName, const int paramsNumber,
  79                 const char **params, bool clear = true, bool nobinary = true)
  80         {
  81                 return execPrepared(stmtName, paramsNumber,
  82                         (const void **)params, NULL, NULL, clear, nobinary);
  83         }
  84
  85         void createTableIfNotExists(const std::string &table_name, const std::string &definition);
  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         virtual void pingDatabase() { Database_PostgreSQL::pingDatabase(); }
 117
 118         bool saveBlock(const v3s16 &pos, const std::string &data);
 119         void loadBlock(const v3s16 &pos, std::string *block);
 120         bool deleteBlock(const v3s16 &pos);
 121         void listAllLoadableBlocks(std::vector<v3s16> &dst);
 122
 123         void beginSave() { Database_PostgreSQL::beginSave(); }
 124         void endSave() { Database_PostgreSQL::endSave(); }
 125
 126 protected:
 127         virtual void createDatabase();
 128         virtual void initStatements();
 129 };
 130
 131 class PlayerDatabasePostgreSQL : private Database_PostgreSQL, public PlayerDatabase
 132 {
 133 public:
 134         PlayerDatabasePostgreSQL(const std::string &connect_string);
 135         virtual ~PlayerDatabasePostgreSQL() = default;
 136
 137         virtual void pingDatabase() { Database_PostgreSQL::pingDatabase(); }
 138
 139         void savePlayer(RemotePlayer *player);
 140         bool loadPlayer(RemotePlayer *player, PlayerSAO *sao);
 141         bool removePlayer(const std::string &name);
 142         void listPlayers(std::vector<std::string> &res);
 143
 144 protected:
 145         virtual void createDatabase();
 146         virtual void initStatements();
 147
 148 private:
 149         bool playerDataExists(const std::string &playername);
 150 };