dcoprss/query.h

   1 /* $Id$ */
   2 #ifndef _QUERY_SERVICE
   3 #define _QUERY_SERVICE
   4
   5 /***************************************************************************
   6                           query.h  -  A query interface to select RSS feeds.
   7                              -------------------
   8     begin                : Saturday 15 February 2003
   9     copyright            : (C) 2003 by Ian Reinhart Geiser
  10     email                : geiseri@kde.org
  11  ***************************************************************************/
  12
  13 /***************************************************************************
  14  *                                                                         *
  15  *   This program is free software; you can redistribute it and/or modify  *
  16  *   it under the terms of the GNU General Public License as published by  *
  17  *   the Free Software Foundation; either version 2 of the License, or     *
  18  *   (at your option) any later version.                                   *
  19  *                                                                         *
  20  ***************************************************************************/
  21
  22 #include "rssnewsfeed.h"
  23 #include "xmlrpciface.h"
  24
  25 #include <dcopobject.h>
  26
  27 #include <qmap.h>
  28 #include <qobject.h>
  29 #include <q3valuelist.h>
  30 #include <qvariant.h>
  31 #include <QList>
  32
  33 class RSSService;
  34
  35 /**
  36  * Helper class which just calls the slot given it's QObject/const char*
  37  * representation.
  38  */
  39 class SlotCaller : public QObject
  40 {
  41         Q_OBJECT
  42         public:
  43                 static void call( QObject *object, const char *slot,
  44                                   const KXMLRPC::Query::Result &value );
  45
  46         signals:
  47                 void signal( const KXMLRPC::Query::Result &value );
  48
  49         private:
  50                 SlotCaller() { }
  51 };
  52
  53 class QueryService : public QObject, public DCOPObject
  54 {
  55         K_DCOP
  56         Q_OBJECT
  57         public:
  58                 QueryService( RSSService *service );
  59
  60         k_dcop_signals:
  61                 void feedIds( QList<int> ids );
  62                 void feedInfo(QMap<QString, QString> links);
  63                 void feedInfo(QList<RSSNewsFeed> feeds);
  64                 void gotCategories( const QStringList &categories );
  65                 void gotFeedsInCategory( const QList<int> &ids );
  66
  67         k_dcop:
  68                 /**
  69                  * Lists the active feeds in use...
  70                  **/
  71                 QStringList listActive(); // just for testing...
  72
  73                 /**
  74                  * Query the www.syndic8.com XML-RPC interface for the
  75                  * string. The RSS ids are treturned in a integer list.
  76                  **/
  77                 void findFeeds( const QString& query );
  78
  79                 /**
  80                  * Query the www.syndic8.com XML-RPC interface for the
  81                  * string and matches it against the SiteURL feed of
  82                  * each feed in the feed list. The RSS ids are treturned
  83                  * in a integer list.
  84                  **/
  85                 void findSites( const QString& query );
  86
  87                 /**
  88                  * Query the www.syndic8.com XML-RPC interface for the
  89                  * requested RSS feed(s).  Returned is a QMap with the format
  90                  * of Name (Site URL), RSS URL
  91                  **/
  92                 void getFeedInfo( const QVariant& ids );
  93
  94                 /**
  95                  * Returns the list of subcategories in the specified category.
  96                  * If no "Top" is specified, the root categories are returned.
  97                  */
  98                 void getCategories( const QString &category );
  99
 100                 /**
 101                  * Queries the database for the list of needsfeed ID's which are
 102                  * associated with the given category.
 103                  */
 104                 void getFeedsInCategory( const QString &category );
 105
 106
 107         private slots:
 108                 void slotFoundFeeds( const KXMLRPC::Query::Result &result );
 109                 void slotGotFeedInfo( const KXMLRPC::Query::Result &result );
 110                 void slotGotCategories( const KXMLRPC::Query::Result &result );
 111                 void slotGotFeedsInCategory( const KXMLRPC::Query::Result &result );
 112
 113         private:
 114                 void cachedCall( const QString &method, const QList<QVariant> &args,
 115                                  const char *slot );
 116                 void updateCache( const KXMLRPC::Query::Result &result );
 117
 118                 RSSService *m_service;
 119                 KXMLRPC::Server *m_xmlrpcServer;
 120 };
 121 #endif