DynamicQueryEngine Class

Initializes a new instance of the DynamicQueryEngine class.

Gets / sets creator

Sets the default compatibility level used by the DQE. Default is Oracle9i10g11g. This is a global setting. Compatibility level influences the query generated for paging and identity sequence usage in inserts.

Gets or sets the distinct filtering preference to use. The default value is the value of the global variable DynamicQueryEngineBase.DistinctFilteringPreferenceDefault.

Gets the DbProviderFactory to use for this DQE.

Gets the function mappings for the particular DQE. These function mappings are static and therefore not changeable.

Gets / sets perCallCatalogNameOverwrites name pairs

Gets / sets perCallSchemaNameOverwrites name pairs

Gets whether the database of this DQE supports packed queries, which are queries with multiple SQL statements packed together in a single DbCommand. By default this property returns false.

Adds a single target element to from clause. This is used when there's no join to add, but instead a single target. Takes care of hint emitting if required.

Appends the field's expression as value to the specified valueFragments list for the specified insert query. It also appends the parameters to the query as parameters (not anonymized yet)

Appends the field (or its expresssion) to the value fragments of the query specified for insert.

Appends a FROM clause with the contents of the elements specified to the destination and adds the parameters (if any) to the query to append to.

Appends a GROUP BY clause with the contents of the filter if it's not null / empty, to the fragments object specified. Parameters are added to the query specified

Appends an GROUP BY clause with the contents of the filter if it's not null / empty, to the fragments object specified. Parameters are added to the query specified

Appends, if required, fragments to the passed in fragments builder, for collecting data right after an update query has executed inside a batch.

Appends the hints specified a single prefix hintstring suffix clause to the fragments specified.

Appends all resultset fields to the query specified using the parameters specified and outputs values detected along the way during the process for further query construction.

Appends, if specified, the unioned queries to the fragments specified, wrapping nested queries in () if necessary. Parameters are appneded to query.

Appends set clauses for an update query using the input specified to the destination list specified

Appends set clauses for an update query using the input specified to the destination list specified

Appends a WHERE clause with the contents of the filter if it's not null / empty, to the fragments object specified. Parameters are added to the query specified

Checks the if field needs insert action.

Constructs the list of fields to update plus its corresponding fieldpersistenceinfo list.

Creates the action query from the sql query specified using the parameter values specified.

Creates the command.

Creates a new DbCommand object and initializes it

Creates a new DbCommand object and initializes it

Creates a new DbCommand object and initializes it

Creates a new IDbSpecificCreator and initializes it

Creates a new Delete Query object which is ready to use.

Creates a new Delete Query object which is ready to use.

Creates a new Insert Query object which is ready to use.

Creates a new Insert Query object which is ready to use.

Creates a new INSERT INTO target (field1, field2...) SELECT ... query.

Creates a new Select Query which is ready to use, based on the query parameters specified.

Creates the real sql query to execute from the query in string form and the parameters specified. It updates 'query' with the constructed string and real DbParameter instances.

Creates the retrieval query from the SQL query specified using the parameter values specified and is configured with the aspects specified.

Creates a select query which will be executed as a scalar, and which will return a single value, the number of rows in the query formed by the elements passed in.

Creates a new Select Query which is ready to use, based on the specified select list and the specified set of relations. If selectFilter is set to null, all rows are selected.

Creates a new Select Query which is ready to use, based on the specified elements.

Creates a new Delete Query object which is ready to use.

Creates a new Delete Query object which is ready to use.

Creates a new Delete Query object which is ready to use.

Creates a new Delete Query object which is ready to use. Uses keyword clause (using keyword FROM/USING etc.)) for filtering

Creates a new Insert Query object which is ready to use.

Creates a new Update Query object which is ready to use. Only 'changed' EntityFieldCore fields are included in the update query. Primary Key fields are never updated.

Creates a new Update Query object which is ready to use. Only 'changed' EntityFieldCore are included in the update query. Primary Key fields are never updated.

Creates a new Update Query object which is ready to use. Only 'changed' EntityFieldCore are included in the update query. Primary Key fields are never updated. Uses a correlated subquery for filtering

Creates a new Update Query object which is ready to use. Only 'changed' EntityFieldCore are included in the update query. Primary Key fields are never updated. Uses a FROM clause for filtering

Creates a DbCommand which is ready to be used to call the stored procedure specified.

Produces a set of WHERE Clauses to use in the DELETE queries which have filters spanning multiple entities. It produces one clause if it finds the deleteTable on the PK side and then stops and it produces n clauses if it finds deleteTable on the FK side of n relations in relationsToWalk. If the deleteTable is on the PK side, it produces a clause: deleteTableAlias.PKField1 = deleteTable.PKField1 AND... (for each field in the PK 1 clause) If the deleteTable is on the FK side, it produces deleteTableAlias.Field1 = relatedEntityTable.Field1 AND ... clauses for each relation the table of the persistence info is in.

Produces a set of WHERE Clauses to use in the UPDATE queries which have filters spanning multiple entities. It produces one clause if it finds the updateTable on the PK side and then stops and it produces n clauses if it finds updateTable on the FK side of n relations in relationsToWalk. If the updateTable is on the PK side, it produces a clause: updatedTableAlias.PKField1 = updateTable.PKField1 AND... (for each field in the PK 1 clause) If the updateTable is on the FK side, it produces updatedTableAlias.Field1 = relatedEntityTable.Field1 AND ... clauses for each relation the table of the persistence info is in.

Creates a retrieval query for the tvfcall specified.

Creates the TVF function name fragment list. By default it will create 'FunctionName(parameterList)'. Override this method if the DQE requires a different strategy to call a TVF, e.g. wrapping it.

Creates a new Update Query object which is ready to use. Only 'changed' EntityFields are included in the update query. Primary Key fields are never updated.

Creates a new Update Query object which is ready to use. Only 'changed' EntityFieldCore fields are included in the update query.

Creates a new Update Query object which is ready to use. Only 'changed' EntityFieldCore are included in the update query. Primary Key fields are never updated.

Creates a new Update Query object which is ready to use. Only 'changed' EntityFieldCore are included in the update query. Primary Key fields are never updated.

Determines if duplicates will occur.

Determines if field alias is required.

Determines the object alias to use for select list field.

Appends pre and/or post action fragments to the query fragments specified to be placed before and after an INSERT INTO table (...) SELECT query to enable identity inserts. This method should be a no-op if the field's persistence info points to a sequence that isn't an identity/system sequence so pre/post actions aren't needed. The field which persistence info is passed in is part of the projection of the SELECT part of the INSERT INTO table (...) SELECT... query.

Returns the expression in string form to use to retrieve the next value for the sequence pointed at by the passed in fieldPersistenceInfo. The expression is added to the projection of the SELECT part of an INSERT INTO table (...) SELECT... query. The field which persistence info has been passed in isn't part of the select's projection part and will have to be present with a sequence retrieval expression if the sequence used by the field is a non-system sequence. In all other situations this method returns the empty string

Determines the target alias to use for a single target FROM clause.

Determines whether the specified object is equal to the current object.

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

Gets the correct field type, based on the type and lenght specified in the specified persistenceInfo

Serves as the default hash function.

Gets the new name for the catalog, given the current name. If the current name is not found in the list of catalog name overwrites, the current name is returned. This routine works on the catalog names specified in the config file.

Gets the new name of the sequence passed in. Default implementation overwrites schema name with a new name if the name has been defined for overwriting. Works on the PerCallSchemaNameOverwrites set.

Gets the new name of the stored procedure passed in. Overwrites schema and catalog name with a new name if these names have been defined for overwriting. This routine works on the PerCallCatalogNameOverwrites and PerCallSchemaNameOverwrites names specified on this instance

Gets the new name for the schema, given the current name. If the current name is not found in the list of schema name overwrites, the current name is returned.

Gets the new name of the sequence passed in. Default implementation overwrites schema name with a new name if the name has been defined for overwriting.

Gets the new name of the stored procedure passed in. Overwrites schema and catalog name with a new name if these names have been defined for overwriting. This routine works on the catalog and schema names specified in the config file.

Gets the fragment to use in a projection for a literal NULL. By default this is 'NULL', but some databases need extra processing around NULL. Do to so, override this method.

Gets the table valued function name to use. By default it creates an object name from the elements specified like a table name.

Gets the Type of the current instance.

Handles the emit of 'DISTINCT' into the query text and returns true if distinct was emitted or false if not.

Makes the parameters anonymous in the passed in query. An anonymous parameter is '?', not '@foo'. It walks all parameters and replaces the names of these parameters with "?" in the query text

Makes the parameters anonymous in the passed in query. An anonymous parameter is '?', not '@foo'. It walks all parameters and replaces the names of these parameters with "?" in the query text

Creates a shallow copy of the current Object.

Prepares, if necessary, the passed in query object for a batch update query. Use this method to e.g. create an output parameter which collects the number of rows affected.

Reassembles the fragments specified, with separting '.'. If a fragment is empty, it's skipped

Re-assembles the stored procedure name from the fragments specified

Resets the creator object with a new one. Only used by DAO objects which keep a Dynamic Query Engine object alive.

Returns a string that represents the current object.

Updates the SourceAlias in the predicates in updateFilter to the alias updatedTableAlias if the predicate targets the entity name specified.

Wraps the command in the query specified in a paging query and adds necessary parameters to the command.

Wraps the passed in query if necessary. By default it returns the toWrap string without doing any processing.

Flag to signal to always use rownum based paging (true) or let the DQE choose the paging mechanism based on the compatibility (false, default). Only used when compatibility is set to 12c or higher. By default this flag is false and will make the the DQE choose in 12c+ mode a FETCH NEXT / OFFSET approach.

Flag to signal to always wrap aliases in quotes (making them case sensitive) (true), or wrap them only when CaseInsensitiveNames is set to true (false, default). Only set this flag to true if you use Case insensitive names and also aliases which are reserved words, as these aliases are in that case no longer wrapped in double quotes.