mirror of
https://github.com/Gnucash/gnucash.git
synced 2025-02-25 18:55:30 -06:00
468 lines
16 KiB
C
468 lines
16 KiB
C
/********************************************************************
|
|
* gnc-account-sql.c: load and save data to SQL *
|
|
* *
|
|
* 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 *
|
|
\********************************************************************/
|
|
/** @file gnc-account-sql.c
|
|
* @brief load and save data to SQL
|
|
* @author Copyright (c) 2006-2008 Phil Longstaff <plongstaff@rogers.com>
|
|
*
|
|
* This file implements the top-level QofBackend API for saving/
|
|
* restoring data to/from an SQL db
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include <glib.h>
|
|
|
|
#include "qof.h"
|
|
#include "Account.h"
|
|
#include "AccountP.h"
|
|
#include "gnc-commodity.h"
|
|
|
|
#include "gnc-backend-sql.h"
|
|
|
|
#include "gnc-account-sql.h"
|
|
#include "gnc-commodity-sql.h"
|
|
#include "gnc-slots-sql.h"
|
|
#include "gnc-transaction-sql.h"
|
|
|
|
#if defined( S_SPLINT_S )
|
|
#include "splint-defs.h"
|
|
#endif
|
|
|
|
static QofLogModule log_module = G_LOG_DOMAIN;
|
|
|
|
#define TABLE_NAME "accounts"
|
|
#define TABLE_VERSION 1
|
|
|
|
static /*@ null @*//*@ dependent @*/ gpointer get_parent( gpointer pObject );
|
|
static void set_parent( gpointer pObject, /*@ null @*/ gpointer pValue );
|
|
static void set_parent_guid( gpointer pObject, /*@ null @*/ gpointer pValue );
|
|
|
|
#define ACCOUNT_MAX_NAME_LEN 2048
|
|
#define ACCOUNT_MAX_TYPE_LEN 2048
|
|
#define ACCOUNT_MAX_CODE_LEN 2048
|
|
#define ACCOUNT_MAX_DESCRIPTION_LEN 2048
|
|
|
|
static const GncSqlColumnTableEntry col_table[] =
|
|
{
|
|
/*@ -full_init_block @*/
|
|
{ "guid", CT_GUID, 0, COL_NNUL | COL_PKEY, "guid" },
|
|
{ "name", CT_STRING, ACCOUNT_MAX_NAME_LEN, COL_NNUL, "name" },
|
|
{ "account_type", CT_STRING, ACCOUNT_MAX_TYPE_LEN, COL_NNUL, NULL, ACCOUNT_TYPE_ },
|
|
{ "commodity_guid", CT_COMMODITYREF, 0, 0, "commodity" },
|
|
{ "commodity_scu", CT_INT, 0, COL_NNUL, "commodity-scu" },
|
|
{ "non_std_scu", CT_BOOLEAN, 0, COL_NNUL, "non-std-scu" },
|
|
{
|
|
"parent_guid", CT_GUID, 0, 0, NULL, NULL,
|
|
(QofAccessFunc)get_parent, set_parent
|
|
},
|
|
{ "code", CT_STRING, ACCOUNT_MAX_CODE_LEN, 0, "code" },
|
|
{ "description", CT_STRING, ACCOUNT_MAX_DESCRIPTION_LEN, 0, "description" },
|
|
{ "hidden", CT_BOOLEAN, 0, 0, "hidden" },
|
|
{ "placeholder", CT_BOOLEAN, 0, 0, "placeholder" },
|
|
{ NULL }
|
|
/*@ +full_init_block @*/
|
|
};
|
|
static GncSqlColumnTableEntry parent_col_table[] =
|
|
{
|
|
/*@ -full_init_block @*/
|
|
{ "parent_guid", CT_GUID, 0, 0, NULL, NULL, NULL, set_parent_guid },
|
|
{ NULL }
|
|
/*@ +full_init_block @*/
|
|
};
|
|
|
|
typedef struct
|
|
{
|
|
/*@ dependent @*/ Account* pAccount;
|
|
GncGUID guid;
|
|
} account_parent_guid_struct;
|
|
|
|
/* ================================================================= */
|
|
|
|
static /*@ null @*//*@ dependent @*/ gpointer
|
|
get_parent( gpointer pObject )
|
|
{
|
|
const Account* pAccount;
|
|
const Account* pParent;
|
|
const GncGUID* parent_guid;
|
|
|
|
g_return_val_if_fail( pObject != NULL, NULL );
|
|
g_return_val_if_fail( GNC_IS_ACCOUNT(pObject), NULL );
|
|
|
|
pAccount = GNC_ACCOUNT(pObject);
|
|
pParent = gnc_account_get_parent( pAccount );
|
|
if ( pParent == NULL )
|
|
{
|
|
parent_guid = NULL;
|
|
}
|
|
else
|
|
{
|
|
parent_guid = qof_instance_get_guid( QOF_INSTANCE(pParent) );
|
|
}
|
|
|
|
return (gpointer)parent_guid;
|
|
}
|
|
|
|
static void
|
|
set_parent( gpointer pObject, /*@ null @*/ gpointer pValue )
|
|
{
|
|
Account* pAccount;
|
|
QofBook* pBook;
|
|
GncGUID* guid = (GncGUID*)pValue;
|
|
Account* pParent;
|
|
|
|
g_return_if_fail( pObject != NULL );
|
|
g_return_if_fail( GNC_IS_ACCOUNT(pObject) );
|
|
|
|
pAccount = GNC_ACCOUNT(pObject);
|
|
pBook = qof_instance_get_book( QOF_INSTANCE(pAccount) );
|
|
if ( guid != NULL )
|
|
{
|
|
pParent = xaccAccountLookup( guid, pBook );
|
|
if ( pParent != NULL )
|
|
{
|
|
gnc_account_append_child( pParent, pAccount );
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
set_parent_guid( gpointer pObject, /*@ null @*/ gpointer pValue )
|
|
{
|
|
account_parent_guid_struct* s = (account_parent_guid_struct*)pObject;
|
|
GncGUID* guid = (GncGUID*)pValue;
|
|
|
|
g_return_if_fail( pObject != NULL );
|
|
g_return_if_fail( pValue != NULL );
|
|
|
|
s->guid = *guid;
|
|
}
|
|
|
|
static /*@ dependent @*//*@ null @*/ Account*
|
|
load_single_account( GncSqlBackend* be, GncSqlRow* row,
|
|
GList** l_accounts_needing_parents )
|
|
{
|
|
const GncGUID* guid;
|
|
Account* pAccount = NULL;
|
|
|
|
g_return_val_if_fail( be != NULL, NULL );
|
|
g_return_val_if_fail( row != NULL, NULL );
|
|
g_return_val_if_fail( l_accounts_needing_parents != NULL, NULL );
|
|
|
|
guid = gnc_sql_load_guid( be, row );
|
|
if ( guid != NULL )
|
|
{
|
|
pAccount = xaccAccountLookup( guid, be->book );
|
|
}
|
|
if ( pAccount == NULL )
|
|
{
|
|
pAccount = xaccMallocAccount( be->book );
|
|
}
|
|
xaccAccountBeginEdit( pAccount );
|
|
gnc_sql_load_object( be, row, GNC_ID_ACCOUNT, pAccount, col_table );
|
|
xaccAccountCommitEdit( pAccount );
|
|
|
|
/* If we don't have a parent and this isn't the root account, it might be because the parent
|
|
account hasn't been loaded yet. Remember the account and its parent guid for later. */
|
|
if ( gnc_account_get_parent( pAccount ) == NULL
|
|
&& pAccount != gnc_book_get_root_account( be->book ) )
|
|
{
|
|
account_parent_guid_struct* s = g_malloc( (gsize)sizeof(account_parent_guid_struct) );
|
|
g_assert( s != NULL );
|
|
|
|
s->pAccount = pAccount;
|
|
gnc_sql_load_object( be, row, GNC_ID_ACCOUNT, s, parent_col_table );
|
|
*l_accounts_needing_parents = g_list_prepend( *l_accounts_needing_parents, s );
|
|
}
|
|
|
|
return pAccount;
|
|
}
|
|
|
|
static void
|
|
load_all_accounts( GncSqlBackend* be )
|
|
{
|
|
GncSqlStatement* stmt = NULL;
|
|
GncSqlResult* result;
|
|
QofBook* pBook;
|
|
GList* l_accounts_needing_parents = NULL;
|
|
GSList* bal_slist;
|
|
GSList* bal;
|
|
|
|
g_return_if_fail( be != NULL );
|
|
|
|
ENTER( "" );
|
|
|
|
pBook = be->book;
|
|
|
|
stmt = gnc_sql_create_select_statement( be, TABLE_NAME );
|
|
if ( stmt == NULL )
|
|
{
|
|
LEAVE( "stmt == NULL" );
|
|
return;
|
|
}
|
|
result = gnc_sql_execute_select_statement( be, stmt );
|
|
gnc_sql_statement_dispose( stmt );
|
|
if ( result != NULL )
|
|
{
|
|
GncSqlRow* row = gnc_sql_result_get_first_row( result );
|
|
gchar* sql;
|
|
|
|
while ( row != NULL )
|
|
{
|
|
load_single_account( be, row, &l_accounts_needing_parents );
|
|
row = gnc_sql_result_get_next_row( result );
|
|
}
|
|
gnc_sql_result_dispose( result );
|
|
|
|
sql = g_strdup_printf( "SELECT DISTINCT guid FROM %s", TABLE_NAME );
|
|
gnc_sql_slots_load_for_sql_subquery( be, sql, (BookLookupFn)xaccAccountLookup );
|
|
g_free( sql );
|
|
|
|
/* While there are items on the list of accounts needing parents,
|
|
try to see if the parent has now been loaded. Theory says that if
|
|
items are removed from the front and added to the back if the
|
|
parent is still not available, then eventually, the list will
|
|
shrink to size 0. */
|
|
if ( l_accounts_needing_parents != NULL )
|
|
{
|
|
gboolean progress_made = TRUE;
|
|
Account* root;
|
|
Account* pParent;
|
|
GList* elem;
|
|
|
|
while ( progress_made )
|
|
{
|
|
progress_made = FALSE;
|
|
for ( elem = l_accounts_needing_parents; elem != NULL; )
|
|
{
|
|
account_parent_guid_struct* s = (account_parent_guid_struct*)elem->data;
|
|
pParent = xaccAccountLookup( &s->guid, be->book );
|
|
if ( pParent != NULL )
|
|
{
|
|
GList* next_elem;
|
|
|
|
gnc_account_append_child( pParent, s->pAccount );
|
|
next_elem = g_list_next( elem );
|
|
l_accounts_needing_parents = g_list_delete_link( l_accounts_needing_parents, elem );
|
|
g_free( s );
|
|
elem = next_elem;
|
|
progress_made = TRUE;
|
|
}
|
|
else
|
|
{
|
|
/* Can't be up in the for loop because the 'then' clause reads inside a node freed
|
|
by g_list_delete_link(). */
|
|
elem = g_list_next( elem );
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Any non-ROOT accounts left over must be parented by the root account */
|
|
root = gnc_book_get_root_account( pBook );
|
|
while ( l_accounts_needing_parents != NULL )
|
|
{
|
|
account_parent_guid_struct* s = (account_parent_guid_struct*)l_accounts_needing_parents->data;
|
|
if ( xaccAccountGetType( s->pAccount ) != ACCT_TYPE_ROOT )
|
|
{
|
|
gnc_account_append_child( root, s->pAccount );
|
|
}
|
|
g_free( s );
|
|
l_accounts_needing_parents = g_list_delete_link( l_accounts_needing_parents, l_accounts_needing_parents );
|
|
}
|
|
}
|
|
|
|
/* Load starting balances */
|
|
bal_slist = gnc_sql_get_account_balances_slist( be );
|
|
for ( bal = bal_slist; bal != NULL; bal = bal->next )
|
|
{
|
|
acct_balances_t* balances = (acct_balances_t*)bal->data;
|
|
|
|
qof_instance_increase_editlevel (balances->acct);
|
|
g_object_set( balances->acct,
|
|
"start-balance", &balances->balance,
|
|
"start-cleared-balance", &balances->cleared_balance,
|
|
"start-reconciled-balance", &balances->reconciled_balance,
|
|
NULL);
|
|
|
|
qof_instance_decrease_editlevel (balances->acct);
|
|
}
|
|
if ( bal_slist != NULL )
|
|
{
|
|
g_slist_free( bal_slist );
|
|
}
|
|
}
|
|
|
|
LEAVE( "" );
|
|
}
|
|
|
|
/* ================================================================= */
|
|
static void
|
|
create_account_tables( GncSqlBackend* be )
|
|
{
|
|
gint version;
|
|
|
|
g_return_if_fail( be != NULL );
|
|
|
|
version = gnc_sql_get_table_version( be, TABLE_NAME );
|
|
if ( version == 0 )
|
|
{
|
|
(void)gnc_sql_create_table( be, TABLE_NAME, TABLE_VERSION, col_table );
|
|
}
|
|
}
|
|
|
|
/* ================================================================= */
|
|
gboolean
|
|
gnc_sql_save_account( GncSqlBackend* be, QofInstance* inst )
|
|
{
|
|
Account* pAcc = GNC_ACCOUNT(inst);
|
|
const GncGUID* guid;
|
|
gboolean is_infant;
|
|
gboolean is_ok = FALSE;
|
|
gnc_commodity* commodity;
|
|
gint op;
|
|
|
|
g_return_val_if_fail( be != NULL, FALSE );
|
|
g_return_val_if_fail( inst != NULL, FALSE );
|
|
g_return_val_if_fail( GNC_IS_ACCOUNT(inst), FALSE );
|
|
|
|
ENTER( "inst=%p", inst );
|
|
|
|
is_infant = qof_instance_get_infant( inst );
|
|
|
|
// If there is no commodity yet, this might be because a new account name
|
|
// has been entered directly into the register and an account window will
|
|
// be opened. The account info is not complete yet, but the name has been
|
|
// set, triggering this commit
|
|
commodity = xaccAccountGetCommodity( pAcc );
|
|
|
|
is_ok = TRUE;
|
|
if ( qof_instance_get_destroying( inst ) )
|
|
{
|
|
op = OP_DB_DELETE;
|
|
}
|
|
else if ( be->is_pristine_db || is_infant )
|
|
{
|
|
op = OP_DB_INSERT;
|
|
}
|
|
else
|
|
{
|
|
op = OP_DB_UPDATE;
|
|
}
|
|
|
|
// If not deleting the account, ensure the commodity is in the db
|
|
if ( op != OP_DB_DELETE && commodity != NULL )
|
|
{
|
|
is_ok = gnc_sql_save_commodity( be, commodity );
|
|
}
|
|
|
|
if ( is_ok )
|
|
{
|
|
is_ok = gnc_sql_do_db_operation( be, op, TABLE_NAME, GNC_ID_ACCOUNT, pAcc, col_table );
|
|
}
|
|
|
|
if ( is_ok )
|
|
{
|
|
// Now, commit or delete any slots
|
|
guid = qof_instance_get_guid( inst );
|
|
if ( !qof_instance_get_destroying(inst) )
|
|
{
|
|
is_ok = gnc_sql_slots_save( be, guid, is_infant, inst);
|
|
}
|
|
else
|
|
{
|
|
is_ok = gnc_sql_slots_delete( be, guid );
|
|
}
|
|
}
|
|
|
|
LEAVE( "is_ok=%d", is_ok );
|
|
|
|
return is_ok;
|
|
}
|
|
|
|
/* ================================================================= */
|
|
static void
|
|
load_account_guid( const GncSqlBackend* be, GncSqlRow* row,
|
|
/*@ null @*/ QofSetterFunc setter, gpointer pObject,
|
|
const GncSqlColumnTableEntry* table_row )
|
|
{
|
|
const GValue* val;
|
|
GncGUID guid;
|
|
Account* account = NULL;
|
|
|
|
g_return_if_fail( be != NULL );
|
|
g_return_if_fail( row != NULL );
|
|
g_return_if_fail( pObject != NULL );
|
|
g_return_if_fail( table_row != NULL );
|
|
|
|
val = gnc_sql_row_get_value_at_col_name( row, table_row->col_name );
|
|
if ( val != NULL && G_VALUE_HOLDS_STRING( val ) && g_value_get_string( val ) != NULL )
|
|
{
|
|
(void)string_to_guid( g_value_get_string( val ), &guid );
|
|
account = xaccAccountLookup( &guid, be->book );
|
|
if ( account != NULL )
|
|
{
|
|
if ( table_row->gobj_param_name != NULL )
|
|
{
|
|
qof_instance_increase_editlevel (pObject);
|
|
g_object_set( pObject, table_row->gobj_param_name, account, NULL );
|
|
qof_instance_decrease_editlevel (pObject);
|
|
}
|
|
else
|
|
{
|
|
g_return_if_fail( setter != NULL );
|
|
(*setter)( pObject, (const gpointer)account );
|
|
}
|
|
}
|
|
else
|
|
{
|
|
PWARN( "Account ref '%s' not found", g_value_get_string( val ) );
|
|
}
|
|
}
|
|
}
|
|
|
|
static GncSqlColumnTypeHandler account_guid_handler
|
|
= { load_account_guid,
|
|
gnc_sql_add_objectref_guid_col_info_to_list,
|
|
gnc_sql_add_colname_to_list,
|
|
gnc_sql_add_gvalue_objectref_guid_to_slist
|
|
};
|
|
/* ================================================================= */
|
|
void
|
|
gnc_sql_init_account_handler( void )
|
|
{
|
|
static GncSqlObjectBackend be_data =
|
|
{
|
|
GNC_SQL_BACKEND_VERSION,
|
|
GNC_ID_ACCOUNT,
|
|
gnc_sql_save_account, /* commit */
|
|
load_all_accounts, /* initial_load */
|
|
create_account_tables, /* create_tables */
|
|
NULL, /* compile_query */
|
|
NULL, /* run_query */
|
|
NULL, /* free_query */
|
|
NULL /* write */
|
|
};
|
|
|
|
(void)qof_object_register_backend( GNC_ID_ACCOUNT, GNC_SQL_BACKEND, &be_data );
|
|
|
|
gnc_sql_register_col_type_handler( CT_ACCOUNTREF, &account_guid_handler );
|
|
}
|
|
/* ========================== END OF FILE ===================== */
|