DataProvider.qc.dox.h
// -*- mode: c++; indent-tabs-mode: nil -*-
namespace DataProvider {
class DataProvider {
public:
const FactoryMap = {
"db": "DbDataProvider",
"swagger": "SwaggerDataProvider",
"cdsrest": "CdsRestDataProvider",
"csvread": "CsvUtil",
"csvwrite": "CsvUtil",
"fixedlengthread": "FixedLengthUtil",
"fixedlengthwrite": "FixedLengthUtil",
"salesforcerest": "SalesforceRestDataProvider",
"servicenowrest": "ServiceNowRestDataProvider",
// provided by the xml module
"soap": "SoapDataProvider",
};
const TypeMap = {
"qore/ftp": "FtpPollerUtil",
"qore/sftp": "SftpPollerUtil",
"qore/fsevents": "FsEventPollerUtil",
};
const FactoryModuleList = keys (map {$1: True}, FactoryMap.iterator());
// "map" is used above to ensure that the values only appear once in the final list
protected:
static hash<string, AbstractDataProviderFactory> factory_cache;
static hash<string, string> factory_module_map;
static Mutex factory_cache_lock();
static DataProviderTypeCache type_cache();
static hash<string, string> type_module_map;
static bool allow_env_config = False;
static bool env_config_locked = False;
static hash<string, bool> mod_map;
public:
static registerFactory(AbstractDataProviderFactory factory);
static *AbstractDataProviderFactory getFactory(string name);
static AbstractDataProviderFactory getFactoryEx(string name);
static AbstractDataProvider getFactoryObject(string path, *hash<auto> options);
static AbstractDataProvider getFactoryObjectFromString(string name);
static AbstractDataProvider getFactoryObjectFromStringUseEnv(string name);
protected:
static hash<FactoryInfo> getFactoryInfoFromString(string name);
public:
static *list<string> listFactories();
static DataProviderTypeCache getTypeCache();
static registerType(string path, AbstractDataProviderType type);
static *AbstractDataProviderType getType(string path);
static AbstractDataProviderType getTypeEx(string path);
static DataProviderTypeEntry getTypeRoot();
static lockAllTypes();
static *list<string> listTypes();
static registerKnownFactories();
static loadProvidersFromEnvironment();
static *AbstractDataProvider tryLoadProviderForConnectionFromEnv(string name);
static registerKnownTypes();
static loadTypesFromEnvironment();
static hash<auto> getInfoAsData(hash<auto> info0, *bool with_type_info);
static setAutoConfig();
static bool getAutoConfig();
static list<string> getPathList(string path);
protected:
static checkRequest();
public:
protected:
static *string tryGetFactoryModuleName(string name);
public:
protected:
static *string tryGetTypeModuleName(string name);
public:
protected:
static *string tryGetModuleName(string name, string func, string type);
public:
protected:
static *DataProviderTypeEntry tryLoadTypeFromPath(list<string> type_path);
public:
protected:
static bool tryLoad(string module_str, *bool verbose);
public:
protected:
static *object loadFromEnvironment(string func, string type, *hash<SymbolInfo> info);
public:
protected:
static *object checkSymbol(hash<SymbolInfo> info);
public:
protected:
static bool checkInjection(object obj, hash<string, string> module_map);
public:
};
// private hashdecls
hashdecl SymbolInfo {
// symbol type
string type;
# symbol name
string name;
}
hashdecl FactoryInfo {
// factory name
string name;
# path to final data provider in factory
list<string> path_list;
# factory options
auto options;
}
};
DataProvider::AbstractDataProviderFactory
Data provider factory class.
Definition: AbstractDataProviderFactory.qc.dox.h:58
DataProvider::AbstractDataProvider
The AbstractDataProvider class.
Definition: AbstractDataProvider.qc.dox.h:586
DataProvider::AbstractDataProviderType
describes a data type
Definition: AbstractDataProviderType.qc.dox.h:187
DataProvider::DataProvider::getPathList
static list< string > getPathList(string path)
Returns a list of strings in a path separated by "/" characters.
DataProvider::DataProvider::getType
static *AbstractDataProviderType getType(string path)
Returns the given data provider type or NOTHING if not present.
DataProvider::DataProvider::getTypeEx
static AbstractDataProviderType getTypeEx(string path)
Returns the given data provider type or throws an exception if not present.
DataProvider::DataProvider::registerKnownFactories
static registerKnownFactories()
Registers all known data provider factories.
DataProvider::DataProvider::tryLoadTypeFromPath
static *DataProviderTypeEntry tryLoadTypeFromPath(list< string > type_path)
Tries to load the given type.
DataProvider::DataProvider::setAutoConfig
static setAutoConfig()
Sets the flag that allows for automatic configuration from environment variables.
DataProvider::DataProvider::getFactoryObjectFromString
static AbstractDataProvider getFactoryObjectFromString(string name)
Returns a data provider object from the given factory string.
DataProvider::DataProvider::checkRequest
static checkRequest()
Sets the env_config_locked variable if not already set.
DataProvider::DataProvider::listFactories
static *list< string > listFactories()
Returns a list of registered data provider factories.
DataProvider::DataProvider::registerFactory
static registerFactory(AbstractDataProviderFactory factory)
Register a new data provider factory.
DataProvider::DataProvider::getFactory
static *AbstractDataProviderFactory getFactory(string name)
Returns the given data provider factory or NOTHING if not present.
DataProvider::DataProvider::getFactoryEx
static AbstractDataProviderFactory getFactoryEx(string name)
Returns the given data provider factory or throws an exception if not present.
DataProvider::DataProvider::factory_cache_lock
static Mutex factory_cache_lock()
data provider factory cache lock
DataProvider::DataProvider::loadProvidersFromEnvironment
static loadProvidersFromEnvironment()
Loads data providers from the environment.
DataProvider::DataProvider::getTypeCache
static DataProviderTypeCache getTypeCache()
Returns the data provider cache.
DataProvider::DataProvider::registerType
static registerType(string path, AbstractDataProviderType type)
Register a new data provider type.
DataProvider::DataProvider::getFactoryObjectFromStringUseEnv
static AbstractDataProvider getFactoryObjectFromStringUseEnv(string name)
Returns a data provider object from the given factory string using environment variables to find the ...
DataProvider::DataProvider::getFactoryInfoFromString
static hash< FactoryInfo > getFactoryInfoFromString(string name)
Returns a hash of factory information from a string.
DataProvider::DataProvider::tryGetModuleName
static *string tryGetModuleName(string name, string func, string type)
Tries to load a module corresponding to the given factory.
DataProvider::DataProvider::checkInjection
static bool checkInjection(object obj, hash< string, string > module_map)
Check if the object is from a module that has been subject to dependency injections.
DataProvider::DataProvider::type_module_map
static hash< string, string > type_module_map
data provider type module map
Definition: DataProvider.qc.dox.h:72
DataProvider::DataProvider::listTypes
static *list< string > listTypes()
Returns a list of registered data provider type paths.
DataProvider::DataProvider::getInfoAsData
static hash< auto > getInfoAsData(hash< auto > info0, *bool with_type_info)
Converts an info hash with objects to a hash with string descriptions instead of the objects.
DataProvider::DataProvider::loadTypesFromEnvironment
static loadTypesFromEnvironment()
Loads data types from the environment.
DataProvider::DataProvider::factory_cache
static hash< string, AbstractDataProviderFactory > factory_cache
data provider factory cache
Definition: DataProvider.qc.dox.h:60
DataProvider::DataProvider::checkSymbol
static *object checkSymbol(hash< SymbolInfo > info)
Returns True if an object of the given type has been loaded.
DataProvider::DataProvider::type_cache
static DataProviderTypeCache type_cache()
data provider data type cache
DataProvider::DataProvider::tryLoad
static bool tryLoad(string module_str, *bool verbose)
Try to load the given module.
DataProvider::DataProvider::getTypeRoot
static DataProviderTypeEntry getTypeRoot()
Returns the root type entry.
DataProvider::DataProvider::registerKnownTypes
static registerKnownTypes()
Registers all known data provider types.
DataProvider::DataProvider::lockAllTypes
static lockAllTypes()
Locks all types.
DataProvider::DataProvider::tryLoadProviderForConnectionFromEnv
static *AbstractDataProvider tryLoadProviderForConnectionFromEnv(string name)
Tries to load a data provider from the environment from the connection name.
DataProvider::DataProvider::mod_map
static hash< string, bool > mod_map
set of module already loaded
Definition: DataProvider.qc.dox.h:83
DataProvider::DataProvider::getFactoryObject
static AbstractDataProvider getFactoryObject(string path, *hash< auto > options)
Returns a data provider object from the given factory, created with the given constructor options.
DataProvider::DataProvider::tryGetTypeModuleName
static *string tryGetTypeModuleName(string name)
Tries to load a module corresponding to the given factory.
DataProvider::DataProvider::factory_module_map
static hash< string, string > factory_module_map
data provider factory module map
Definition: DataProvider.qc.dox.h:63
DataProvider::DataProvider::getAutoConfig
static bool getAutoConfig()
Returns the auto config flag.
DataProvider::DataProvider::loadFromEnvironment
static *object loadFromEnvironment(string func, string type, *hash< SymbolInfo > info)
Loads modules from the QORE_DATA_PROVIDERS environment variable.
DataProvider::DataProvider::tryGetFactoryModuleName
static *string tryGetFactoryModuleName(string name)
Tries to load a module corresponding to the given factory.
DataProvider::DataProviderTypeCache
Data provider type cache class.
Definition: DataProviderTypeCache.qc.dox.h:29
DataProvider::DataProviderTypeEntry
the DataProviderTypeEntry class
Definition: DataProviderTypeEntry.qc.dox.h:58
True
const True
False
const False
type
string type(auto arg)
DataProvider
Qore AbstractDataField class definition.
Definition: AbstractDataField.qc.dox.h:27