The backend layer main class, a backend implementation of Sword. More...

#include <cswordbackend.h>

Inheritance diagram for CSwordBackend:

Classes
struct	Private

Public Types
enum	LoadError { NoSwordConfig = -1 , NoError = 0 , NoModules = 1 }
	The error codes which may be returned by the Load() call. More...

Signals
void	sigSwordSetupChanged ()

Public Member Functions
std::shared_ptr< AvailableLanguagesCacheContainer const >	availableLanguages () noexcept

QString	booknameLanguage () const

	CSwordBackend ()
	Creates the regular CSwordBackend instance.

	CSwordBackend (const QString &path, const bool augmentHome=true)

void	deleteOrphanedIndices ()

CSwordModuleInfo *	findFirstAvailableModule (CSwordModuleInfo::ModuleType type)

CSwordModuleInfo *	findModuleByName (const QString &name) const
	Searches for a module with the given name.

CSwordModuleInfo *	findSwordModuleByPointer (const sword::SWModule *const swmodule) const
	Searches for a module with the given sword module as module().

sword::SWConfig *	getConfig () const

BtConstModuleList	getConstPointerList (const QStringList &names) const

QList< CSwordModuleInfo * >	getPointerList (const QStringList &names) const

CSwordBackend::LoadError	initModules ()
	Initializes the Sword modules.

std::shared_ptr< BtBookshelfModel >	model ()

QList< CSwordModuleInfo * > const &	moduleList () const

QString	prefixPath () const

sword::SWMgr &	raw ()

void	reloadModules ()
	Reloads all Sword modules.

void	setBooknameLanguage (QString const &langName)
	Sets the language for the international booknames of Sword.

void	setFilterOptions (const FilterOptions &options)

void	setOption (CSwordModuleInfo::FilterOption const &type, const int state)
	Sets the state of the given filter option.

void	shutdownModules ()
	Deinitializes and frees the modules.

QStringList	swordDirList () const
	Sword prefix list.

void	uninstallModules (BtConstModuleSet const &modules)
	Uninstalls the given modules.

	~CSwordBackend () override

Static Public Member Functions
static CSwordBackend &	instance () noexcept

Private Types
using	AvailableLanguagesCacheContainer = std::set< std::shared_ptr< Language const > >

Private Attributes
std::atomic< std::shared_ptr< AvailableLanguagesCacheContainer const > >	m_availableLanguagesCache

std::shared_ptr< BtBookshelfModel > const	m_dataModel

CSwordBackend::Private	m_manager

Static Private Attributes
static CSwordBackend *	m_instance = nullptr

Detailed Description

The backend layer main class, a backend implementation of Sword.

This is the implementation of CBackend for Sword. It's additionally derived from SWMgr to provide functions of Sword.

Note: Mostly, only one instance of this class is used. This instance is created by BibleTime::initBackends() and is destroyed by BibleTimeApp::~BibleTimeApp(). Only when managing modules separate backends are created.

Definition at line 57 of file cswordbackend.h.

Member Typedef Documentation

◆ AvailableLanguagesCacheContainer

using CSwordBackend::AvailableLanguagesCacheContainer = std::set<std::shared_ptr<Language const> >

private

Definition at line 75 of file cswordbackend.h.

Member Enumeration Documentation

◆ LoadError

enum CSwordBackend::LoadError

The error codes which may be returned by the Load() call.

Note: These values exist to cast from the char return of SWMgr::Load().

Enumerator
NoSwordConfig
NoError
NoModules

Definition at line 67 of file cswordbackend.h.

Constructor & Destructor Documentation

◆ CSwordBackend() [1/2]

CSwordBackend::CSwordBackend ( )

Creates the regular CSwordBackend instance.

Warning: Should only be called once.

Definition at line 56 of file cswordbackend.cpp.

References booknameLanguage(), BT_ASSERT, BT_CONNECT, btConfig(), deleteOrphanedIndices(), initModules(), m_availableLanguagesCache, m_dataModel, m_instance, and setBooknameLanguage().

◆ CSwordBackend() [2/2]

CSwordBackend::CSwordBackend	(	const QString &	path,
		const bool	augmentHome = `true`
	)

Note: Used by BtInstallBackend only.; Using augmentHome=false can mess up the system because it is true elsewhere.

Parameters

[in]	path	The path which is used to load modules.
[in]	augmentHome	Whether $HOME/.sword/ modules should be augmented with the other modules.

Definition at line 80 of file cswordbackend.cpp.

◆ ~CSwordBackend()

CSwordBackend::~CSwordBackend ( )

override

Definition at line 87 of file cswordbackend.cpp.

References shutdownModules().

Member Function Documentation

◆ availableLanguages()

std::shared_ptr< CSwordBackend::AvailableLanguagesCacheContainer const > CSwordBackend::availableLanguages ( )

noexcept

Definition at line 101 of file cswordbackend.cpp.

References m_availableLanguagesCache, m_dataModel, and model().

Referenced by BtFontSettingsPage::BtFontSettingsPage(), and CDisplayTemplateMgr::fillTemplate().

◆ booknameLanguage()

QString CSwordBackend::booknameLanguage ( ) const

Returns: the language for the international booknames of Sword.

Definition at line 332 of file cswordbackend.cpp.

References BtLocaleMgr::defaultLocaleName().

Referenced by CSwordBibleModuleInfo::books(), and CSwordBackend().

◆ deleteOrphanedIndices()

void CSwordBackend::deleteOrphanedIndices ( )

Deletes all indices of modules where hasIndex() returns false (because of wrong index version etc.) and deletes all orphaned indexes (no module present) if autoDeleteOrphanedIndices is true.

Definition at line 464 of file cswordbackend.cpp.

References btConfig(), CSwordModuleInfo::deleteIndexForModule(), findModuleByName(), and CSwordModuleInfo::getGlobalBaseIndexLocation().

Referenced by CSwordBackend().

◆ findFirstAvailableModule()

CSwordModuleInfo * CSwordBackend::findFirstAvailableModule ( CSwordModuleInfo::ModuleType type )

Definition at line 91 of file cswordbackend.cpp.

References moduleList().

Referenced by anonymous_namespace{osistohtml.cpp}::renderReference(), and Filters::TeiToHtml::renderReference().

◆ findModuleByName()

CSwordModuleInfo * CSwordBackend::findModuleByName ( const QString & name ) const

Searches for a module with the given name.

Parameters

[in] name The name of the desired module.

Returns: a pointer to the desired module or NULL if not found.

Definition at line 318 of file cswordbackend.cpp.

References m_dataModel.

Referenced by Search::CModuleResultView::activeModule(), ReferenceManager::decodeHyperlink(), anonymous_namespace{btinforendering.cpp}::decodeSwordReference(), deleteOrphanedIndices(), BtQuickWidget::dragEnterEvent(), CBookmarkIndex::dropEvent(), anonymous_namespace{btbookshelfworkspage.cpp}::filter(), getConstPointerList(), BtConfig::getDefaultSwordModuleByType(), BtQmlInterface::getFontsFromSettings(), getPointerList(), Search::BtSearchOptionsArea::initConnections(), CDisplayWindow::lookupKey(), BibleTime::reloadProfile(), BtInstallThread::removeModule(), and Filters::TeiToHtml::renderReference().

◆ findSwordModuleByPointer()

CSwordModuleInfo * CSwordBackend::findSwordModuleByPointer ( const sword::SWModule *const swmodule ) const

Searches for a module with the given sword module as module().

Parameters

[in] swmodule The SWModule of the desired module.

Returns: a pointer to the desired module or NULL if not found.

Definition at line 325 of file cswordbackend.cpp.

References m_dataModel.

Referenced by anonymous_namespace{osistohtml.cpp}::renderReference().

◆ getConfig()

sword::SWConfig * CSwordBackend::getConfig ( ) const

inline

Returns: The global config object containing the configs of all modules merged together.

Definition at line 168 of file cswordbackend.h.

References m_manager.

Referenced by CSwordModuleInfo::isEncrypted().

◆ getConstPointerList()

BtConstModuleList CSwordBackend::getConstPointerList ( const QStringList & names ) const

Parameters

[in] names The names of the modules to return.

Returns: a list of pointers to const modules, created from a list of module names.

Definition at line 179 of file cswordbackend.cpp.

References findModuleByName().

◆ getPointerList()

QList< CSwordModuleInfo * > CSwordBackend::getPointerList ( const QStringList & names ) const

Parameters

[in] names The names of the modules to return.

Returns: a list of pointers to modules, created from a list of module names.

Definition at line 171 of file cswordbackend.cpp.

References findModuleByName().

◆ initModules()

CSwordBackend::LoadError CSwordBackend::initModules ( )

Initializes the Sword modules.

Returns: whether the initializiation was successful.

Todo:: Refactor data model to use shared_ptr to contain works

Definition at line 187 of file cswordbackend.cpp.

References BT_ASSERT, btConfig(), m_dataModel, m_manager, shutdownModules(), and sigSwordSetupChanged().

Referenced by CSwordBackend(), and reloadModules().

◆ instance()

static CSwordBackend & CSwordBackend::instance ( )

inlinestaticnoexcept

Returns: the singleton instance.

Definition at line 99 of file cswordbackend.h.

References BT_ASSERT, and m_instance.

Referenced by Search::CModuleResultView::activeModule(), BtBookshelfDockWidget::BtBookshelfDockWidget(), BtBookshelfWorksPage::BtBookshelfWorksPage(), BtFontSettingsPage::BtFontSettingsPage(), BtIndexDialog::BtIndexDialog(), BtModelViewReadDisplay::BtModelViewReadDisplay(), BtOpenWorkAction::BtOpenWorkAction(), BtSearchModuleChooserDialog::BtSearchModuleChooserDialog(), CDisplayWindow::CDisplayWindow(), BtIndexDialog::createIndices(), BtInstallPageModel::data(), anonymous_namespace{btinforendering.cpp}::decodeFootnote(), ReferenceManager::decodeHyperlink(), anonymous_namespace{btinforendering.cpp}::decodeSwordReference(), BtIndexDialog::deleteIndices(), BtQuickWidget::dragEnterEvent(), CBookmarkIndex::dropEvent(), Search::CModuleResultView::executed(), CDisplayTemplateMgr::fillTemplate(), anonymous_namespace{btbookshelfworkspage.cpp}::filter(), BtConfig::getDefaultSwordModuleByType(), anonymous_namespace{btinforendering.cpp}::getFirstAvailableStrongsModule(), BtQmlInterface::getFontsFromSettings(), CSwordModuleInfo::getFormattedConfigEntry(), Search::BtSearchOptionsArea::initConnections(), Search::CRangeChooserDialog::initConnections(), BtBookshelfRemoveFinalPage::initializePage(), CDisplayWindow::lookupKey(), main(), BibleTime::moduleUnlock(), BtTextBrowser::mouseMoveEvent(), ReferenceManager::parseVerseReference(), BtIndexDialog::populateModuleList(), Filters::GbfToHtml::processText(), CDisplayWindow::reload(), CBibleReadWindow::reload(), CCommentaryReadWindow::reload(), BibleTime::reloadProfile(), BtInstallThread::removeModule(), Rendering::CTextRendering::renderKeyTree(), anonymous_namespace{osistohtml.cpp}::renderReference(), Filters::TeiToHtml::renderReference(), Filters::TeiToHtml::renderTargetReference(), CSwordModuleSearch::search(), BtQmlInterface::setRawText(), BtBookshelfWorksPage::slotInitPathCombo(), BibleTime::slotSettingsOptions(), BtBookshelfInstallFinalPage::slotThreadFinished(), BtModelViewReadDisplay::text(), BtBookshelfTaskPage::timeToUpdate(), and anonymous_namespace{btbookmarksmodel.cpp}::BookmarkItem::toolTip().

◆ model()

std::shared_ptr< BtBookshelfModel > CSwordBackend::model ( )

inline

Definition at line 112 of file cswordbackend.h.

References m_dataModel.

Referenced by availableLanguages().

◆ moduleList()

QList< CSwordModuleInfo * > const & CSwordBackend::moduleList ( ) const

inline

Warning: You have to call initModules() first.

Note: This method is equivalent to model()->modules().

Returns: The list of modules managed by this backend.

Definition at line 109 of file cswordbackend.h.

References m_dataModel.

Referenced by findFirstAvailableModule(), anonymous_namespace{btinforendering.cpp}::getFirstAvailableStrongsModule(), main(), and BtIndexDialog::populateModuleList().

◆ prefixPath()

QString CSwordBackend::prefixPath ( ) const

inline

Definition at line 208 of file cswordbackend.h.

References m_manager.

Referenced by CSwordBackend::Private::reloadConfig(), BtInstallThread::removeModule(), and uninstallModules().

◆ raw()

sword::SWMgr & CSwordBackend::raw ( )

inline

Definition at line 211 of file cswordbackend.h.

References m_manager.

Referenced by CSwordModuleInfo::unlock().

◆ reloadModules()

void CSwordBackend::reloadModules ( )

Reloads all Sword modules.

Definition at line 355 of file cswordbackend.cpp.

References initModules(), m_manager, CSwordBackend::Private::reloadConfig(), and shutdownModules().

Referenced by BtBookshelfInstallFinalPage::slotThreadFinished().

◆ setBooknameLanguage()

void CSwordBackend::setBooknameLanguage ( QString const & langName )

Sets the language for the international booknames of Sword.

Parameters

[in] langName The abbreviation string which should be used for the Sword backend.

Definition at line 335 of file cswordbackend.cpp.

References BtLocaleMgr::defaultLocaleName(), m_dataModel, and BtLocaleMgr::setDefaultLocaleName().

Referenced by CSwordBackend(), and BibleTime::slotSettingsOptions().

◆ setFilterOptions()

void CSwordBackend::setFilterOptions ( const FilterOptions & options )

Definition at line 302 of file cswordbackend.cpp.

Referenced by CSwordModuleInfo::buildIndex(), anonymous_namespace{btinforendering.cpp}::decodeFootnote(), Rendering::CTextRendering::renderKeyTree(), CSwordModuleSearch::search(), BtModelViewReadDisplay::text(), and anonymous_namespace{btbookmarksmodel.cpp}::BookmarkItem::toolTip().

◆ setOption()

void CSwordBackend::setOption	(	CSwordModuleInfo::FilterOption const &	type,
		const int	state
	)

Sets the state of the given filter option.

Parameters

[in]	type	The filter type whose state to set.
[in]	state	The new filter option state.

Definition at line 298 of file cswordbackend.cpp.

References m_manager, CSwordModuleInfo::FilterOption::optionName, and CSwordModuleInfo::FilterOption::valueToString.

Referenced by CSwordModuleInfo::buildIndex(), setFilterOptions(), and CSwordModuleInfo::setImportantFilterOptions().

◆ shutdownModules()

void CSwordBackend::shutdownModules ( )

Deinitializes and frees the modules.

Returns: whether the method succeeded.

Definition at line 276 of file cswordbackend.cpp.

References m_dataModel, m_manager, and CSwordBackend::Private::shutdownModules().

Referenced by initModules(), reloadModules(), and ~CSwordBackend().

◆ sigSwordSetupChanged

void CSwordBackend::sigSwordSetupChanged ( )

signal

Referenced by BtBookshelfWorksPage::BtBookshelfWorksPage(), BtIndexDialog::BtIndexDialog(), CDisplayWindow::CDisplayWindow(), initModules(), and uninstallModules().

◆ swordDirList()

QStringList CSwordBackend::swordDirList ( ) const

Sword prefix list.

Returns: A list of all known Sword prefix dirs

Definition at line 377 of file cswordbackend.cpp.

References util::directory::getUserHomeSwordDir(), and m_manager.

Referenced by BtBookshelfWorksPage::slotInitPathCombo().

◆ uninstallModules()

void CSwordBackend::uninstallModules ( BtConstModuleSet const & modules )

Uninstalls the given modules.

Parameters

[in] modules The modules to uninstall.

Definition at line 128 of file cswordbackend.cpp.

References CSwordModuleInfo::AbsoluteDataPath, CSwordModuleInfo::DataPath, m_dataModel, prefixPath(), and sigSwordSetupChanged().

Referenced by BtBookshelfRemoveFinalPage::initializePage().

Member Data Documentation

◆ m_availableLanguagesCache

std::atomic<std::shared_ptr<AvailableLanguagesCacheContainer const> > CSwordBackend::m_availableLanguagesCache

private

Definition at line 242 of file cswordbackend.h.

Referenced by availableLanguages(), and CSwordBackend().

◆ m_dataModel

std::shared_ptr<BtBookshelfModel> const CSwordBackend::m_dataModel

private

Definition at line 240 of file cswordbackend.h.

Referenced by availableLanguages(), CSwordBackend(), findModuleByName(), findSwordModuleByPointer(), initModules(), model(), moduleList(), setBooknameLanguage(), shutdownModules(), and uninstallModules().

◆ m_instance

CSwordBackend * CSwordBackend::m_instance = nullptr

staticprivate

Definition at line 244 of file cswordbackend.h.

Referenced by CSwordBackend(), and instance().

◆ m_manager

CSwordBackend::Private CSwordBackend::m_manager

private

Referenced by getConfig(), initModules(), prefixPath(), raw(), reloadModules(), setOption(), shutdownModules(), and swordDirList().

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

Classes

Public Types

Signals

Public Member Functions

Static Public Member Functions

Private Types

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

◆ AvailableLanguagesCacheContainer

Member Enumeration Documentation

◆ LoadError

Constructor & Destructor Documentation

◆ CSwordBackend() [1/2]

◆ CSwordBackend() [2/2]

◆ ~CSwordBackend()

Member Function Documentation

◆ availableLanguages()

◆ booknameLanguage()

◆ deleteOrphanedIndices()

◆ findFirstAvailableModule()

◆ findModuleByName()

◆ findSwordModuleByPointer()

◆ getConfig()

◆ getConstPointerList()

◆ getPointerList()

◆ initModules()

◆ instance()

◆ model()

◆ moduleList()

◆ prefixPath()

◆ raw()

◆ reloadModules()

◆ setBooknameLanguage()

◆ setFilterOptions()

◆ setOption()

◆ shutdownModules()

◆ sigSwordSetupChanged

◆ swordDirList()

◆ uninstallModules()

Member Data Documentation

◆ m_availableLanguagesCache

◆ m_dataModel

◆ m_instance

◆ m_manager