src/modules/m_sqlutils.cpp

   1 /*       +------------------------------------+
   2  *       | Inspire Internet Relay Chat Daemon |
   3  *       +------------------------------------+
   4  *
   5  *  InspIRCd: (C) 2002-2009 InspIRCd Development Team
   6  * See: http://wiki.inspircd.org/Credits
   7  *
   8  * This program is free but copyrighted software; see
   9  *            the file COPYING for details.
  10  *
  11  * ---------------------------------------------------
  12  */
  13
  14 #include "inspircd.h"
  15 #include <sstream>
  16 #include <list>
  17 #include "m_sqlutils.h"
  18
  19 /* $ModDesc: Provides some utilities to SQL client modules, such as mapping queries to users and channels */
  20 /* $ModDep: m_sqlutils.h */
  21
  22 typedef std::map<unsigned long, User*> IdUserMap;
  23 typedef std::map<unsigned long, Channel*> IdChanMap;
  24 typedef std::list<unsigned long> AssocIdList;
  25
  26 class ModuleSQLutils : public Module
  27 {
  28 private:
  29         IdUserMap iduser;
  30         IdChanMap idchan;
  31         SimpleExtItem<AssocIdList> idExt;
  32
  33 public:
  34         ModuleSQLutils() : idExt("sqlutils_list", this)
  35         {
  36                 ServerInstance->Modules->PublishInterface("SQLutils", this);
  37                 Implementation eventlist[] = { I_OnChannelDelete, I_OnUnloadModule, I_OnUserDisconnect };
  38                 ServerInstance->Modules->Attach(eventlist, this, 3);
  39         }
  40
  41         ~ModuleSQLutils()
  42         {
  43                 ServerInstance->Modules->UnpublishInterface("SQLutils", this);
  44         }
  45
  46
  47         void OnRequest(Request& request)
  48         {
  49                 if(strcmp(SQLUTILAU, request.id) == 0)
  50                 {
  51                         AssociateUser* req = (AssociateUser*)&request;
  52
  53                         iduser.insert(std::make_pair(req->id, req->user));
  54
  55                         AttachList(req->user, req->id);
  56                 }
  57                 else if(strcmp(SQLUTILAC, request.id) == 0)
  58                 {
  59                         AssociateChan* req = (AssociateChan*)&request;
  60
  61                         idchan.insert(std::make_pair(req->id, req->chan));
  62
  63                         AttachList(req->chan, req->id);
  64                 }
  65                 else if(strcmp(SQLUTILUA, request.id) == 0)
  66                 {
  67                         UnAssociate* req = (UnAssociate*)&request;
  68
  69                         /* Unassociate a given query ID with all users and channels
  70                          * it is associated with.
  71                          */
  72
  73                         DoUnAssociate(iduser, req->id);
  74                         DoUnAssociate(idchan, req->id);
  75                 }
  76                 else if(strcmp(SQLUTILGU, request.id) == 0)
  77                 {
  78                         GetAssocUser* req = (GetAssocUser*)&request;
  79
  80                         IdUserMap::iterator iter = iduser.find(req->id);
  81
  82                         if(iter != iduser.end())
  83                         {
  84                                 req->user = iter->second;
  85                         }
  86                 }
  87                 else if(strcmp(SQLUTILGC, request.id) == 0)
  88                 {
  89                         GetAssocChan* req = (GetAssocChan*)&request;
  90
  91                         IdChanMap::iterator iter = idchan.find(req->id);
  92
  93                         if(iter != idchan.end())
  94                         {
  95                                 req->chan = iter->second;
  96                         }
  97                 }
  98         }
  99
 100         void OnUserDisconnect(User* user)
 101         {
 102                 /* A user is disconnecting, first we need to check if they have a list of queries associated with them.
 103                  * Then, if they do, we need to erase each of them from our IdUserMap (iduser) so when the module that
 104                  * associated them asks to look them up then it gets a NULL result and knows to discard the query.
 105                  */
 106                 AssocIdList* il = idExt.get(user);
 107
 108                 if(il)
 109                 {
 110                         for(AssocIdList::iterator listiter = il->begin(); listiter != il->end(); listiter++)
 111                         {
 112                                 IdUserMap::iterator iter;
 113
 114                                 iter = iduser.find(*listiter);
 115
 116                                 if(iter != iduser.end())
 117                                 {
 118                                         if(iter->second != user)
 119                                         {
 120                                                 ServerInstance->Logs->Log("m_sqlutils",DEBUG, "BUG: ID associated with user %s doesn't have the same User* associated with it in the map (erasing anyway)", user->nick.c_str());
 121                                         }
 122
 123                                         iduser.erase(iter);
 124                                 }
 125                                 else
 126                                 {
 127                                         ServerInstance->Logs->Log("m_sqlutils",DEBUG, "BUG: user %s was extended with sqlutils_queryids but there was nothing matching in the map", user->nick.c_str());
 128                                 }
 129                         }
 130
 131                         idExt.unset(user);
 132                 }
 133         }
 134
 135         void AttachList(Extensible* obj, unsigned long id)
 136         {
 137                 AssocIdList* il = idExt.get(obj);
 138
 139                 if (!il)
 140                 {
 141                         /* Doesn't already exist, create a new list and attach it. */
 142                         il = new AssocIdList;
 143                         idExt.set(obj, il);
 144                 }
 145
 146                 /* Now either way we have a valid list in il, attached. */
 147                 il->push_back(id);
 148         }
 149
 150         void RemoveFromList(Extensible* obj, unsigned long id)
 151         {
 152                 AssocIdList* il = idExt.get(obj);
 153
 154                 if (il)
 155                 {
 156                         /* Only do anything if the list exists... (which it ought to) */
 157                         il->remove(id);
 158
 159                         if(il->empty())
 160                         {
 161                                 /* If we just emptied it.. */
 162                                 idExt.unset(obj);
 163                         }
 164                 }
 165         }
 166
 167         template <class T> void DoUnAssociate(T &map, unsigned long id)
 168         {
 169                 /* For each occurence of 'id' (well, only one..it's not a multimap) in 'map'
 170                  * remove it from the map, take an Extensible* value from the map and remove
 171                  * 'id' from the list of query IDs attached to it.
 172                  */
 173                 typename T::iterator iter = map.find(id);
 174
 175                 if(iter != map.end())
 176                 {
 177                         /* Found a value indexed by 'id', call RemoveFromList()
 178                          * on it with 'id' to remove 'id' from the list attached
 179                          * to the value.
 180                          */
 181                         RemoveFromList(iter->second, id);
 182                 }
 183         }
 184
 185         void OnChannelDelete(Channel* chan)
 186         {
 187                 /* A channel is being destroyed, first we need to check if it has a list of queries associated with it.
 188                  * Then, if it does, we need to erase each of them from our IdChanMap (idchan) so when the module that
 189                  * associated them asks to look them up then it gets a NULL result and knows to discard the query.
 190                  */
 191                 AssocIdList* il = idExt.get(chan);
 192
 193                 if (il)
 194                 {
 195                         for(AssocIdList::iterator listiter = il->begin(); listiter != il->end(); listiter++)
 196                         {
 197                                 IdChanMap::iterator iter;
 198
 199                                 iter = idchan.find(*listiter);
 200
 201                                 if(iter != idchan.end())
 202                                 {
 203                                         if(iter->second != chan)
 204                                         {
 205                                                 ServerInstance->Logs->Log("m_sqlutils",DEBUG, "BUG: ID associated with channel %s doesn't have the same Channel* associated with it in the map (erasing anyway)", chan->name.c_str());
 206                                         }
 207                                         idchan.erase(iter);
 208                                 }
 209                                 else
 210                                 {
 211                                         ServerInstance->Logs->Log("m_sqlutils",DEBUG, "BUG: channel %s was extended with sqlutils_queryids but there was nothing matching in the map", chan->name.c_str());
 212                                 }
 213                         }
 214
 215                         idExt.unset(chan);
 216                 }
 217         }
 218
 219         Version GetVersion()
 220         {
 221                 return Version("Provides some utilities to SQL client modules, such as mapping queries to users and channels", VF_VENDOR);
 222         }
 223
 224 };
 225
 226 MODULE_INIT(ModuleSQLutils)