2005-04-17 20:08:34 +02:00
|
|
|
%%%----------------------------------------------------------------------
|
2007-12-24 14:57:53 +01:00
|
|
|
%%%
|
2011-02-14 13:47:22 +01:00
|
|
|
%%% ejabberd, Copyright (C) 2002-2011 ProcessOne
|
2007-12-24 14:57:53 +01:00
|
|
|
%%%
|
|
|
|
%%% This program is free software; you can redistribute it and/or
|
|
|
|
%%% modify it under the terms of the GNU General Public License as
|
|
|
|
%%% published by the Free Software Foundation; either version 2 of the
|
|
|
|
%%% License, or (at your option) any later version.
|
|
|
|
%%%
|
|
|
|
%%% This program is distributed in the hope that it will be useful,
|
|
|
|
%%% but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
%%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
%%% General Public License for more details.
|
2009-01-19 15:47:33 +01:00
|
|
|
%%%
|
2007-12-24 14:57:53 +01:00
|
|
|
%%% You should have received a copy of the GNU General Public License
|
|
|
|
%%% along with this program; if not, write to the Free Software
|
|
|
|
%%% Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
|
|
%%% 02111-1307 USA
|
|
|
|
%%%
|
2005-04-17 20:08:34 +02:00
|
|
|
%%%----------------------------------------------------------------------
|
|
|
|
|
|
|
|
-record(roster, {usj,
|
|
|
|
us,
|
|
|
|
jid,
|
2009-01-08 15:54:00 +01:00
|
|
|
name = <<>>,
|
2005-04-17 20:08:34 +02:00
|
|
|
subscription = none,
|
|
|
|
ask = none,
|
|
|
|
groups = [],
|
2008-08-26 15:59:04 +02:00
|
|
|
askmessage = <<>>,
|
2005-04-17 20:08:34 +02:00
|
|
|
xs = []}).
|
|
|
|
|
Support for roster versioning (EJAB-964)
Introduces two options for mod_roster and mod_roster_odbc:
- {versioning, true | false} Enable or disable roster versioning on ejabberd.
- {store_current_id, true | false} If true, the current roster version is stored on DB (internal or odbc). Otherwise it is calculated on the fly each time.
Performance:
Setting store_current_id to true should help in reducing the load for both ejabberd and the DB.
Details:
If store_current_id is false, the roster version is a hash of the entire roster. If store_current_id is true, the roster version is a hash, but of the current time
(this has to do with transactional semantics; we need to perform both the roster update and the version update on the same transaction, but we don't
have the entire roster when we are changing a single item on DB. Loading it there requires significant changes to be introduced, so I opted for this simpler approach).
In either case, there is no difference for the clients, the roster version ID is opaque.
IMPORTANT:
mod_shared_roster is not compatible with the option 'store_current_id'. Shared roster and roster versioning can be both enabled, but store_current_id MUST be set to false.
SVN Revision: 2428
2009-08-06 17:45:13 +02:00
|
|
|
-record(roster_version, {us,
|
|
|
|
version}).
|
2010-07-22 18:49:12 +02:00
|
|
|
|
|
|
|
%% @type rosteritem() = {roster, USJ, US, Contact_JID, Name, Subscription, Ask, Groups, Askmessage, Xs}
|
|
|
|
%% USJ = {LUser, LServer, Prepd_Contact_JID}
|
|
|
|
%% LUser = binary()
|
|
|
|
%% LServer = binary()
|
|
|
|
%% Prepd_Contact_JID = jlib:shortjid()
|
|
|
|
%% US = {LUser, LServer}
|
|
|
|
%% Contact_JID = jlib:shortjid()
|
|
|
|
%% Name = binary()
|
|
|
|
%% Subscription = none | to | from | both
|
|
|
|
%% Ask = none | out | in | both
|
|
|
|
%% Groups = [binary()]
|
|
|
|
%% Askmessage = binary()
|
|
|
|
%% Xs = [exmpp_xml:xmlel()]
|
|
|
|
|
|
|
|
%% TODO: keep a non-prepped jid like in mnesia mod_roster?
|
|
|
|
-record(rosteritem, {user_host_jid,
|
|
|
|
name = <<"">>,
|
|
|
|
subscription = none,
|
|
|
|
ask = none,
|
|
|
|
askmessage = <<"">>}).
|
|
|
|
-record(rostergroup, {user_host_jid,
|
|
|
|
grp}).
|