Clementine-audio-player-Mac.../src/library/librarybackend.h

257 lines
9.1 KiB
C
Raw Normal View History

/* This file is part of Clementine.
Copyright 2010, David Sansome <me@davidsansome.com>
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 <http://www.gnu.org/licenses/>.
*/
2009-12-24 20:16:07 +01:00
#ifndef LIBRARYBACKEND_H
#define LIBRARYBACKEND_H
#include <QObject>
#include <QSet>
#include <QUrl>
2009-12-24 20:16:07 +01:00
#include "directory.h"
#include "libraryquery.h"
#include "core/song.h"
2009-12-24 20:16:07 +01:00
class Database;
namespace smart_playlists {
class Search;
}
class LibraryBackendInterface : public QObject {
2011-05-20 01:02:15 +02:00
Q_OBJECT
public:
LibraryBackendInterface(QObject* parent = nullptr) : QObject(parent) {}
virtual ~LibraryBackendInterface() {}
struct Album {
2010-03-23 22:52:42 +01:00
Album() {}
Album(const QString& _artist, const QString& _album_name,
const QString& _art_automatic, const QString& _art_manual,
const QUrl& _first_url)
: artist(_artist),
album_name(_album_name),
art_automatic(_art_automatic),
art_manual(_art_manual),
first_url(_first_url) {}
2010-03-23 22:52:42 +01:00
QString artist;
QString album_name;
QString art_automatic;
QString art_manual;
QUrl first_url;
};
typedef QList<Album> AlbumList;
virtual QString songs_table() const = 0;
// Get a list of directories in the library. Emits DirectoriesDiscovered.
virtual void LoadDirectoriesAsync() = 0;
// Counts the songs in the library. Emits TotalSongCountUpdated
virtual void UpdateTotalSongCountAsync() = 0;
virtual SongList FindSongsInDirectory(int id) = 0;
virtual SubdirectoryList SubdirsInDirectory(int id) = 0;
virtual DirectoryList GetAllDirectories() = 0;
virtual void ChangeDirPath(int id, const QString& old_path,
const QString& new_path) = 0;
virtual QStringList GetAllArtists(
const QueryOptions& opt = QueryOptions()) = 0;
virtual QStringList GetAllArtistsWithAlbums(
const QueryOptions& opt = QueryOptions()) = 0;
virtual SongList GetSongsByAlbum(
const QString& album, const QueryOptions& opt = QueryOptions()) = 0;
virtual SongList GetSongs(const QString& artist, const QString& album,
const QueryOptions& opt = QueryOptions()) = 0;
virtual SongList GetCompilationSongs(
const QString& album, const QueryOptions& opt = QueryOptions()) = 0;
virtual AlbumList GetAllAlbums(const QueryOptions& opt = QueryOptions()) = 0;
virtual AlbumList GetAlbumsByArtist(
const QString& artist, const QueryOptions& opt = QueryOptions()) = 0;
virtual AlbumList GetCompilationAlbums(
const QueryOptions& opt = QueryOptions()) = 0;
virtual void UpdateManualAlbumArtAsync(const QString& artist,
const QString& album,
const QString& art) = 0;
virtual Album GetAlbumArt(const QString& artist, const QString& album) = 0;
virtual Song GetSongById(int id) = 0;
// Returns all sections of a song with the given filename. If there's just one
// section
// the resulting list will have it's size equal to 1.
virtual SongList GetSongsByUrl(const QUrl& url) = 0;
// Returns a section of a song with the given filename and beginning. If the
// section
// is not present in library, returns invalid song.
// Using default beginning value is suitable when searching for single-section
// songs.
virtual Song GetSongByUrl(const QUrl& url, qint64 beginning = 0) = 0;
virtual void AddDirectory(const QString& path) = 0;
virtual void RemoveDirectory(const Directory& dir) = 0;
virtual bool ExecQuery(LibraryQuery* q) = 0;
};
class LibraryBackend : public LibraryBackendInterface {
Q_OBJECT
public:
static const char* kSettingsGroup;
Q_INVOKABLE LibraryBackend(QObject* parent = nullptr);
void Init(Database* db, const QString& songs_table, const QString& dirs_table,
const QString& subdirs_table, const QString& fts_table);
Database* db() const { return db_; }
2010-05-09 19:32:07 +02:00
QString songs_table() const { return songs_table_; }
QString dirs_table() const { return dirs_table_; }
QString subdirs_table() const { return subdirs_table_; }
2009-12-24 20:16:07 +01:00
// Get a list of directories in the library. Emits DirectoriesDiscovered.
void LoadDirectoriesAsync();
// Counts the songs in the library. Emits TotalSongCountUpdated
void UpdateTotalSongCountAsync();
SongList FindSongsInDirectory(int id);
SubdirectoryList SubdirsInDirectory(int id);
DirectoryList GetAllDirectories();
void ChangeDirPath(int id, const QString& old_path, const QString& new_path);
2009-12-24 20:16:07 +01:00
QStringList GetAll(const QString& column,
const QueryOptions& opt = QueryOptions());
QStringList GetAllArtists(const QueryOptions& opt = QueryOptions());
QStringList GetAllArtistsWithAlbums(const QueryOptions& opt = QueryOptions());
SongList GetSongsByAlbum(const QString& album,
const QueryOptions& opt = QueryOptions());
SongList GetSongs(const QString& artist, const QString& album,
const QueryOptions& opt = QueryOptions());
SongList GetCompilationSongs(const QString& album,
const QueryOptions& opt = QueryOptions());
2009-12-24 20:16:07 +01:00
AlbumList GetAllAlbums(const QueryOptions& opt = QueryOptions());
AlbumList GetAlbumsByArtist(const QString& artist,
const QueryOptions& opt = QueryOptions());
AlbumList GetCompilationAlbums(const QueryOptions& opt = QueryOptions());
void UpdateManualAlbumArtAsync(const QString& artist, const QString& album,
const QString& art);
Album GetAlbumArt(const QString& artist, const QString& album);
2009-12-24 20:16:07 +01:00
Song GetSongById(int id);
SongList GetSongsById(const QList<int>& ids);
SongList GetSongsById(const QStringList& ids);
SongList GetSongsByForeignId(const QStringList& ids, const QString& table,
const QString& column);
2009-12-24 20:16:07 +01:00
SongList GetSongsByUrl(const QUrl& url);
Song GetSongByUrl(const QUrl& url, qint64 beginning = 0);
2009-12-24 20:16:07 +01:00
void AddDirectory(const QString& path);
void RemoveDirectory(const Directory& dir);
bool ExecQuery(LibraryQuery* q);
SongList ExecLibraryQuery(LibraryQuery* query);
SongList FindSongs(const smart_playlists::Search& search);
SongList GetAllSongs();
void IncrementPlayCountAsync(int id);
void IncrementSkipCountAsync(int id, float progress);
2010-12-25 12:54:21 +01:00
void ResetStatisticsAsync(int id);
void UpdateSongRatingAsync(int id, float rating);
void UpdateSongsRatingAsync(const QList<int>& ids, float rating);
void DeleteAll();
2009-12-24 20:16:07 +01:00
public slots:
void LoadDirectories();
void UpdateTotalSongCount();
void AddOrUpdateSongs(const SongList& songs);
2009-12-24 20:16:07 +01:00
void UpdateMTimesOnly(const SongList& songs);
void DeleteSongs(const SongList& songs);
void MarkSongsUnavailable(const SongList& songs, bool unavailable = true);
void AddOrUpdateSubdirs(const SubdirectoryList& subdirs);
void UpdateCompilations();
void UpdateManualAlbumArt(const QString& artist, const QString& album,
const QString& art);
void ForceCompilation(const QString& album, const QList<QString>& artists,
bool on);
void IncrementPlayCount(int id);
void IncrementSkipCount(int id, float progress);
2010-12-25 12:54:21 +01:00
void ResetStatistics(int id);
void UpdateSongRating(int id, float rating);
void UpdateSongsRating(const QList<int>& id_list, float rating);
signals:
void DirectoryDiscovered(const Directory& dir,
const SubdirectoryList& subdirs);
void DirectoryDeleted(const Directory& dir);
void SongsDiscovered(const SongList& songs);
void SongsDeleted(const SongList& songs);
void SongsStatisticsChanged(const SongList& songs);
void SongsRatingChanged(const SongList& songs);
void DatabaseReset();
void TotalSongCountUpdated(int total);
2009-12-24 20:16:07 +01:00
private:
struct CompilationInfo {
CompilationInfo() : has_samplers(false), has_not_samplers(false) {}
QSet<QString> artists;
QSet<QString> directories;
bool has_samplers;
bool has_not_samplers;
};
static const char* kNewScoreSql;
void UpdateCompilations(QSqlQuery& find_songs, QSqlQuery& update,
SongList& deleted_songs, SongList& added_songs,
const QString& album, int sampler);
AlbumList GetAlbums(const QString& artist, bool compilation = false,
const QueryOptions& opt = QueryOptions());
SubdirectoryList SubdirsInDirectory(int id, QSqlDatabase& db);
Song GetSongById(int id, QSqlDatabase& db);
SongList GetSongsById(const QStringList& ids, QSqlDatabase& db);
2009-12-24 20:16:07 +01:00
private:
Database* db_;
QString songs_table_;
QString dirs_table_;
QString subdirs_table_;
QString fts_table_;
bool save_statistics_in_file_;
bool save_ratings_in_file_;
2010-04-04 18:28:34 +02:00
};
#endif // LIBRARYBACKEND_H