mu/src/mu-store-priv.hh

/* -*-mode: c++; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8-*- */
/*
** Copyright (C) 2011  <djcb@djcbsoftware.nl>
**
** 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 3, 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.
**
*/

#ifndef __MU_STORE_PRIV_HH__
#define __MU_STORE_PRIV_HH__

#if HAVE_CONFIG_H
#include "config.h"
#endif /*HAVE_CONFIG_H*/

#include <cstdio>
#include <xapian.h>
#include <cstring>
#include <stdexcept>

#include "mu-store.h"
#include "mu-contacts.h"


class MuStoreError {
public:
	MuStoreError (MuError err, const std::string& what) :
		_err (err), _what(what) {}
	MuError mu_error () const { return _err; }
	const std::string& what() const { return _what; }
private:
	MuError _err;
	const std::string _what;
};


struct _MuStore {

/* by default, use transactions of 30000 messages */
#define MU_STORE_DEFAULT_BATCH_SIZE 30000
	/* http://article.gmane.org/gmane.comp.search.xapian.general/3656 */
#define MU_STORE_MAX_TERM_LENGTH 240

	_MuStore (const char *path, const char *contacts_path, bool read_only):
		_in_transaction (false), _processed (0),
		_batch_size(MU_STORE_DEFAULT_BATCH_SIZE),
		_contacts(0), _path (0), _version(0),
		_db(0), _read_only(read_only), _ref_count (1) {

		if (!check_path ())
			throw MuStoreError (MU_ERROR_FILE, "invalid_path");

		_path = g_strdup (path);

		if (read_only)
			_db = new Xapian::Database (path);
		else
			_db = new Xapian::WritableDatabase
				(path, Xapian::DB_CREATE_OR_OPEN);

		if (!check_version ())
			throw MuStoreError (MU_ERROR_XAPIAN_NOT_UP_TO_DATE,
					    ("xapian db version check failed"));

		if (contacts_path) {
			_contacts = mu_contacts_new (contacts_path);
			if (!_contacts) /* don't bail-out for this */
				throw MuStoreError (MU_ERROR_FILE,
					    ("failed to init contacts cache"));
		}
		MU_WRITE_LOG ("%s: opened %s (batch size: %u)",
			      __FUNCTION__, this->path(), batch_size());
	}

	~_MuStore () {
		try {
			if (_ref_count != 0)
				g_warning ("ref count != 0");

			g_free (_version);
			g_free (_path);

			mu_contacts_destroy (_contacts);

			if (!_read_only)
				mu_store_flush (this);

			MU_WRITE_LOG ("closing xapian database with %d documents",
				      (int)db_read_only()->get_doccount());
			delete _db;

		} MU_XAPIAN_CATCH_BLOCK;
	}

	/* close the old database, and write an empty one on top of it */
	void clear();

	/* get a unique id for this message; note, this function returns a
	 * static buffer -- not reentrant */
	const char* get_message_uid (const char* path);
	const char* get_message_uid (MuMsg *msg);

	MuContacts* contacts() { return _contacts; }

	const char* version ()  {
		g_free (_version);
		return _version =
			mu_store_get_metadata (this, MU_STORE_VERSION_KEY);
	}

	void begin_transaction ();
	void commit_transaction ();
	void rollback_transaction ();

	Xapian::WritableDatabase* db_writable() {
		if (G_UNLIKELY(is_read_only()))
			throw std::runtime_error ("database is read-only");
		return (Xapian::WritableDatabase*)_db;
	}

	Xapian::Database* db_read_only() const { return _db; }

	const char* path () const { return _path; }
	bool is_read_only () const { return _read_only; }

	size_t batch_size () const { return _batch_size;}
	size_t set_batch_size (size_t n)  {
		return _batch_size = ( n == 0) ? MU_STORE_DEFAULT_BATCH_SIZE : n;
	}

	bool   in_transaction () const { return _in_transaction; }
	bool   set_in_transaction (bool in_tx) { return _in_transaction = in_tx; }

	int    processed () const { return _processed; }
	int    set_processed (int n) { return _processed = n;}
	int    inc_processed () { return ++_processed; }

	/* MuStore is ref-counted */
	guint  ref   () { return ++_ref_count; }
	guint  unref () { return --_ref_count; }

private:

	bool check_version ();
	bool check_path () {
		return true; // FIXME
	}

	/* transaction handling */
	bool   _in_transaction;
	int    _processed;
	size_t  _batch_size;  /* batch size of a xapian transaction */

	/* contacts object to cache all the contact information */
	MuContacts *_contacts;

	char *_path;
	mutable char *_version;

	Xapian::Database *_db;
	bool _read_only;

	guint _ref_count;
};


#endif /*__MU_STORE_PRIV_HH__*/