/* This file is part of Clementine. Copyright 2010, David Sansome Clementine 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 3 of the License, or (at your option) any later version. Clementine 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 Clementine. If not, see . */ #ifndef MUSICDNSCLIENT_H #define MUSICDNSCLIENT_H #include #include class NetworkTimeouts; class QNetworkAccessManager; class QNetworkReply; class MusicDnsClient : public QObject { Q_OBJECT // Gets a PUID from an OFA fingerprint. // A fingerprint identifies one particular encoding of a song and is created // by Fingerprinter. A PUID identifies the actual song and can be passed to // Musicbrainz to get metadata. // You can create one MusicDnsClient and make multiple requests using it. // IDs are provided by the caller when a request is started and included in // the Finished signal - they have no meaning to MusicDnsClient. public: MusicDnsClient(QObject* parent = 0); // Network requests will be aborted after this interval. void SetTimeout(int msec); // Starts a request and returns immediately. Finished() will be emitted // later with the same ID. void Start(int id, const QString& fingerprint, int duration_msec); // Cancels the request with the given ID. Finished() will never be emitted // for that ID. Does nothing if there is no request with the given ID. void Cancel(int id); // Cancels all requests. Finished() will never be emitted for any pending // requests. void CancelAll(); signals: void Finished(int id, const QString& puid); private slots: void RequestFinished(); private: static const char* kClientId; static const char* kUrl; static const int kDefaultTimeout; QNetworkAccessManager* network_; NetworkTimeouts* timeouts_; QMap requests_; }; #endif // MUSICDNSCLIENT_H