Loading...
Searching...
No Matches
AbstractDataProviderType.qc.dox.h
// -*- mode: c++; indent-tabs-mode: nil -*-
namespace DataProvider {
const TypeCodeMap = ...;
const OptimalQoreDataTypeMap = ...;
const OptimalQoreSoftDataTypeMap = ...;
const DataTypeMap = ...;
const AbstractDataProviderTypeMap = ...;
public struct DataProviderTypeOptionInfo {
string type;
string desc;
bool publish;
};
public struct DataTypeInfo {
string name;
string display_name;
string short_desc;
string desc;
*string path;
*hash<string, hash<DataProviderTypeOptionInfo>> supported_options;
*hash<auto> options;
string base_type;
bool mandatory;
list<string> types_accepted;
list<string> types_returned;
*hash<string, hash<DataFieldInfo>> fields;
*hash<DataTypeInfo> element_type;
auto default_value;
bool can_manage_fields = False;
*hash<DataTypeInfo> default_field_type_info;
string unique_key;
bool recursive;
*hash<auto> tags;
};
const DTT_FromFile = "from_file";
const DTT_FromLocation = "from_location";
const DTT_ClientOnly = "client_only";
class AbstractDataProviderType : public Qore::Serializable {
public:
static Type nothingType = Reflection::NothingType;
static Type anyType = Reflection::AutoType;
// not initialized here to workaround issue #4048 (circular initializtion error)
static AbstractDataProviderType anyDataType;
const DefaultDesc = "no description available";
protected:
hash<auto> options;
*hash<auto> tags;
*string path;
public:
constructor();
constructor(string path);
constructor(hash<auto> options, *hash<auto> tags, *string path);
constructor(*hash<auto> options, hash<auto> tags, *string path);
string getDesc();
*string getPath();
setPath(string path);
clearPath();
*hash<string, hash<DataProviderTypeOptionInfo>> getSupportedOptions();
hash<DataTypeInfo> getInputInfo(*bool simple);
hash<DataTypeInfo> getInfo(*bool simple);
*hash<string, hash<DataFieldInfo>> getFieldInfo();
bool isAssignableFrom(AbstractDataProviderType t);
bool isAssignableFrom(Type t);
bool hasDefaultValue();
auto getDefaultValue();
bool isList();
bool isMandatory();
*AbstractDataField getField(string field_name);
bool hasType();
string getBaseTypeName();
int getBaseTypeCode();
*hash<string, bool> getDirectTypeHash();
bool isOrNothingType();
*AbstractDataProviderType getFieldType(string field_name);
auto getOptionValue(string opt);
*hash<auto> getOptions();
*hash<auto> getPublicOptions();
setOption(string opt, auto value);
setOptions(hash<auto> options);
auto getTag(string tag);
*hash<auto> getTags();
setDynamicTag();
AbstractDataProviderType getSoftType();
AbstractDataProviderType getOrNothingType();
AbstractDataProviderType getMandatoryType();
auto getExampleValue(*hash<string, bool> emap, *string fname);
string getDisplayName();
string getShortDescription();
abstract string getName();
abstract *Type getValueType();
abstract *AbstractDataProviderType getElementType();
abstract *hash<string, AbstractDataField> getFields();
abstract hash<string, bool> getAcceptTypeHash(*bool simple);
abstract hash<string, bool> getReturnTypeHash(*bool simple);
abstract auto acceptsValue(auto value);
static AbstractDataProviderType get(Type type, *hash<auto> options, *hash<auto> tags, auto default_value, *hash<NameDescInfo> attr);
static AbstractDataProviderType get(string typename, *hash<auto> options);
static AbstractDataProviderType get(hash<DataTypeInfo> info);
protected:
setOptionIntern(string opt, auto value);
public:
};
};
namespace Priv {
thread_local hash<string, bool> rimap;
};
DataProvider::AbstractDataField
describes a data type based on a hashdecl
Definition AbstractDataField.qc.dox.h:74
DataProvider::AbstractDataProviderType
describes a data type
Definition AbstractDataProviderType.qc.dox.h:139
DataProvider::AbstractDataProviderType::getReturnTypeHash
abstract hash< string, bool > getReturnTypeHash(*bool simple)
Returns a hash of types returned by this type; keys are type names.
DataProvider::AbstractDataProviderType::hasType
bool hasType()
Returns True if the type is not a wildcard type.
DataProvider::AbstractDataProviderType::setDynamicTag
setDynamicTag()
Sets the dynamic tag on the type.
DataProvider::AbstractDataProviderType::getBaseTypeCode
int getBaseTypeCode()
Returns the base type code for the type.
DataProvider::AbstractDataProviderType::get
static AbstractDataProviderType get(Type type, *hash< auto > options, *hash< auto > tags, auto default_value, *hash< NameDescInfo > attr)
Returns an appropriate object for the given type.
DataProvider::AbstractDataProviderType::tags
*hash< auto > tags
type tags
Definition AbstractDataProviderType.qc.dox.h:155
DataProvider::AbstractDataProviderType::getSupportedOptions
*hash< string, hash< DataProviderTypeOptionInfo > > getSupportedOptions()
Returns supported options.
DataProvider::AbstractDataProviderType::isAssignableFrom
bool isAssignableFrom(AbstractDataProviderType t)
Returns True if this type can be assigned from values of the argument type.
DataProvider::AbstractDataProviderType::getFieldType
*AbstractDataProviderType getFieldType(string field_name)
get the given field type if it exists, otherwise return nothing
DataProvider::AbstractDataProviderType::options
hash< auto > options
type options
Definition AbstractDataProviderType.qc.dox.h:152
DataProvider::AbstractDataProviderType::getInputInfo
hash< DataTypeInfo > getInputInfo(*bool simple)
Returns a description of the type as an input type.
DataProvider::AbstractDataProviderType::getDirectTypeHash
*hash< string, bool > getDirectTypeHash()
Returns a hash of native base type code keys where no translations are performed; keys are type codes...
DataProvider::AbstractDataProviderType::clearPath
clearPath()
Clears the type path for the type.
DataProvider::AbstractDataProviderType::get
static AbstractDataProviderType get(hash< DataTypeInfo > info)
Returns an appropriate object for the given type description.
DataProvider::AbstractDataProviderType::hasDefaultValue
bool hasDefaultValue()
! Returns True if this type has a default value
DataProvider::AbstractDataProviderType::isAssignableFrom
bool isAssignableFrom(Type t)
Returns True if this type can be assigned from values of the argument type.
DataProvider::AbstractDataProviderType::getElementType
abstract *AbstractDataProviderType getElementType()
Returns the subtype (for lists or hashes) if there is only one.
DataProvider::AbstractDataProviderType::getPath
*string getPath()
Returns the type path in the type cache, if any.
DataProvider::AbstractDataProviderType::isMandatory
bool isMandatory()
Returns True if the type must have a value.
DataProvider::AbstractDataProviderType::getFields
abstract *hash< string, AbstractDataField > getFields()
Returns the fields of the data structure; if any.
DataProvider::AbstractDataProviderType::isList
bool isList()
Returns True if this type is a list.
DataProvider::AbstractDataProviderType::getBaseTypeName
string getBaseTypeName()
Returns the base type name for the type; must be a standard Qore base type name.
DataProvider::AbstractDataProviderType::isOrNothingType
bool isOrNothingType()
Returns True if the type also accepts nothing.
DataProvider::AbstractDataProviderType::getTags
*hash< auto > getTags()
Returns tags set on the type.
DataProvider::AbstractDataProviderType::getPublicOptions
*hash< auto > getPublicOptions()
Returns options with the publish flag set on the type.
DataProvider::AbstractDataProviderType::DefaultDesc
const DefaultDesc
Default description.
Definition AbstractDataProviderType.qc.dox.h:148
DataProvider::AbstractDataProviderType::getDisplayName
string getDisplayName()
Returns the type's display name.
DataProvider::AbstractDataProviderType::getAcceptTypeHash
abstract hash< string, bool > getAcceptTypeHash(*bool simple)
Returns a hash of types accepted by this type; keys are type names.
DataProvider::AbstractDataProviderType::acceptsValue
abstract auto acceptsValue(auto value)
Returns the value if the value can be assigned to the type.
DataProvider::AbstractDataProviderType::get
static AbstractDataProviderType get(string typename, *hash< auto > options)
Returns an appropriate object for the given type.
DataProvider::AbstractDataProviderType::getOrNothingType
AbstractDataProviderType getOrNothingType()
Returns an "or nothing" type equivalent to the current type.
DataProvider::AbstractDataProviderType::getName
abstract string getName()
Returns the type name.
DataProvider::AbstractDataProviderType::getShortDescription
string getShortDescription()
Returns the type's short description.
DataProvider::AbstractDataProviderType::setOptionIntern
setOptionIntern(string opt, auto value)
sets the given option without any validation of the option
DataProvider::AbstractDataProviderType::setOptions
setOptions(hash< auto > options)
sets options on the type
DataProvider::AbstractDataProviderType::path
*string path
The type path, if any.
Definition AbstractDataProviderType.qc.dox.h:158
DataProvider::AbstractDataProviderType::getValueType
abstract *Type getValueType()
Returns the base type for the type, if any.
DataProvider::AbstractDataProviderType::constructor
constructor(string path)
creates the type
DataProvider::AbstractDataProviderType::getExampleValue
auto getExampleValue(*hash< string, bool > emap, *string fname)
Returns any example value for type, if any.
DataProvider::AbstractDataProviderType::getFieldInfo
*hash< string, hash< DataFieldInfo > > getFieldInfo()
Returns information on fields supported.
DataProvider::AbstractDataProviderType::getField
*AbstractDataField getField(string field_name)
Returns the given field, if present, or nothing if not.
DataProvider::AbstractDataProviderType::constructor
constructor(*hash< auto > options, hash< auto > tags, *string path)
creates the type and sets options
DataProvider::AbstractDataProviderType::getOptions
*hash< auto > getOptions()
Returns options set on the type.
DataProvider::AbstractDataProviderType::setPath
setPath(string path)
Sets the type path for the type.
DataProvider::AbstractDataProviderType::getDefaultValue
auto getDefaultValue()
DataProvider::AbstractDataProviderType::constructor
constructor()
creates the type
DataProvider::AbstractDataProviderType::getSoftType
AbstractDataProviderType getSoftType()
Returns a "soft" type equivalent to the current type.
DataProvider::AbstractDataProviderType::setOption
setOption(string opt, auto value)
sets the given option on the type
DataProvider::AbstractDataProviderType::getMandatoryType
AbstractDataProviderType getMandatoryType()
Returns a mandatory (i.e. not "or nothing") type equivalent to the current type.
DataProvider::AbstractDataProviderType::getOptionValue
auto getOptionValue(string opt)
Returns the value of the given option.
DataProvider::AbstractDataProviderType::getInfo
hash< DataTypeInfo > getInfo(*bool simple)
Returns a description of the type as a hash.
DataProvider::AbstractDataProviderType::getTag
auto getTag(string tag)
Returns the value of the given tag.
DataProvider::AbstractDataProviderType::constructor
constructor(hash< auto > options, *hash< auto > tags, *string path)
creates the type and sets options
DataProvider::AbstractDataProviderType::getDesc
string getDesc()
Returns the description.
DataProvider::DTT_FromLocation
const DTT_FromLocation
Tag indicates that a string value can indicate a location.
Definition AbstractDataProviderType.qc.dox.h:132
DataProvider::DTT_FromFile
const DTT_FromFile
Definition AbstractDataProviderType.qc.dox.h:129
DataProvider::DTT_ClientOnly
const DTT_ClientOnly
Tag indicates that the value is only applicable in client contexts.
Definition AbstractDataProviderType.qc.dox.h:135
DataProvider
Qore AbstractDataField class definition.
Definition AbstractDataField.qc.dox.h:27
DataProvider::DataTypeMap
const DataTypeMap
Maps Qore type name constant values to data type objects.
Definition AbstractDataProviderType.qc.dox.h:45
DataProvider::OptimalQoreDataTypeMap
const OptimalQoreDataTypeMap
maps Qore type name constant values from the Type namespace to optimal Qore types names
Definition AbstractDataProviderType.qc.dox.h:35
DataProvider::TypeCodeMap
const TypeCodeMap
maps type codes to type names
Definition AbstractDataProviderType.qc.dox.h:29
DataProvider::AbstractDataProviderTypeMap
const AbstractDataProviderTypeMap
Maps Qore type name constant values to AbstractDataProviderType values.
Definition AbstractDataProviderType.qc.dox.h:49
DataProvider::OptimalQoreSoftDataTypeMap
const OptimalQoreSoftDataTypeMap
maps Qore type name constant values from the Type namespace to optimal Qore types names
Definition AbstractDataProviderType.qc.dox.h:41
Priv
Private definitions.
Definition AbstractDataProviderType.qc.dox.h:454
Priv::rimap
thread_local hash< string, bool > rimap
Recursive info map: unique key -> True.
Definition AbstractDataProviderType.qc.dox.h:456
DataProvider::DataProviderTypeOptionInfo
describes type options
Definition AbstractDataProviderType.qc.dox.h:53
DataProvider::DataProviderTypeOptionInfo::publish
bool publish
Flag to publish the option as a `type_option`.
Definition AbstractDataProviderType.qc.dox.h:61
DataProvider::DataProviderTypeOptionInfo::desc
string desc
the description of the option
Definition AbstractDataProviderType.qc.dox.h:58
DataProvider::DataProviderTypeOptionInfo::type
string type
the option value type
Definition AbstractDataProviderType.qc.dox.h:55
DataProvider::DataTypeInfo
describes a data type
Definition AbstractDataProviderType.qc.dox.h:65
DataProvider::DataTypeInfo::options
*hash< auto > options
Output: current transformation option values.
Definition AbstractDataProviderType.qc.dox.h:85
DataProvider::DataTypeInfo::tags
*hash< auto > tags
Any tags set on the type.
Definition AbstractDataProviderType.qc.dox.h:121
DataProvider::DataTypeInfo::short_desc
string short_desc
A short description for the type, plain text formatting.
Definition AbstractDataProviderType.qc.dox.h:73
DataProvider::DataTypeInfo::default_field_type_info
*hash< DataTypeInfo > default_field_type_info
Default type for fields not listed in fields.
Definition AbstractDataProviderType.qc.dox.h:112
DataProvider::DataTypeInfo::path
*string path
The type path in the type cache, if known.
Definition AbstractDataProviderType.qc.dox.h:79
DataProvider::DataTypeInfo::recursive
bool recursive
Recursive flag.
Definition AbstractDataProviderType.qc.dox.h:118
DataProvider::DataTypeInfo::supported_options
*hash< string, hash< DataProviderTypeOptionInfo > > supported_options
Output: transformation options supported by the type.
Definition AbstractDataProviderType.qc.dox.h:82
DataProvider::DataTypeInfo::can_manage_fields
bool can_manage_fields
If fields can be added dynamically to the type and if the type will accept any field at runtime.
Definition AbstractDataProviderType.qc.dox.h:109
DataProvider::DataTypeInfo::fields
*hash< string, hash< DataFieldInfo > > fields
Any fields supported by the type; will be NOTHING when recursive is True.
Definition AbstractDataProviderType.qc.dox.h:100
DataProvider::DataTypeInfo::mandatory
bool mandatory
Output: can be null / missing?
Definition AbstractDataProviderType.qc.dox.h:91
DataProvider::DataTypeInfo::element_type
*hash< DataTypeInfo > element_type
A type description of any element type.
Definition AbstractDataProviderType.qc.dox.h:103
DataProvider::DataTypeInfo::types_returned
list< string > types_returned
Input: list of types returned.
Definition AbstractDataProviderType.qc.dox.h:97
DataProvider::DataTypeInfo::display_name
string display_name
The display name for the type.
Definition AbstractDataProviderType.qc.dox.h:70
DataProvider::DataTypeInfo::unique_key
string unique_key
Unique type identifier.
Definition AbstractDataProviderType.qc.dox.h:115
DataProvider::DataTypeInfo::desc
string desc
The description of the type.
Definition AbstractDataProviderType.qc.dox.h:76
DataProvider::DataTypeInfo::base_type
string base_type
Output: base type.
Definition AbstractDataProviderType.qc.dox.h:88
DataProvider::DataTypeInfo::types_accepted
list< string > types_accepted
Output: list of types accepted.
Definition AbstractDataProviderType.qc.dox.h:94
DataProvider::DataTypeInfo::default_value
auto default_value
The default value for the type.
Definition AbstractDataProviderType.qc.dox.h:106
DataProvider::DataTypeInfo::name
string name
The name of the type.
Definition AbstractDataProviderType.qc.dox.h:67