2 local type, pairs = type, pairs;
3 local setmetatable = setmetatable;
5 local config = require "core.configmanager";
6 local datamanager = require "util.datamanager";
7 local modulemanager = require "core.modulemanager";
8 local multitable = require "util.multitable";
10 local log = require "util.logger".init("storagemanager");
12 local prosody = prosody;
16 local olddm = {}; -- maintain old datamanager, for backwards compatibility
17 for k,v in pairs(datamanager) do olddm[k] = v; end
19 local null_storage_method = function () return false, "no data storage active"; end
20 local null_storage_driver = setmetatable(
23 open = function (self) return self; end
25 __index = function (self, method) --luacheck: ignore 212
26 return null_storage_method;
31 local stores_available = multitable.new();
33 local function initialize_host(host)
34 local host_session = hosts[host];
35 host_session.events.add_handler("item-added/storage-provider", function (event)
36 local item = event.item;
37 stores_available:set(host, item.name, item);
40 host_session.events.add_handler("item-removed/storage-provider", function (event)
41 local item = event.item;
42 stores_available:set(host, item.name, nil);
45 prosody.events.add_handler("host-activated", initialize_host, 101);
47 local function load_driver(host, driver_name)
48 if driver_name == "null" then
49 return null_storage_driver;
51 local driver = stores_available:get(host, driver_name);
52 if driver then return driver; end
53 local ok, err = modulemanager.load(host, "storage_"..driver_name);
55 log("error", "Failed to load storage driver plugin %s on %s: %s", driver_name, host, err);
57 return stores_available:get(host, driver_name);
60 local function get_storage_config(host)
61 -- COMPAT w/ unreleased Prosody 0.10 and the once-experimental mod_storage_sql2 in peoples' config files
62 local storage_config = config.get(host, "storage");
64 if storage_config == "sql2" then
65 storage_config, found_sql2 = "sql", true;
66 elseif type(storage_config) == "table" then
67 for store_name, driver_name in pairs(storage_config) do
68 if driver_name == "sql2" then
69 storage_config[store_name] = "sql";
75 log("error", "The temporary 'sql2' storage module has now been renamed to 'sql', please update your config file: https://prosody.im/doc/modules/mod_storage_sql2");
77 return storage_config;
80 local function get_driver(host, store)
81 local storage = get_storage_config(host);
83 local option_type = type(storage);
84 if option_type == "string" then
85 driver_name = storage;
86 elseif option_type == "table" then
87 driver_name = storage[store];
89 if not driver_name then
90 driver_name = config.get(host, "default_storage") or "internal";
93 local driver = load_driver(host, driver_name);
95 log("warn", "Falling back to null driver for %s storage on %s", store, host);
97 driver = null_storage_driver;
99 return driver, driver_name;
102 local function open(host, store, typ)
103 local driver, driver_name = get_driver(host, store);
104 local ret, err = driver:open(store, typ);
106 if err == "unsupported-store" then
107 log("debug", "Storage driver %s does not support store %s (%s), falling back to null driver",
108 driver_name, store, typ or "<nil>");
109 ret = null_storage_driver;
116 local function purge(user, host)
117 local storage = get_storage_config(host);
118 if type(storage) == "table" then
119 -- multiple storage backends in use that we need to purge
121 for store, driver_name in pairs(storage) do
122 if not purged[driver_name] then
123 local driver = get_driver(host, store);
125 purged[driver_name] = driver:purge(user);
127 log("warn", "Storage driver %s does not support removing all user data, you may need to delete it manually", driver_name);
132 get_driver(host):purge(user); -- and the default driver
134 olddm.purge(user, host); -- COMPAT list stores, like offline messages end up in the old datamanager
139 function datamanager.load(username, host, datastore)
140 return open(host, datastore):get(username);
142 function datamanager.store(username, host, datastore, data)
143 return open(host, datastore):set(username, data);
145 function datamanager.users(host, datastore, typ)
146 local driver = open(host, datastore, typ);
147 if not driver.users then
148 return function() log("warn", "storage driver %s does not support listing users", driver.name) end
150 return driver:users();
152 function datamanager.stores(username, host, typ)
153 return get_driver(host):stores(username, typ);
155 function datamanager.purge(username, host)
156 return purge(username, host);
160 initialize_host = initialize_host;
161 load_driver = load_driver;
162 get_driver = get_driver;