qofsession.cpp File Reference

Encapsulate a connection to a storage backend. More...

#include <glib.h>
#include <config.h>
#include <stdlib.h>
#include <sys/types.h>
#include <sys/stat.h>
#include "qof.h"
#include "qofobject-p.h"
#include "qofbook-p.h"
#include "qof-backend.hpp"
#include "qofsession.hpp"
#include "gnc-backend-prov.hpp"
#include <vector>
#include <boost/algorithm/string.hpp>
#include <algorithm>
#include <string>
#include <sstream>

Go to the source code of this file.

Typedefs
using	ProviderVec = std::vector< QofBackendProvider_ptr >

Functions
ProviderVec &	get_providers (void)
bool	get_providers_initialized (void)
void	qof_backend_register_provider (QofBackendProvider_ptr &&prov)
	Let the system know about a new provider of backends. More...
void	qof_backend_unregister_all_providers ()
GList *	qof_backend_get_registered_access_method_list (void)
	Return a list of strings for the registered access methods. More...
void	qof_session_destroy (QofSession *session)
QofSession *	qof_session_new (QofBook *book)
const char *	qof_session_get_error_message (const QofSession *session)
QofBackendError	qof_session_pop_error (QofSession *session)
	The qof_session_pop_error() routine can be used to obtain the reason for any failure. More...
QofBook *	qof_session_get_book (const QofSession *session)
	Returns the QofBook of this session. More...
const char *	qof_session_get_file_path (const QofSession *session)
	The qof_session_get_file_path() routine returns the fully-qualified file path for the session. More...
void	qof_session_ensure_all_data_loaded (QofSession *session)
	Ensure all of the data is loaded from the session.
const char *	qof_session_get_url (const QofSession *session)
QofBackend *	qof_session_get_backend (const QofSession *session)
	Returns the qof session's backend.
void	qof_session_begin (QofSession *session, const char *uri, SessionOpenMode mode)
	Begins a new session. More...
void	qof_session_load (QofSession *session, QofPercentageFunc percentage_func)
void	qof_session_save (QofSession *session, QofPercentageFunc percentage_func)
	The qof_session_save() method will commit all changes that have been made to the session. More...
void	qof_session_safe_save (QofSession *session, QofPercentageFunc percentage_func)
	A special version of save used in the sql backend which moves the existing tables aside, then saves everything to new tables, then deletes the old tables after the save is completed without error. More...
gboolean	qof_session_save_in_progress (const QofSession *session)
	The qof_session_not_saved() subroutine will return TRUE if any data in the session hasn't been saved to long-term storage.
void	qof_session_end (QofSession *session)
	The qof_session_end() method will release the session lock. More...
void	qof_session_swap_data (QofSession *session_1, QofSession *session_2)
	The qof_session_swap_data () method swaps the book of the two given sessions. More...
gboolean	qof_session_events_pending (const QofSession *session)
	The qof_session_events_pending() method will return TRUE if the backend has pending events which must be processed to bring the engine up to date with the backend.
gboolean	qof_session_process_events (QofSession *session)
	The qof_session_process_events() method will process any events indicated by the qof_session_events_pending() method. More...
gboolean	qof_session_export (QofSession *tmp_session, QofSession *real_session, QofPercentageFunc percentage_func)
void	init_static_qofsession_pointers (void)
void	qof_session_load_backend (QofSession *session, const char *access_method)
void	qof_session_set_uri (QofSession *session, char const *uri)
QofBackendError	qof_session_get_error (QofSession *session)
	The qof_session_get_error() routine can be used to obtain the reason for any failure. More...

Variables
void(*	p_qof_session_load_backend )(QofSession *, const char *access_method)
void(*	p_qof_session_clear_error )(QofSession *)
void(*	p_qof_session_destroy_backend )(QofSession *)
void(*	p_qof_session_set_uri )(QofSession *, char const *uri)

Detailed Description

Encapsulate a connection to a storage backend.

HISTORY: Created by Linas Vepstas December 1998

Author

Copyright (c) 1998-2004 Linas Vepstas linas.nosp@m.@lin.nosp@m.as.or.nosp@m.g

Copyright (c) 2000 Dave Peticolas

Copyright (c) 2005 Neil Williams linux.nosp@m.@cod.nosp@m.ehelp.nosp@m..co..nosp@m.uk

Copyright (c) 2016 Aaron Laws

Definition in file qofsession.cpp.

Function Documentation

qof_backend_get_registered_access_method_list()

GList* qof_backend_get_registered_access_method_list

(

void

)

Return a list of strings for the registered access methods.

The owner is responsible for freeing the list but not the strings.

Definition at line 103 of file qofsession.cpp.

{
    GList* list = NULL;
    std::for_each(s_providers.begin(), s_providers.end(),
                  [&list](QofBackendProvider_ptr& provider) {
                      gpointer method = reinterpret_cast<gpointer>(const_cast<char*>(provider->access_method));
                      list = g_list_prepend(list, method);
                  });
    return list;
}

qof_backend_register_provider()

void qof_backend_register_provider

(

QofBackendProvider_ptr &&

)

Let the system know about a new provider of backends.

This function is typically called by the provider library at library load time. This function allows the backend library to tell the QOF infrastructure that it can handle URL's of a certain type. Note that a single backend library may register more than one provider, if it is capable of handling more than one URL access method.

Definition at line 90 of file qofsession.cpp.

{
    s_providers.emplace_back(std::move(prov));
}

qof_session_process_events()

gboolean qof_session_process_events

(

QofSession *

session

)

The qof_session_process_events() method will process any events indicated by the qof_session_events_pending() method.

It returns TRUE if the engine was modified while engine events were suspended.

Definition at line 669 of file qofsession.cpp.

{
    if (!session) return FALSE;
    return session->process_events ();
}