A partial implementation of SessionImpl, providing features and properties management.

To implement a certain feature or property, a subclass must provide setter and getter methods and register them with addFeature() or addProperty().

The getter method for a property.

The getter method for a feature.

The setter method for a feature.

The setter method for a property.

Creates the AbstractSessionImpl.

Adds "storage" property and sets the default internal storage container type to std::deque. The storage is created by statements automatically whenever a query returning results is executed but external storage is provided by the user. Storage type can be reconfigured at runtime both globally (for the duration of the session) and locally (for a single statement execution only). See StatementImpl for details on how this property is used at runtime.

Adds "handle" property which, if set by the back end, returns native handle for the back end DB.

Adds "bulk" feature and sets it to false. Bulk feature determines whether the session is capable of bulk operations. Connectors that are capable of it must set this feature prior to attempting bulk operations.

Adds "emptyStringIsNull" feature and sets it to false. This feature should be set to true in order to modify the behavior of the databases that distinguish between zero-length character strings as nulls. Setting this feature to true shall disregard any difference between empty character strings and nulls, causing the framework to treat them the same (i.e. behave like Oracle).

Adds "forceEmptyString" feature and sets it to false. This feature should be set to true in order to force the databases that do not distinguish empty strings from nulls (e.g. Oracle) to always report empty string.

The "emptyStringIsNull" and "forceEmptyString" features are mutually exclusive. While these features can not both be true at the same time, they can both be false, resulting in default underlying database behavior.

Adds "sqlParse" feature and sets it to false; this property enables parsing of the SQL queries, to help the Data framework to determine whether to start a transaction automatically in non-autocomit mode (ie. not to start transaction if all the queries in an SQL statement are SELECTs). Note that the property is not a bullet-proof way to ensure this behavior, because not all SQL dialects are supported by the parser. When enabled, the parsing has performance cost, but it is otherwise non-intrusive, ie. on parse failure Statement only internally records parsing errors, but does not throw. See Poco::Data::Statement documentation for more information. This property has no effect when Poco::Data library is compiled with POCO_DATA_NO_SQL_PARSER.

Adds "autoCommit" feature and sets it to true. This property enables automatic commit. Setting this feature to true renders the sqlParse property meaningless, because every query is automatically commited.

Destroys the AbstractSessionImpl.

Returns the execution type

Returns the setting for the behavior regarding empty variable length strings. See setEmptyStringIsNull(const std::string&, bool) and this class documentation for feature rationale and details.

Looks a feature up in the features map and calls the feature's getter, if there is one.

See also: Poco::Data::SessionImpl::getFeature()

Returns the setting for the behavior regarding empty variable length strings. See setForceEmptyString(const std::string&, bool) and this class documentation for feature rationale and details.

Returns the native session handle.

Looks a property up in the properties map and calls the property's getter, if there is one.

See also: Poco::Data::SessionImpl::getProperty()

Returns the value of the SQL parsing flag.

Returns the storage type

Looks a feature up in the features map and returns true if there is one.

See also: Poco::Data::SessionImpl::hasFeature()

Looks a property up in the properties map and returns true if there is one.

See also: Poco::Data::SessionImpl::hasProperty()

Sets the execution type.

Sets the behavior regarding empty variable length strings. Those are treated as NULL by Oracle and as empty string by most other databases. When this feature is true, empty strings are treated as NULL.

Looks a feature up in the features map and calls the feature's setter, if there is one.

See also: Poco::Data::SessionImpl::setFeature()

Sets the behavior regarding empty variable length strings. Those are treated as NULL by Oracle and as empty string by most other databases. When this feature is true, both empty strings and NULL values are reported as empty strings.

Sets the native session handle.

Looks a property up in the properties map and calls the property's setter, if there is one.

See also: Poco::Data::SessionImpl::setProperty()

Enables the SQL parsing. Value must be of type bool. When SQL parsing is enabled (default), the Statement attempts to parse the SQL prior to executing it. The parsing is done in non-autocommit mode only, with purpose to determine the type of query and whether to start the transaction automatically.

See Statement documentation for more information.

Sets the storage type.

Sets the storage type.

Adds a feature to the map of supported features.

The setter or getter can be null, in case setting or getting a feature is not supported.

Adds a property to the map of supported properties.

The setter or getter can be null, in case setting or getting a property is not supported.

Returns the value of the automatic commit flag. See setAutoCommit() documentation for more details.

Enables automatic commit. When this feature is true, every query is automatically commited. When false, every query starts a transaction, except SELECT queries (if properly detected by parser, see set/getSQLParse() and Statement::checkBeginTransaction() documentation).