File indexing completed on 2024-05-12 05:09:31

0001 /***************************************************************************
0002     Copyright (C) 2005-2020 Robby Stephenson <robby@periapsis.org>
0003  ***************************************************************************/
0004 
0005 /***************************************************************************
0006  *                                                                         *
0007  *   This program is free software; you can redistribute it and/or         *
0008  *   modify it under the terms of the GNU General Public License as        *
0009  *   published by the Free Software Foundation; either version 2 of        *
0010  *   the License or (at your option) version 3 or any later version        *
0011  *   accepted by the membership of KDE e.V. (or its successor approved     *
0012  *   by the membership of KDE e.V.), which shall act as a proxy            *
0013  *   defined in Section 14 of version 3 of the license.                    *
0014  *                                                                         *
0015  *   This program is distributed in the hope that it will be useful,       *
0016  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
0017  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
0018  *   GNU General Public License for more details.                          *
0019  *                                                                         *
0020  *   You should have received a copy of the GNU General Public License     *
0021  *   along with this program.  If not, see <http://www.gnu.org/licenses/>. *
0022  *                                                                         *
0023  ***************************************************************************/
0024 
0025 #ifndef TELLICO_ENTREZFETCHER_H
0026 #define TELLICO_ENTREZFETCHER_H
0027 
0028 #include "fetcher.h"
0029 #include "configwidget.h"
0030 
0031 #include <QPointer>
0032 #include <QElapsedTimer>
0033 
0034 class QLineEdit;
0035 
0036 class KJob;
0037 namespace KIO {
0038   class StoredTransferJob;
0039 }
0040 
0041 namespace Tellico {
0042 
0043   class XSLTHandler;
0044 
0045   namespace Fetch {
0046 
0047 /**
0048  * @author Robby Stephenson
0049  */
0050 class EntrezFetcher : public Fetcher {
0051 Q_OBJECT
0052 
0053 public:
0054   EntrezFetcher(QObject* parent);
0055   /**
0056    */
0057   virtual ~EntrezFetcher();
0058 
0059   virtual QString source() const Q_DECL_OVERRIDE;
0060   virtual bool isSearching() const Q_DECL_OVERRIDE { return m_started; }
0061   virtual bool canSearch(FetchKey k) const Q_DECL_OVERRIDE;
0062   virtual void continueSearch() Q_DECL_OVERRIDE;
0063   virtual void stop() Q_DECL_OVERRIDE;
0064   virtual Data::EntryPtr fetchEntryHook(uint uid) Q_DECL_OVERRIDE;
0065   virtual Type type() const Q_DECL_OVERRIDE { return Entrez; }
0066   virtual bool canFetch(int type) const Q_DECL_OVERRIDE;
0067   virtual void readConfigHook(const KConfigGroup& config) Q_DECL_OVERRIDE;
0068   virtual Fetch::ConfigWidget* configWidget(QWidget* parent) const Q_DECL_OVERRIDE;
0069 
0070   class ConfigWidget : public Fetch::ConfigWidget {
0071   public:
0072     explicit ConfigWidget(QWidget* parent_, const EntrezFetcher* fetcher=nullptr);
0073     virtual void saveConfigHook(KConfigGroup&) Q_DECL_OVERRIDE;
0074     virtual QString preferredName() const Q_DECL_OVERRIDE;
0075   private:
0076     QLineEdit* m_apiKeyEdit;
0077   };
0078   friend class ConfigWidget;
0079 
0080   static QString defaultName();
0081   static QString defaultIcon();
0082   static StringHash allOptionalFields();
0083 
0084 private Q_SLOTS:
0085   void slotComplete(KJob* job);
0086 
0087 private:
0088   virtual void search() Q_DECL_OVERRIDE;
0089   virtual FetchRequest updateRequest(Data::EntryPtr entry) Q_DECL_OVERRIDE;
0090   void initXSLTHandler();
0091   void doSummary();
0092 
0093   void searchResults(const QByteArray& data);
0094   void summaryResults(const QByteArray& data);
0095   // honor throttle limit for the API
0096   void markTime();
0097 
0098   enum class Step {
0099     Begin,
0100     Search,
0101     Summary,
0102     Fetch
0103   };
0104 
0105   XSLTHandler* m_xsltHandler;
0106   QString m_dbname;
0107 
0108   int m_start;
0109   int m_total;
0110 
0111   QString m_apiKey;
0112 
0113   QHash<uint, Data::EntryPtr> m_entries; // map from search result id to entry
0114   QHash<uint, int> m_matches; // search result id to pubmed id
0115   QPointer<KIO::StoredTransferJob> m_job;
0116   QElapsedTimer m_idleTime;
0117 
0118   QString m_queryKey;
0119   QString m_webEnv;
0120   Step m_step;
0121 
0122   bool m_started;
0123 };
0124 
0125   } // end namespace
0126 } // end namespace
0127 
0128 #endif