File indexing completed on 2024-05-19 04:50:17

 /****************************************************************************************
  * Copyright (c) 2012 Matěj Laitl <matej@laitl.cz>                                      *
  *                                                                                      *
  * This program is free software; you can redistribute it and/or modify it under        *
  * the terms of the GNU General Public License as published by the Free Software        *
  * Foundation; either version 2 of the License, or (at your option) any later           *
  * version.                                                                             *
  *                                                                                      *
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY      *
  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A      *
  * PARTICULAR PURPOSE. See the GNU General Public License for more details.             *
  *                                                                                      *
  * You should have received a copy of the GNU General Public License along with         *
  * this program.  If not, see <http://www.gnu.org/licenses/>.                           *
  ****************************************************************************************/
 
 #ifndef SYNCHRONIZATIONADAPTER_H
 #define SYNCHRONIZATIONADAPTER_H
 
 #include "services/lastfm/LastFmServiceConfig.h"
 #include "statsyncing/Provider.h"
 
 #include <QSemaphore>
 
 class LastFmServiceConfig;
 
 class SynchronizationAdapter : public StatSyncing::Provider
 {
     Q_OBJECT
 
     public:
         /**
          * @param config a pointer to Last.fm config
          */
         explicit SynchronizationAdapter( const LastFmServiceConfigPtr &config );
         ~SynchronizationAdapter() override;
 
         QString id() const override;
         QString prettyName() const override;
         QString description() const override;
         QIcon icon() const override;
         qint64 reliableTrackMetaData() const override;
         qint64 writableTrackStatsData() const override;
         Preference defaultPreference() override;
         QSet<QString> artists() override;
         StatSyncing::TrackList artistTracks( const QString &artistName ) override;
 
     Q_SIGNALS:
         /// hacks to create and start Last.fm queries in main eventloop
         // Last.fm indexes from 1!
         void startArtistSearch( int page );
         void startTrackSearch( QString artistName, int page );
         void startTagSearch( QString artistName, QString trackName );
 
     private Q_SLOTS:
         /// @see startArtistSearch
         void slotStartArtistSearch( int page );
         void slotStartTrackSearch( QString artistName, int page );
         void slotStartTagSearch( QString artistName, QString trackName );
 
         void slotArtistsReceived();
         void slotTracksReceived();
         void slotTagsReceived();
 
     private:
         LastFmServiceConfigPtr m_config;
 
         /**
          * number of artist or track entries to request from Last.fm in earch webservice
          * query. Last.fm default is 50; the greater the number, the faster the fetching
          * (of long lists) is. On the other hand, Last.fm has own limit, 200 works well.
          */
         static const int s_entriesPerQuery;
 
         QSet<QString> m_artists;
         StatSyncing::TrackList m_tracks;
         StatSyncing::TrackList m_tagQueue; // tracks waiting to be assigned tags
         /**
          * Semaphore for the simplified producer-consumer pattern, where
          * slotArtistsReceived() is producer and artist() is consumer, or
          * slotTracksReceived() is producer and artistTracks() is consumer, or
          * slotTagsReceived() is producer and artistTracks() is consumer.
          */
         QSemaphore m_semaphore;
 };
 
 #endif // SYNCHRONIZATIONADAPTER_H