Qore DataProvider Module Reference  1.2.2
DataProvider.qc.dox.h
1 // -*- mode: c++; indent-tabs-mode: nil -*-
3 
27 namespace DataProvider {
29 class DataProvider {
30 
31 public:
33  const FactoryMap = ...;
34 
35 
37  const TypeMap = ...;
38 
39 
41  const FactoryModuleList = keys (map {$1: True}, FactoryMap.iterator());
42  // "map" is used above to ensure that the values only appear once in the final list
43 
44 protected:
46  static hash<string, AbstractDataProviderFactory> factory_cache;
47 
49  static hash<string, string> factory_module_map;
50 
52  static Mutex factory_cache_lock();
53 
56 
58  static hash<string, string> type_module_map;
59 
61 
63  static bool allow_env_config = False;
64 
66  static bool env_config_locked = False;
67 
69  static hash<string, bool> mod_map;
70 
71 public:
72 
74 
79 
82 
84 
91 
93 
98  static AbstractDataProvider getFactoryObject(string path, *hash<auto> options);
99 
101 
111 
113 
123 
125 protected:
126  static hash<FactoryInfo> getFactoryInfoFromString(string name);
127 public:
128 
129 
131  static *list<string> listFactories();
132 
135 
137 
146 
148 
155  static *AbstractDataProviderType getType(string path);
156 
158 
167  static AbstractDataProviderType getTypeEx(string path);
168 
171 
173  static lockAllTypes();
174 
176 
180  static *list<string> listTypes();
181 
184 
187 
190 
193 
196 
198  static hash<auto> getInfoAsData(hash<auto> info0);
199 
201 
205  static setAutoConfig();
206 
208  static bool getAutoConfig();
209 
211  static list<string> getPathList(string path);
212 
214 protected:
215  static checkRequest();
216 public:
217 
218 
220 protected:
221  static *string tryGetFactoryModuleName(string name);
222 public:
223 
224 
226 protected:
227  static *string tryGetTypeModuleName(string name);
228 public:
229 
230 
232 protected:
233  static *string tryGetModuleName(string name, string func, string type);
234 public:
235 
236 
238 protected:
239  static *DataProviderTypeEntry tryLoadTypeFromPath(list<string> type_path);
240 public:
241 
242 
244 protected:
245  static bool tryLoad(string module_str, *bool verbose);
246 public:
247 
248 
250 protected:
251  static *object loadFromEnvironment(string func, string type, *hash<SymbolInfo> info);
252 public:
253 
254 
256 protected:
257  static *object checkSymbol(hash<SymbolInfo> info);
258 public:
259 
260 
262 protected:
263  static bool checkInjection(object obj, hash<string, string> module_map);
264 public:
265 
266 };
267 
268 // private hashdecls
269 hashdecl SymbolInfo {
270  // symbol type
271  string type;
272  // symbol name
273  string name;
274 }
275 hashdecl FactoryInfo {
276  // factory name
277  string name;
278  // path to final data provider in factory
279  list<string> path_list;
280  // factory options
281  auto options;
282 }
283 }
Data provider factory class.
Definition: AbstractDataProviderFactory.qc.dox.h:28
The AbstractDataProvider class.
Definition: AbstractDataProvider.qc.dox.h:189
describes a data type
Definition: AbstractDataProviderType.qc.dox.h:88
static list< string > getPathList(string path)
Returns a list of strings in a path separated by "/" characters.
static *AbstractDataProviderType getType(string path)
Returns the given data provider type or NOTHING if not present.
static AbstractDataProviderType getTypeEx(string path)
Returns the given data provider type or throws an exception if not present.
static registerKnownFactories()
Registers all known data provider factories.
static *DataProviderTypeEntry tryLoadTypeFromPath(list< string > type_path)
Tries to load the given type.
static setAutoConfig()
Sets the flag that allows for automatic configuration from environment variables.
static AbstractDataProvider getFactoryObjectFromString(string name)
Returns a data provider object from the given factory string.
static checkRequest()
Sets the env_config_locked variable if not already set.
static *list< string > listFactories()
Returns a list of registered data provider factories.
static registerFactory(AbstractDataProviderFactory factory)
Register a new data provider factory.
static *AbstractDataProviderFactory getFactory(string name)
Returns the given data provider factory or NOTHING if not present.
static AbstractDataProviderFactory getFactoryEx(string name)
Returns the given data provider factory or throws an exception if not present.
static Mutex factory_cache_lock()
data provider factory cache lock
static loadProvidersFromEnvironment()
Loads data providers from the environment.
static DataProviderTypeCache getTypeCache()
Returns the data provider cache.
static registerType(string path, AbstractDataProviderType type)
Register a new data provider type.
static AbstractDataProvider getFactoryObjectFromStringUseEnv(string name)
Returns a data provider object from the given factory string using environment variables to find the ...
static hash< FactoryInfo > getFactoryInfoFromString(string name)
Returns a hash of factory information from a string.
static *string tryGetModuleName(string name, string func, string type)
Tries to load a module corresponding to the given factory.
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.
static hash< string, string > type_module_map
data provider type module map
Definition: DataProvider.qc.dox.h:58
static *list< string > listTypes()
Returns a list of registered data provider type paths.
static loadTypesFromEnvironment()
Loads data types from the environment.
static hash< string, AbstractDataProviderFactory > factory_cache
data provider factory cache
Definition: DataProvider.qc.dox.h:46
static *object checkSymbol(hash< SymbolInfo > info)
Returns True if an object of the given type has been loaded.
static DataProviderTypeCache type_cache()
data provider data type cache
static bool tryLoad(string module_str, *bool verbose)
Try to load the given module.
static DataProviderTypeEntry getTypeRoot()
Returns the root type entry.
static registerKnownTypes()
Registers all known data provider types.
static lockAllTypes()
Locks all types.
static *AbstractDataProvider tryLoadProviderForConnectionFromEnv(string name)
Tries to load a data provider from the environment from the connection name.
static hash< string, bool > mod_map
set of module already loaded
Definition: DataProvider.qc.dox.h:69
static AbstractDataProvider getFactoryObject(string path, *hash< auto > options)
Returns a data provider object from the given factory, created with the given constructor options.
static hash< auto > getInfoAsData(hash< auto > info0)
Converts an info hash with objects to a hash with string descriptions instead of the objects.
static *string tryGetTypeModuleName(string name)
Tries to load a module corresponding to the given factory.
static hash< string, string > factory_module_map
data provider factory module map
Definition: DataProvider.qc.dox.h:49
static bool getAutoConfig()
Returns the auto config flag.
static *object loadFromEnvironment(string func, string type, *hash< SymbolInfo > info)
Loads modules from the QORE_DATA_PROVIDERS environment variable.
static *string tryGetFactoryModuleName(string name)
Tries to load a module corresponding to the given factory.
Data provider type cache class.
Definition: DataProviderTypeCache.qc.dox.h:29
the DataProviderTypeEntry class
Definition: DataProviderTypeEntry.qc.dox.h:55
const True
const False
string type(auto arg)
Qore AbstractDataField class definition.
Definition: AbstractDataField.qc.dox.h:27