kworship/bible/KwBibleManagerBibleGateway.cpp

   1 /***************************************************************************
   2  *   This file is part of KWorship.                                        *
   3  *   Copyright 2008 James Hogan <james@albanarts.com>                      *
   4  *                                                                         *
   5  *   KWorship is free software: you can redistribute it and/or modify      *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation, either version 2 of the License, or     *
   8  *   (at your option) any later version.                                   *
   9  *                                                                         *
  10  *   KWorship 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 General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with KWorship.  If not, write to the Free Software Foundation,  *
  17  *   Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.   *
  18  ***************************************************************************/
  19
  20 /**
  21  * @file KwBibleManagerBibleGateway.cpp
  22  * @brief A bible manager for BibleGateway.com.
  23  * @author James Hogan <james@albanarts.com>
  24  */
  25
  26 #include "KwBibleManagerBibleGateway.h"
  27 #include "KwBibleModuleBibleGateway.h"
  28
  29 #include <KIO/NetAccess>
  30 #include <KMessageBox>
  31
  32 #include <QFile>
  33 #include <QDomDocument>
  34 #include <QDomElement>
  35 #include <QDomNodeList>
  36
  37 /*
  38  * Constructors + destructor
  39  */
  40
  41 /// Default constructor.
  42 KwBibleManagerBibleGateway::KwBibleManagerBibleGateway()
  43 : KwBibleManager()
  44 , m_cached(false)
  45 , m_languages()
  46 , m_versionsById()
  47 , m_versionsByName()
  48 , m_versionsByLanguage()
  49 {
  50 }
  51
  52 /// Destructor.
  53 KwBibleManagerBibleGateway::~KwBibleManagerBibleGateway()
  54 {
  55   foreach (Version* version, m_versionsById)
  56   {
  57     delete version->module;
  58     delete version;
  59   }
  60 }
  61
  62 /*
  63  * Main interface
  64  */
  65
  66 QString KwBibleManagerBibleGateway::name() const
  67 {
  68   return "BibleGateway.com";
  69 }
  70
  71 bool KwBibleManagerBibleGateway::isRemote() const
  72 {
  73   return true;
  74 }
  75
  76 KwBibleModule* KwBibleManagerBibleGateway::module(const QString& name)
  77 {
  78   QHash<QString, Version*>::iterator it = m_versionsByName.find(name);
  79   Version* version = 0;
  80   // Does the module with this name exist?
  81   if (it != m_versionsByName.end())
  82   {
  83     version = *it;
  84   }
  85   // Otherwise perhaps its a language
  86   else
  87   {
  88     int langId = m_languages.indexOf(name);
  89     if (-1 != langId)
  90     {
  91       // Just get the first module of this language
  92       const QList<int>& moduleIds = m_versionsByLanguage[langId];
  93       if (!moduleIds.isEmpty())
  94       {
  95         int id = moduleIds.first();
  96         version = m_versionsById[id];
  97       }
  98     }
  99   }
 100   if (0 != version)
 101   {
 102     if (0 == version->module)
 103     {
 104       version->module = new KwBibleModuleBibleGateway(version->id);
 105     }
 106     return version->module;
 107   }
 108   else
 109   {
 110     return 0;
 111   }
 112 }
 113
 114 QStringList KwBibleManagerBibleGateway::moduleNames()
 115 {
 116   ensureCached();
 117   return m_versionsByName.keys();
 118 }
 119
 120 QStringList KwBibleManagerBibleGateway::moduleNamesInLanguage(const QString& lang)
 121 {
 122   ensureCached();
 123   int languageId = m_languages.indexOf(lang);
 124   QStringList names;
 125   if (languageId >= 0)
 126   {
 127     const QList<int>& moduleIds = m_versionsByLanguage[languageId];
 128     foreach (int id, moduleIds)
 129     {
 130       names << m_versionsById[id]->name;
 131     }
 132   }
 133   return names;
 134 }
 135
 136 QStringList KwBibleManagerBibleGateway::languages()
 137 {
 138   ensureCached();
 139   return m_languages;
 140 }
 141
 142 /*
 143  * Private functions
 144  */
 145
 146 /// Ensure the version information is cached.
 147 void KwBibleManagerBibleGateway::ensureCached()
 148 {
 149   if (!m_cached)
 150   {
 151     QString tmpFile;
 152     if (KIO::NetAccess::download(KUrl("http://www.biblegateway.com/"), tmpFile, 0))
 153     {
 154       QFile file(tmpFile);
 155       if (file.open(QFile::ReadOnly | QFile::Text))
 156       {
 157         QByteArray rawPage = file.readAll();
 158         file.close();
 159         QString page = QString::fromUtf8(rawPage);
 160         QRegExp rx("<select\\s+name=\"qs_version\">.*</select>");
 161         if (-1 != rx.indexIn(page))
 162         {
 163           QDomDocument dom;
 164           if (dom.setContent(rx.cap(), false))
 165           {
 166             // Go through all the options (languages and versions)
 167             int langId = -1;
 168             QList<int>* langMods = 0;
 169             QDomNodeList options = dom.elementsByTagName("option");
 170             for (int i = 0; i < options.count(); ++i)
 171             {
 172               QDomElement el = options.at(i).toElement();
 173               if (!el.isNull())
 174               {
 175                 // Its either a language (with class="lang") or a version
 176                 QString className = el.attribute("class");
 177                 QString text = el.text();
 178                 if (className == "lang")
 179                 {
 180                   m_languages << text;
 181                   ++langId;
 182                   langMods = &m_versionsByLanguage[langId];
 183                 }
 184                 else if (langId >= 0)
 185                 {
 186                   bool ok;
 187                   int versionId = el.attribute("value").toInt(&ok);
 188                   if (ok)
 189                   {
 190                     // Ensure there is none with this id already
 191                     QHash<int, Version*>::const_iterator it = m_versionsById.constFind(versionId);
 192                     if (it == m_versionsById.constEnd())
 193                     {
 194                       Version* version = new Version;
 195                       version->name = text;
 196                       version->id = versionId;
 197                       version->module = 0;
 198                       m_versionsById[versionId] = version;
 199                       m_versionsByName[text] = version;
 200                       *langMods << versionId;
 201                     }
 202                   }
 203                 }
 204               }
 205             }
 206             m_cached = true;
 207           }
 208         }
 209       }
 210
 211       KIO::NetAccess::removeTempFile(tmpFile);
 212     }
 213     else
 214     {
 215       KMessageBox::error(0, KIO::NetAccess::lastErrorString());
 216     }
 217   }
 218 }
 219
 220 /// Clear all modules.
 221 void KwBibleManagerBibleGateway::clear()
 222 {
 223   if (m_cached)
 224   {
 225     foreach (Version* version, m_versionsById)
 226     {
 227       delete version->module;
 228       delete version;
 229     }
 230     m_cached = false;
 231     m_languages.clear();
 232     m_versionsById.clear();
 233     m_versionsByName.clear();
 234     m_versionsByLanguage.clear();
 235   }
 236 }
 237