vcs.maemo.org Git - situare/blob - src/engine/engine.h

   1  /*
   2     Situare - A location system for Facebook
   3     Copyright (C) 2010  Ixonos Plc. Authors:
   4
   5         Kaj Wallin - kaj.wallin@ixonos.com
   6         Henri Lampela - henri.lampela@ixonos.com
   7         Jussi Laitinen - jussi.laitinen@ixonos.com
   8         Sami Rämö - sami.ramo@ixonos.com
   9
  10     Situare is free software; you can redistribute it and/or
  11     modify it under the terms of the GNU General Public License
  12     version 2 as published by the Free Software Foundation.
  13
  14     Situare is distributed in the hope that it will be useful,
  15     but WITHOUT ANY WARRANTY; without even the implied warranty of
  16     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17     GNU General Public License for more details.
  18
  19     You should have received a copy of the GNU General Public License
  20     along with Situare; if not, write to the Free Software
  21     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
  22     USA.
  23  */
  24
  25
  26 #ifndef ENGINE_H
  27 #define ENGINE_H
  28
  29 #include <QObject>
  30 #include <QTime>
  31 #include <QPointF>
  32
  33 class QMainWindow;
  34
  35 class FacebookAuthentication;
  36 class FacebookCredentials;
  37 class GPSPosition;
  38 class MainWindow;
  39 class MapEngine;
  40 class SituareService;
  41 class User;
  42
  43 class QTimer;
  44
  45 /**
  46 * @brief Engine class for Situare Application
  47 *
  48 * This class handles all the underlaying login of the Situare
  49 * application.
  50 */
  51 class SituareEngine : public QObject
  52 {
  53     Q_OBJECT
  54 public:
  55     /**
  56     * @brief Constructor
  57     *
  58     * @param parent
  59     */
  60     SituareEngine(QMainWindow *parent = 0);
  61
  62     /**
  63     * @brief Destructor
  64     */
  65     ~SituareEngine();
  66
  67 /*******************************************************************************
  68  * MEMBER FUNCTIONS AND SLOTS
  69  ******************************************************************************/
  70 public slots:
  71     /**
  72     * @brief Slot to intercept error signal from ImageFetcher and SituareService
  73     *
  74     * @param error Error message
  75     */
  76     void error(const QString &error);
  77
  78     /**
  79     * @brief Slot to intercept signal when username is fetched from settings
  80     *
  81     */
  82     void fetchUsernameFromSettings();
  83
  84     /**
  85     * @brief Slot to intercept signal when Login/Logout action is pressed
  86     *
  87     */
  88     void loginActionPressed();
  89
  90     /**
  91     * @brief Slot to intercept signal from successful login
  92     *
  93     * @param freshLogin Was login done via login dialog
  94     * @param credentials Facebook credentials
  95     */
  96     void loginOk(bool freshLogin, const FacebookCredentials &credentials);
  97
  98     /**
  99     * @brief Slot to intercept signal when user has cancelled login process
 100     */
 101     void loginProcessCancelled();
 102
 103     /**
 104     * @brief Changes application state when logged out
 105     *
 106     */
 107     void logout();
 108
 109     /**
 110     * @brief Calls reverseGeo from SituareService to translate coordinates to street address
 111     *
 112     */
 113     void requestAddress();
 114
 115     /**
 116     * @brief Calls updateLocation from SituareService to send the location update to
 117     *        Situare server.
 118     *
 119     * @param status Status message
 120     * @param publish Publish on Facebook
 121     */
 122     void requestUpdateLocation(const QString &status = QString(), bool publish = false);
 123
 124     /**
 125     * @brief Slot to refresh user data
 126     */
 127     void refreshUserData();
 128
 129     /**
 130     * @brief Slot to intercept signal from successful location update
 131     *
 132     */
 133     void updateWasSuccessful();
 134
 135     /**
 136     * @brief Slot to intercept signal when new user data is available.
 137     *        Splits User and friendsList data and emits them as two different signals.
 138     *
 139     * @param user instance of User
 140     * @param friendsList list of User instances (friends)
 141     */
 142     void userDataChanged(User *user, QList<User *> &friendsList);
 143
 144 private:
 145     /**
 146     * @brief Checks if user is moved enough for position auto update.
 147     *
 148     * @return true if moved engouh, false otherwise
 149     */
 150     bool isUserMoved();
 151
 152     /**
 153       * @brief Connect signals coming from Facdebook authenticator
 154       */
 155     void signalsFromFacebookAuthenticator();
 156
 157     /**
 158       * @brief Connect signals coming from GPS
 159       */
 160     void signalsFromGPS();
 161
 162     /**
 163       * @brief Connect signals coming from MainWindow
 164       */
 165     void signalsFromMainWindow();
 166
 167     /**
 168       * @brief Connect signals coming from MapEngine
 169       */
 170     void signalsFromMapEngine();
 171
 172     /**
 173       * @brief Connect signals coming from MapView
 174       */
 175     void signalsFromMapView();
 176
 177     /**
 178       * @brief Connect signals coming from Situare
 179       */
 180     void signalsFromSituareService();
 181
 182 private slots:
 183
 184     void automaticUpdateIntervalTimerTimeout();
 185
 186     /**
 187       * @brief Set auto centering feature enabled / disabled
 188       */
 189     void changeAutoCenteringSetting(bool enabled);
 190
 191     /**
 192       * @brief Slot for disabling automatic centering when map is scrolled manually
 193       */
 194     void disableAutoCentering();
 195
 196     /**
 197     * @brief Slot for auto centering enabling.
 198     *
 199     * Calls gps to send last known position
 200     *
 201     * @param enabled true if auto centering was enabled, false otherwise
 202     */
 203     void enableAutoCentering(bool enabled);
 204
 205     /**
 206     * @brief Slot for gps enabling.
 207     *
 208     * @param enabled true if gps should be enabled, false otherwise
 209     */
 210     void enableGPS(bool enabled);
 211
 212     /**
 213     * @brief Slot for intercepting signal when credentials are invalid
 214     *
 215     */
 216     void invalidCredentials();
 217
 218     /**
 219     * @brief Saves GPS position.
 220     *
 221     * Saves GPS position if it has changed enough and sets m_userMoved flag.
 222     *
 223     * @param position geo coordinates
 224     */
 225     void saveGPSPosition(QPointF position);
 226
 227     /**
 228     * @brief Enables automatic location update.
 229     *
 230     * @param enabled true if
 231     */
 232     void enableAutomaticLocationUpdate(bool enabled, int updateIntervalMsecs = -1);
 233
 234 /*******************************************************************************
 235  * SIGNALS
 236  ******************************************************************************/
 237 signals:
 238     /**
 239     * @brief Signals when new friends data is ready
 240     *
 241     * @param friendList List of User instances (friends)
 242     */
 243     void friendsLocationsReady(QList<User *> &friendList);
 244
 245     /**
 246     * @brief Signals when new user data is ready
 247     *
 248     * @param user Instance of User
 249     */
 250     void userLocationReady(User *user);
 251
 252 /*******************************************************************************
 253  * DATA MEMBERS
 254  ******************************************************************************/
 255 private:
 256     bool m_autoCenteringEnabled;  ///< Auto centering enabled
 257     bool m_loggedIn;              ///< Login state
 258
 259     FacebookAuthentication *m_facebookAuthenticator; ///< Instance for facebook authenticator
 260     GPSPosition *m_gps;                              ///< Instance of the gps position
 261     MainWindow *m_ui;                                ///< Instance of the MainWindow UI
 262     MapEngine *m_mapEngine;                          ///< MapEngine
 263     SituareService *m_situareService;  ///< Instance of the situare server communication service
 264
 265     QTimer *m_automaticUpdateIntervalTimer; ///< Automatic update interval timer
 266     QPointF m_lastUpdatedGPSPosition;       ///< Last updated GPS position
 267     bool m_userMoved;                       ///< Flag for user moving
 268 };
 269
 270 #endif // ENGINE_H