#include <datadescriptiondefinitiondatabaseimpl.h>

Inheritance diagram for DataDescriptionDefinitionDatabaseImplInterface:

Detailed Description

Allows to create different implementations of data description database stores.

Public Member Functions
MAXON_METHOD Bool	Contains (const Id &category, const IdAndVersion &dataType, const LanguageRef &language) const

MAXON_METHOD Result< DataDescriptionDefinition >	LoadDescription (LOADDESCRIPTIONMODE mode, const Id &category, const LanguageRef &language, const IdAndVersion &dataType, Id *foundInDatabase=nullptr) const

MAXON_METHOD Result< Tuple< Bool, DataDescriptionDefinition * > >	StoreDescription (const Id &databaseId, const Id &category, const LanguageRef &language, const IdAndVersion &dataType, const DataDescriptionDefinition &description, const DataDescriptionDefinition &overwrittenDescription, Bool usePendingSystem)

MAXON_METHOD Result< Bool >	DeleteDescription (const Id &category, const LanguageRef &language, const IdAndVersion &dataType)

MAXON_METHOD Result< BaseArray< IdAndVersion > >	GetRegisteredDescriptions (const Id &category, const LanguageRef &language) const

MAXON_METHOD Result< BaseArray< LanguageRef > >	GetRegisteredLanguages () const

MAXON_METHOD Result< void >	WriteDataBases () const

MAXON_METHOD Result< Int >	RenameId (const Id &oldId, const Id &newId)

MAXON_METHOD Result< Int >	RenameAttribute (const InternedId &oldId, const InternedId &newId)

MAXON_METHOD Result< Bool >	CheckUniqueAttributeName (const InternedId &searchId) const

MAXON_METHOD Result< DataDescription >	UpdateDescriptions (const Id &category, const IdAndVersion &dataTypeId, const LanguageRef &language) const

MAXON_METHOD Bool	IsWritableDatabase (const Id &languageId) const

MAXON_METHOD Int	GetChangeCounts () const

MAXON_METHOD Int	GetUserChangeCount () const

MAXON_METHOD Result< void >	Write () const

MAXON_METHOD Result< void >	WriteUserChangedDataBases ()

Private Member Functions
	MAXON_INTERFACE (DataDescriptionDefinitionDatabaseImplInterface, MAXON_REFERENCE_NORMAL, "net.maxon.interface.datadescriptiondefinitiondatabaseimpl", MAXON_IMPLEMENTATION_MODULE("net.maxon.kernel"))

Member Function Documentation

◆ MAXON_INTERFACE()

MAXON_INTERFACE	(	DataDescriptionDefinitionDatabaseImplInterface	,
		MAXON_REFERENCE_NORMAL	,
		"net.maxon.interface.datadescriptiondefinitiondatabaseimpl"	,
		MAXON_IMPLEMENTATION_MODULE("net.maxon.kernel")
	)

private

◆ Contains()

MAXON_METHOD Bool Contains	(	const Id &	category,
		const IdAndVersion &	dataType,
		const LanguageRef &	language
	)		const

checks if the database contains the datatype.

Parameters

[in]	category	Database category (e.g. DATADESCRIPTION_CATEGORY_DATA / DATADESCRIPTION_CATEGORY_UI).
[in]	dataType	Data type id to load.
[in]	language	Language (only valid for category DATADESCRIPTION_CATEGORY_STRING).

Returns: True if the database contains the data type.

◆ LoadDescription()

MAXON_METHOD Result<DataDescriptionDefinition> LoadDescription	(	LOADDESCRIPTIONMODE	mode,
		const Id &	category,
		const LanguageRef &	language,
		const IdAndVersion &	dataType,
		Id *	foundInDatabase = `nullptr`
	)		const

Loads a description from the registered databases.

Parameters

[in]	category	Database category (e.g. DATADESCRIPTION_CATEGORY_DATA / DATADESCRIPTION_CATEGORY_UI).
[in]	language	Language (only valid for category DATADESCRIPTION_CATEGORY_STRING).
[in]	dataType	Data type id to load.
[out]	foundInDatabase	Optional: Pointer to an Id of the database where the entry was found.

Returns: DataDescriptionDefinition on success.

◆ StoreDescription()

MAXON_METHOD Result<Tuple<Bool, DataDescriptionDefinition*> > StoreDescription	(	const Id &	databaseId,
		const Id &	category,
		const LanguageRef &	language,
		const IdAndVersion &	dataType,
		const DataDescriptionDefinition &	description,
		const DataDescriptionDefinition &	overwrittenDescription,
		Bool	usePendingSystem
	)

Stores the given description under the given values.

Parameters

[in]	databaseId	Database id (see RegisterDatabase()/GetRegisteredDatabases()).
[in]	category	Database category (e.g. DATADESCRIPTION_CATEGORY_DATA / DATADESCRIPTION_CATEGORY_UI).
[in]	language	Language (only valid for category DATADESCRIPTION_CATEGORY_STRING).
[in]	dataType	Data type id to store.
[in]	description	Description data to store.

Returns: Tuple with a Bool (changed or not) and the pointer of the stored description if changed. Error otherwise.

◆ DeleteDescription()

MAXON_METHOD Result<Bool> DeleteDescription	(	const Id &	category,
		const LanguageRef &	language,
		const IdAndVersion &	dataType
	)

DeleteDescription deletes a description from the database.

Parameters

[in]	category	Database category (e.g. DATADESCRIPTION_CATEGORY_DATA / DATADESCRIPTION_CATEGORY_UI).
[in]	language	Language (only valid for category DATADESCRIPTION_CATEGORY_STRING).
[in]	dataType	Data type id to delete.

Returns: True/False on success. True means the description was found and deleted. False if the description was not found.

◆ GetRegisteredDescriptions()

MAXON_METHOD Result<BaseArray<IdAndVersion> > GetRegisteredDescriptions	(	const Id &	category,
		const LanguageRef &	language
	)		const

Return all registered descriptions.

Parameters

[in]	category	Database category (e.g. DATADESCRIPTION_CATEGORY_DATA / DATADESCRIPTION_CATEGORY_UI).
[in]	language	Language (only valid for category DATADESCRIPTION_CATEGORY_STRING).

Returns: Array on success.

◆ GetRegisteredLanguages()

MAXON_METHOD Result<BaseArray<LanguageRef> > GetRegisteredLanguages ( ) const

Returns all registered languages of this database.

Returns: Array with languages on success.

◆ WriteDataBases()

MAXON_METHOD Result<void> WriteDataBases ( ) const

Save all databases (including user changes and version update changes).

Returns: OK on success.

◆ RenameId()

MAXON_METHOD Result<Int> RenameId	(	const Id &	oldId,
		const Id &	newId
	)

Renames a id in all databases to the new id.

Parameters

[in]	oldId	Old id to rename
[in]	newId	Id to replace.

Returns: Number of values that were renamed.

◆ RenameAttribute()

MAXON_METHOD Result<Int> RenameAttribute	(	const InternedId &	oldId,
		const InternedId &	newId
	)

Renames an attribute in all databases.

Parameters

[in]	oldId	Old attribute key.
[in]	newId	New attribute key.

Returns: Number of values that were renamed.

◆ CheckUniqueAttributeName()

MAXON_METHOD Result<Bool> CheckUniqueAttributeName ( const InternedId & searchId ) const

Checks if the given id is unique in all databases.

Parameters

[in] searchId Id to search for.

Returns: True if the id is unique. False if the id already exists.

◆ UpdateDescriptions()

MAXON_METHOD Result<DataDescription> UpdateDescriptions	(	const Id &	category,
		const IdAndVersion &	dataTypeId,
		const LanguageRef &	language
	)		const

Updates the description from the given DataDescriptionDefinition.

Parameters

[in]	category	Category to search.
[in]	dataTypeId	Data type id to process.
[in]	language	Language to process.

Returns: OK on success.

◆ IsWritableDatabase()

MAXON_METHOD Bool IsWritableDatabase ( const Id & languageId ) const

Returns true if the database is writable.

Parameters

[in] languageId Language id to check.

◆ GetChangeCounts()

MAXON_METHOD Int GetChangeCounts ( ) const

Returns the number of changes made since the last Write(). This includes user changes and all automatic version update changes.

Returns: The number of changes.

◆ GetUserChangeCount()

MAXON_METHOD Int GetUserChangeCount ( ) const

Returns the number of changes made by user since the last Write().

Returns: The number of changes.

◆ Write()

MAXON_METHOD Result<void> Write ( ) const

Writes all changes permanently to hard drive.

Returns: OK on success.

◆ WriteUserChangedDataBases()

MAXON_METHOD Result<void> WriteUserChangedDataBases ( )

Save all databases edited by a user.

Returns: OK on success.

Detailed Description

Public Member Functions

Private Member Functions

Member Function Documentation

◆ MAXON_INTERFACE()

◆ Contains()

◆ LoadDescription()

◆ StoreDescription()

◆ DeleteDescription()

◆ GetRegisteredDescriptions()

◆ GetRegisteredLanguages()

◆ WriteDataBases()

◆ RenameId()

◆ RenameAttribute()

◆ CheckUniqueAttributeName()

◆ UpdateDescriptions()

◆ IsWritableDatabase()

◆ GetChangeCounts()

◆ GetUserChangeCount()

◆ Write()

◆ WriteUserChangedDataBases()