qof-0.8.8/qof/qofinstance.c

/********************************************************************\
 * qofinstance.c -- handler for fields common to all objects        *
 *                                                                  *
 * 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, contact:                        *
 *                                                                  *
 * Free Software Foundation           Voice:  +1-617-542-5942       *
 * 51 Franklin Street, Fifth Floor    Fax:    +1-617-542-2652       *
 * Boston, MA  02110-1301,  USA       gnu@gnu.org                   *
 *                                                                  *
\********************************************************************/

/*
 * Object instance holds many common fields that most
 * gnucash objects use.
 *
 * Copyright (C) 2003 Linas Vepstas <linas@linas.org>
 */

#include "config.h"
#include <glib.h>
#include "qof.h"
#include "kvputil-p.h"
#include "qofbook-p.h"
#include "qofid-p.h"
#include "qofinstance-p.h"

static QofLogModule log_module = QOF_MOD_ENGINE;

/* ========================================================== */

QofInstance *
qof_instance_create (QofIdType type, QofBook * book)
{
	QofInstance *inst;

	inst = g_new0 (QofInstance, 1);
	qof_instance_init (inst, type, book);
	return inst;
}

void
qof_instance_init (QofInstance * inst, QofIdType type, QofBook * book)
{
	QofCollection *col;

	inst->book = book;
	inst->kvp_data = kvp_frame_new ();
	inst->update_time = qof_time_get_current ();
	inst->editlevel = 0;
	inst->do_free = FALSE;
	inst->dirty = FALSE;

	col = qof_book_get_collection (book, type);
	qof_entity_init (&inst->entity, type, col);
}

void
qof_instance_release (QofInstance * inst)
{
	kvp_frame_delete (inst->kvp_data);
	inst->editlevel = 0;
	inst->do_free = FALSE;
	inst->dirty = FALSE;
	qof_entity_release (&inst->entity);
}

const GUID *
qof_instance_get_guid (QofInstance * inst)
{
	if (!inst)
		return NULL;
	return &inst->entity.guid;
}

QofBook *
qof_instance_get_book (QofInstance * inst)
{
	if (!inst)
		return NULL;
	return inst->book;
}

KvpFrame *
qof_instance_get_slots (QofInstance * inst)
{
	if (!inst)
		return NULL;
	return inst->kvp_data;
}

QofTime *
qof_instance_get_update_time (QofInstance * inst)
{
	if (!inst)
	{
		QofTime *time;

		time = qof_time_get_current ();
		return time;
	}
	return inst->update_time;
}

int
qof_instance_version_cmp (QofInstance * left, QofInstance * right)
{
	if (!left && !right)
		return 0;
	if (!left)
		return -1;
	if (!right)
		return +1;
	return qof_time_cmp (left->update_time, right->update_time);
}

gboolean
qof_instance_is_dirty (QofInstance * inst)
{
	QofCollection *coll;

	if (!inst)
	{
		return FALSE;
	}
	coll = inst->entity.collection;
	if (qof_collection_is_dirty (coll))
	{
		return inst->dirty;
	}
	inst->dirty = FALSE;
	return FALSE;
}

void
qof_instance_set_dirty (QofInstance * inst)
{
	QofCollection *coll;

	inst->dirty = TRUE;
	coll = inst->entity.collection;
	qof_collection_mark_dirty (coll);
}

gboolean
qof_instance_check_edit (QofInstance * inst)
{
	if (inst->editlevel > 0)
	{
		return TRUE;
	}
	return FALSE;
}

gboolean
qof_instance_do_free (QofInstance * inst)
{
	return inst->do_free;
}

void
qof_instance_mark_free (QofInstance * inst)
{
	inst->do_free = TRUE;
}

/* ========================================================== */
/* setters */

void
qof_instance_mark_clean (QofInstance * inst)
{
	if (!inst)
		return;
	inst->dirty = FALSE;
}

void
qof_instance_set_slots (QofInstance * inst, KvpFrame * frm)
{
	if (!inst)
		return;
	if (inst->kvp_data && (inst->kvp_data != frm))
	{
		kvp_frame_delete (inst->kvp_data);
	}

	inst->dirty = TRUE;
	inst->kvp_data = frm;
}

void
qof_instance_set_update_time (QofInstance * inst, QofTime * time)
{
	if (!inst)
		return;
	qof_time_free (inst->update_time);
	inst->update_time = time;
}

void
qof_instance_gemini (QofInstance * to, QofInstance * from)
{
	QofTime *qt;

	/* Books must differ for a gemini to be meaningful */
	if (!from || !to || (from->book == to->book))
		return;

	qt = qof_time_get_current ();

	/* Make a note of where the copy came from */
	qof_kvp_bag_add (to->kvp_data, "gemini", qt,
		"inst_guid", &from->entity.guid,
		"book_guid", &from->book->inst.entity.guid, NULL);
	qof_kvp_bag_add (from->kvp_data, "gemini", qt,
		"inst_guid", &to->entity.guid,
		"book_guid", &to->book->inst.entity.guid, NULL);

	to->dirty = TRUE;
}

QofInstance *
qof_instance_lookup_twin (QofInstance * src, QofBook * target_book)
{
	QofCollection *col;
	KvpFrame *fr;
	GUID *twin_guid;
	QofInstance *twin;

	if (!src || !target_book)
		return NULL;
	ENTER (" ");

	fr = qof_kvp_bag_find_by_guid (src->kvp_data, "gemini",
		"book_guid", &target_book->inst.entity.guid);

	twin_guid = kvp_frame_get_guid (fr, "inst_guid");

	col = qof_book_get_collection (target_book, src->entity.e_type);
	twin = (QofInstance *) qof_collection_lookup_entity (col, twin_guid);

	LEAVE (" found twin=%p", twin);
	return twin;
}

/* ========================== END OF FILE ======================= */