diff options
author | Max Kellermann <max@duempel.org> | 2012-07-30 07:26:08 +0200 |
---|---|---|
committer | Max Kellermann <max@duempel.org> | 2012-08-01 09:59:12 +0200 |
commit | 9dc9459f3a75d7500720d2294a9eca80d7d3f5bb (patch) | |
tree | 0d046c7f20e414537a3518d378a81f23c29df6c5 /src/DatabasePlugin.hxx | |
parent | 37b92967c5a8d233536216ac435ebb0d0b17782c (diff) | |
download | mpd-9dc9459f3a75d7500720d2294a9eca80d7d3f5bb.tar.gz mpd-9dc9459f3a75d7500720d2294a9eca80d7d3f5bb.tar.xz mpd-9dc9459f3a75d7500720d2294a9eca80d7d3f5bb.zip |
db_plugin: convert to C++
Diffstat (limited to '')
-rw-r--r-- | src/DatabasePlugin.hxx | 87 |
1 files changed, 87 insertions, 0 deletions
diff --git a/src/DatabasePlugin.hxx b/src/DatabasePlugin.hxx new file mode 100644 index 000000000..45a8c55bf --- /dev/null +++ b/src/DatabasePlugin.hxx @@ -0,0 +1,87 @@ +/* + * Copyright (C) 2003-2011 The Music Player Daemon Project + * http://www.musicpd.org + * + * 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, write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + */ + +/** \file + * + * This header declares the db_plugin class. It describes a + * plugin API for databases of song metadata. + */ + +#ifndef MPD_DATABASE_PLUGIN_HXX +#define MPD_DATABASE_PLUGIN_HXX + +#include "DatabaseVisitor.hxx" + +#include <glib.h> +#include <assert.h> +#include <stdbool.h> + +struct config_param; +struct db_selection; +struct db_visitor; + +class Database { +public: + /** + * Free instance data. + */ + virtual ~Database() {} + + /** + * Open the database. Read it into memory if applicable. + */ + virtual bool Open(G_GNUC_UNUSED GError **error_r) { + return true; + } + + /** + * Close the database, free allocated memory. + */ + virtual void Close() {} + + /** + * Look up a song (including tag data) in the database. + * + * @param uri_utf8 the URI of the song within the music + * directory (UTF-8) + */ + virtual struct song *GetSong(const char *uri_utf8, + GError **error_r) = 0; + + /** + * Visit the selected entities. + */ + virtual bool Visit(const struct db_selection *selection, + VisitDirectory visit_directory, + VisitSong visit_song, + VisitPlaylist visit_playlist, + GError **error_r) = 0; +}; + +struct DatabasePlugin { + const char *name; + + /** + * Allocates and configures a database. + */ + Database *(*create)(const struct config_param *param, + GError **error_r); +}; + +#endif |