Inheritance diagram for CDatabase:

Collaboration diagram for CDatabase:

Classes
struct	DatasetFieldInfo

class	DatasetLayout

class	ExistsSubQuery

class	Filter

Public Member Functions
bool	IsOpen ()

virtual void	Close ()

bool	Compress (bool bForce=true)

void	Interrupt ()

bool	Open (const DatabaseSettings &db)

void	BeginTransaction ()

virtual bool	CommitTransaction ()

void	RollbackTransaction ()

void	CopyDB (const std::string &latestDb)

void	DropAnalytics ()

std::string	PrepareSQL (std::string strStmt,...) const

std::string	GetSingleValue (const std::string &strTable, const std::string &strColumn, const std::string &strWhereClause=std::string(), const std::string &strOrderBy=std::string())
	Get a single value from a table. More...

std::string	GetSingleValue (const std::string &query)

std::string	GetSingleValue (const std::string &query, std::unique_ptr< dbiplus::Dataset > &ds)
	Get a single value from a query on a dataset. More...

int	GetSingleValueInt (const std::string &strTable, const std::string &strColumn, const std::string &strWhereClause=std::string(), const std::string &strOrderBy=std::string())
	Get a single integer value from a table. More...

int	GetSingleValueInt (const std::string &query)

int	GetSingleValueInt (const std::string &query, std::unique_ptr< dbiplus::Dataset > &ds)
	Get a single integer value from a query on a dataset. More...

bool	DeleteValues (const std::string &strTable, const Filter &filter=Filter())
	Delete values from a table. More...

bool	ExecuteQuery (const std::string &strQuery)
	Execute a query that does not return any result. Note that if BeginMultipleExecute() has been called, the query will be queued until CommitMultipleExecute() is called. More...

bool	ResultQuery (const std::string &strQuery) const
	Execute a query that returns a result. More...

bool	BeginMultipleExecute ()
	Start a multiple execution queue. Any ExecuteQuery() function following this call will be queued rather than executed until CommitMultipleExecute() is performed. NOTE: Queries that rely on any queued execute query will not function as expected during this period! More...

bool	CommitMultipleExecute ()
	Commit the multiple execution queue to the database. Queries are performed within a transaction, and the transaction is rolled back should any one query fail. More...

bool	QueueInsertQuery (const std::string &strQuery)
	Put an INSERT or REPLACE query in the queue. More...

bool	CommitInsertQueries ()
	Commit all queries in the queue. More...

size_t	GetInsertQueriesCount ()
	Get the number of INSERT queries in the queue. More...

bool	QueueDeleteQuery (const std::string &strQuery)
	Put a DELETE query in the queue. More...

bool	CommitDeleteQueries ()
	Commit all queued DELETE queries. More...

size_t	GetDeleteQueriesCount ()
	Get the number of DELETE queries in the queue. More...

virtual bool	GetFilter (CDbUrl &dbUrl, Filter &filter, SortDescription &sorting)

virtual bool	BuildSQL (const std::string &strBaseDir, const std::string &strQuery, Filter &filter, std::string &strSQL, CDbUrl &dbUrl)

virtual bool	BuildSQL (const std::string &strBaseDir, const std::string &strQuery, Filter &filter, std::string &strSQL, CDbUrl &dbUrl, SortDescription &sorting)

bool	Connect (const std::string &dbName, const DatabaseSettings &db, bool create)

Protected Member Functions
void	Split (const std::string &strFileNameAndPath, std::string &strPath, std::string &strFileName)

virtual bool	Open ()

bool	CreateDatabase ()
	Create database tables and analytics as needed. Calls CreateTables() and CreateAnalytics() on child classes.

virtual void	CreateTables ()=0

virtual void	CreateAnalytics ()=0

virtual void	UpdateTables (int version)

virtual int	GetMinSchemaVersion () const

virtual int	GetSchemaVersion () const =0

virtual const char *	GetBaseDBName () const =0

int	GetDBVersion ()

bool	BuildSQL (const std::string &strQuery, const Filter &filter, std::string &strSQL)

Protected Attributes
bool	m_sqlite
	whether we use sqlite (defaults to true)

std::unique_ptr< dbiplus::Database >	m_pDB

std::unique_ptr< dbiplus::Dataset >	m_pDS

std::unique_ptr< dbiplus::Dataset >	m_pDS2

const CProfileManager &	m_profileManager

Friends
class	CDatabaseManager

Member Function Documentation

◆ BeginMultipleExecute()

bool CDatabase::BeginMultipleExecute ( )

Start a multiple execution queue. Any ExecuteQuery() function following this call will be queued rather than executed until CommitMultipleExecute() is performed. NOTE: Queries that rely on any queued execute query will not function as expected during this period!

Returns: true if we could start a multiple execution queue, false otherwise.

See also: CommitMultipleExecute, ExecuteQuery

◆ CommitDeleteQueries()

bool CDatabase::CommitDeleteQueries ( )

Commit all queued DELETE queries.

Returns: True if all queries were executed successfully, false otherwise.

◆ CommitInsertQueries()

bool CDatabase::CommitInsertQueries ( )

Commit all queries in the queue.

Returns: True if all queries were executed successfully, false otherwise.

◆ CommitMultipleExecute()

bool CDatabase::CommitMultipleExecute ( )

Commit the multiple execution queue to the database. Queries are performed within a transaction, and the transaction is rolled back should any one query fail.

Returns: True if the queries were executed successfully, false otherwise.

See also: BeginMultipleExecute, ExecuteQuery

◆ DeleteValues()

bool CDatabase::DeleteValues	(	const std::string &	strTable,
		const Filter &	filter = `Filter()`
	)

Delete values from a table.

Parameters

strTable	The table to delete the values from.
filter	The Filter to apply to this query.

Returns: True if the query was executed successfully, false otherwise.

◆ ExecuteQuery()

bool CDatabase::ExecuteQuery ( const std::string & strQuery )

Execute a query that does not return any result. Note that if BeginMultipleExecute() has been called, the query will be queued until CommitMultipleExecute() is called.

Parameters

strQuery The query to execute.

Returns: True if the query was executed successfully, false otherwise.

See also: BeginMultipleExecute, CommitMultipleExecute

◆ GetDeleteQueriesCount()

size_t CDatabase::GetDeleteQueriesCount ( )

Get the number of DELETE queries in the queue.

Returns: The number of queries.

◆ GetInsertQueriesCount()

size_t CDatabase::GetInsertQueriesCount ( )

Get the number of INSERT queries in the queue.

Returns: The number of queries.

◆ GetSingleValue() [1/2]

std::string CDatabase::GetSingleValue	(	const std::string &	strTable,
		const std::string &	strColumn,
		const std::string &	strWhereClause = `std::string()`,
		const std::string &	strOrderBy = `std::string()`
	)

Get a single value from a table.

Remarks: The values of the strWhereClause and strOrderBy parameters have to be FormatSQL'ed when used.

Parameters

strTable	The table to get the value from.
strColumn	The column to get.
strWhereClause	If set, use this WHERE clause.
strOrderBy	If set, use this ORDER BY clause.

Returns: The requested value or an empty string if it wasn't found.

◆ GetSingleValue() [2/2]

std::string CDatabase::GetSingleValue	(	const std::string &	query,
		std::unique_ptr< dbiplus::Dataset > &	ds
	)

Get a single value from a query on a dataset.

Parameters

query	the query in question.
ds	the dataset to use for the query.

Returns: the value from the query, empty on failure.

◆ GetSingleValueInt() [1/2]

int CDatabase::GetSingleValueInt	(	const std::string &	strTable,
		const std::string &	strColumn,
		const std::string &	strWhereClause = `std::string()`,
		const std::string &	strOrderBy = `std::string()`
	)

Get a single integer value from a table.

Remarks: The values of the strWhereClause and strOrderBy parameters have to be FormatSQL'ed when used.

Parameters

strTable	The table to get the value from.
strColumn	The column to get.
strWhereClause	If set, use this WHERE clause.
strOrderBy	If set, use this ORDER BY clause.

Returns: The requested value or 0 if it wasn't found.

◆ GetSingleValueInt() [2/2]

int CDatabase::GetSingleValueInt	(	const std::string &	query,
		std::unique_ptr< dbiplus::Dataset > &	ds
	)

Get a single integer value from a query on a dataset.

Parameters

query	the query in question.
ds	the dataset to use for the query.

Returns: the value from the query, 0 on failure.

◆ QueueDeleteQuery()

bool CDatabase::QueueDeleteQuery ( const std::string & strQuery )

Put a DELETE query in the queue.

Parameters

strQuery The query to queue.

Returns: True if the query was added successfully, false otherwise.

◆ QueueInsertQuery()

bool CDatabase::QueueInsertQuery ( const std::string & strQuery )

Put an INSERT or REPLACE query in the queue.

Parameters

strQuery The query to queue.

Returns: True if the query was added successfully, false otherwise.

◆ ResultQuery()

bool CDatabase::ResultQuery ( const std::string & strQuery ) const

Execute a query that returns a result.

Remarks: Call m_pDS->close(); to clean up the dataset when done.

Parameters

strQuery The query to execute.

Returns: True if the query was executed successfully, false otherwise.

The documentation for this class was generated from the following files:

xbmc/dbwrappers/Database.h
xbmc/dbwrappers/Database.cpp

Classes

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Member Function Documentation

◆ BeginMultipleExecute()

◆ CommitDeleteQueries()

◆ CommitInsertQueries()

◆ CommitMultipleExecute()

◆ DeleteValues()

◆ ExecuteQuery()

◆ GetDeleteQueriesCount()

◆ GetInsertQueriesCount()

◆ GetSingleValue() [1/2]

◆ GetSingleValue() [2/2]

◆ GetSingleValueInt() [1/2]

◆ GetSingleValueInt() [2/2]

◆ QueueDeleteQuery()

◆ QueueInsertQuery()

◆ ResultQuery()