Loading...
Searching...
No Matches
DataProvider::DataProvider Class Reference

Data provider class. More...

`#include <DataProvider.qc.dox.h>`

## Static Public Member Functions

static bool | getAutoConfig ()
| Returns the auto config flag.
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. More...
static AbstractDataProvider | getFactoryObject (string path, *hash< auto > options)
| Returns a data provider object from the given factory, created with the given constructor options. More...
static AbstractDataProvider | getFactoryObjectFromExample (string path, data example, *hash< auto > options)
| Returns a data provider object from the given factory, created with the given options and example data. More...
static AbstractDataProvider | getFactoryObjectFromExample (string path, InputStream example, *hash< auto > options)
| Returns a data provider object from the given factory, created with the given options and example data. More...
static AbstractDataProvider | getFactoryObjectFromString (string name)
| Returns a data provider object from the given factory string. More...
static AbstractDataProvider | getFactoryObjectFromStringUseEnv (string name)
| Returns a data provider object from the given factory string using environment variables to find the factory. More...
static AbstractDataProvider | getFactoryObjectWithTemplate (string path, *hash< auto > template_options, *hash< auto > options)
| Returns a data provider object from the given factory, created with the given constructor options. More...
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. More...
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. More...
static DataProviderTypeCache | getTypeCache ()
| Returns the data provider cache.
static AbstractDataProviderType | getTypeEx (string path)
| Returns the given data provider type or throws an exception if not present. More...
static DataProviderTypeEntry | getTypeRoot ()
| Returns the root type entry.
static *list< string > | listFactories ()
| Returns a list of registered data provider factories.
static *list< string > | listTypes ()
| Returns a list of registered data provider type paths. More...
static | loadProvidersFromEnvironment ()
| Loads data providers from the environment.
static | loadTypesFromEnvironment ()
| Loads data types from the environment.
static | lockAllTypes ()
| Locks all types.
static | registerFactory (AbstractDataProviderFactory factory)
| Register a new data provider factory. More...
static | registerKnownFactories ()
| Registers all known data provider factories.
static | registerKnownTypes ()
| Registers all known data provider types.
static | registerType (string path, AbstractDataProviderType type)
| Register a new data provider type. More...
static | setAutoConfig ()
| Sets the flag that allows for automatic configuration from environment variables. More...
static *AbstractDataProvider | tryLoadProviderForConnectionFromEnv (string name)
| Tries to load a data provider from the environment from the connection name.

## Public Attributes

const | FactoryMap
| Map of known data provider factory names to modules.
const | FactoryModuleList = keys (map {$1: True}, FactoryMap.iterator())
| List of data provider factory modules.
const | TypeMap
| Map of known type path prefixes to modules.

## Static Protected Member Functions

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 | checkRequest ()
| Sets the env_config_locked variable if not already set.
static *object | checkSymbol (hash< SymbolInfo > info)
| Returns True if an object of the given type has been loaded.
static Mutex | factory_cache_lock ()
| data provider factory cache lock
static hash< FactoryInfo > | getFactoryInfoFromString (string name)
| Returns a hash of factory information from a string.
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.
static *string | tryGetModuleName (string name, string func, string type)
| Tries to load a module corresponding to the given factory.
static *string | tryGetTypeModuleName (string name)
| Tries to load a module corresponding to the given factory.
static bool | tryLoad (string module_str, *bool verbose)
| Try to load the given module.
static *DataProviderTypeEntry | tryLoadTypeFromPath (list< string > type_path)
| Tries to load the given type.
static DataProviderTypeCache | type_cache ()
| data provider data type cache

## Static Protected Attributes

static bool | allow_env_config = False
| flag to allow automatic configuration from environment variables More...
static bool | env_config_locked = False
| flag that locks the allow_env_config var
static hash< string, AbstractDataProviderFactory > | factory_cache
| data provider factory cache
static hash< string, string > | factory_module_map
| data provider factory module map
static hash< string, bool > | mod_map
| set of module already loaded
static hash< string, string > | type_module_map
| data provider type module map

## Detailed Description

Data provider class.

## Member Function Documentation

## getFactoryEx()

static AbstractDataProviderFactory DataProvider::DataProvider::getFactoryEx | ( | string | name | ) |

static

Returns the given data provider factory or throws an exception if not present.

Parameters

  name | the name of the data provider to retrieve

Returns
  the given data provider; an exception is thrown if the data provide is unknown

Exceptions

  PROVIDER-ERROR | the given provider is unknown

## getFactoryObject()

static AbstractDataProvider DataProvider::DataProvider::getFactoryObject | ( | string | path,
|  | *hash< auto > | options
| ) |  |

static

Returns a data provider object from the given factory, created with the given constructor options.

Parameters

  path | the `"/"-separated` path to the target data provider; the first element is the factory name
  options | factory creation options

Exceptions

  PROVIDER-ERROR | the given provider factory or child provider is unknown

## getFactoryObjectFromExample() [1/2]

static AbstractDataProvider DataProvider::DataProvider::getFactoryObjectFromExample | ( | string | path,
|  | data | example,
|  | *hash< auto > | options
| ) |  |

static

Returns a data provider object from the given factory, created with the given options and example data.

Parameters

  path | the `"/"-separated` path to the target data provider; the first element is the factory name
  example | example data to process
  options | factory creation options

Exceptions

  PROVIDER-ERROR | the given provider factory or child provider is unknown

Since
  DataProvider 2.7.1

## getFactoryObjectFromExample() [2/2]

static AbstractDataProvider DataProvider::DataProvider::getFactoryObjectFromExample | ( | string | path,
|  | InputStream | example,
|  | *hash< auto > | options
| ) |  |

static

Returns a data provider object from the given factory, created with the given options and example data.

Parameters

  path | the `"/"-separated` path to the target data provider; the first element is the factory name
  example | example data to process
  options | factory creation options

Exceptions

  PROVIDER-ERROR | the given provider factory or child provider is unknown

Since
  DataProvider 2.7.1

## getFactoryObjectFromString()

static AbstractDataProvider DataProvider::DataProvider::getFactoryObjectFromString | ( | string | name | ) |

static

Returns a data provider object from the given factory string.

Factory options are given as string-formatted hash in curly brackets and child data providers are separated by forward slashes

Example:
  DbDataProvider db = DataProvider::getFactoryObjectFromString("db{oracle:user/password@db}/my_table");

Exceptions

  PROVIDER-ERROR | the given provider factory or child provider is unknown

## getFactoryObjectFromStringUseEnv()

static AbstractDataProvider DataProvider::DataProvider::getFactoryObjectFromStringUseEnv | ( | string | name | ) |

static

Returns a data provider object from the given factory string using environment variables to find the factory.

Factory options are given as string-formatted hash in curly brackets and child data providers are separated by forward slashes

Example:
  DbDataProvider db = DataProvider::getFactoryObjectFromStringUseEnv("db{oracle:user/password@db}/my_table");

Exceptions

  PROVIDER-ERROR | the given provider factory or child provider is unknown

## getFactoryObjectWithTemplate()

static AbstractDataProvider DataProvider::DataProvider::getFactoryObjectWithTemplate | ( | string | path,
|  | *hash< auto > | template_options,
|  | *hash< auto > | options
| ) |  |

inline static

Returns a data provider object from the given factory, created with the given constructor options.

Parameters

  path | the `"/"-separated` path to the target data provider; the first element is the factory name
  template_options | options with templated values; only the keys in this hash are relevant, as they indicate options that will be present at a later time when their values can be derived; the values provided in this call are assumed to be in an implementation-dependent templated format and should be ignored
  options | factory creation options

Exceptions

  PROVIDER-ERROR | the given provider factory or child provider is unknown

Since
  DataProvider 2.7.1

## getInfoAsData()

static hash< auto > DataProvider::DataProvider::getInfoAsData | ( | hash< auto > | info0,
|  | *bool | with_type_info
| ) |  |

static

Converts an info hash with objects to a hash with string descriptions instead of the objects.

Parameters

  info0 | the raw info with objects describing the types
  with_type_info | if True then more type information will be returned in the response

## getType()

static *AbstractDataProviderType DataProvider::DataProvider::getType | ( | string | path | ) |

static

Returns the given data provider type or NOTHING if not present.

Parameters

  path | a `"/"` separated path for the type; trailing path elements can be a path into fields

Returns
  the given data provider type; NOTHING is returned if the type cannot be resolved

Note
  types are stored based on the path provided which may differ from their type names (which may be generic and therefore not suitable for indexing)

## getTypeEx()

static AbstractDataProviderType DataProvider::DataProvider::getTypeEx | ( | string | path | ) |

static

Returns the given data provider type or throws an exception if not present.

Parameters

  path | a `"/"` separated path for the type; trailing path elements can be a path into fields

Returns
  the given data provider type; an exception is thrown if the data provide is unknown

Exceptions

  PROVIDER-ERROR | the given data provider type path is unknown

Note
  types are stored based on the path provided which may differ from their type names (which may be generic and therefore not suitable for indexing)

## listTypes()

static *list< string > DataProvider::DataProvider::listTypes | ( |  | ) |

static

Returns a list of registered data provider type paths.

Note
  types are stored based on the path provided which may differ from their type names (which may be generic and therefore not suitable for indexing)

## registerFactory()

static DataProvider::DataProvider::registerFactory | ( | AbstractDataProviderFactory | factory | ) |

static

Register a new data provider factory.

Parameters

  factory | the new data provider factory

Exceptions

  PROVIDER-ERROR | the given provider has already been registered

## registerType()

static DataProvider::DataProvider::registerType | ( | string | path,
|  | AbstractDataProviderType | type
| ) |  |

static

Register a new data provider type.

Parameters

  path | a `"/"` separated path for the type; this is the lookup index
  type | the new data provider type

Exceptions

  PROVIDER-ERROR | the given provider has already been registered

Note
  types are stored based on the path provided which may differ from their type names (which may be generic and therefore not suitable for indexing)

## setAutoConfig()

static DataProvider::DataProvider::setAutoConfig | ( |  | ) |

static

Sets the flag that allows for automatic configuration from environment variables.

Must be called before any requests for types or factories are made, or an exception is raised

Exceptions

  DATA-PROVIDER-ERROR | cannot call this method after requests for types or factories are made

## Member Data Documentation

## allow_env_config

bool DataProvider::DataProvider::allow_env_config = False

static protected

flag to allow automatic configuration from environment variables

must be set before any requests for types or factories are made