Class GenericExecutionFactory
- All Implemented Interfaces:
ModuleControl
,ModuleSupportable
,ExecutionFactory
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate GenericConstantActionFactory
private ResultSetFactory
private ResultSetStatisticsFactory
Statistics factory for this factory.private XPLAINFactoryIF
Fields inherited from interface org.apache.derby.iapi.sql.execute.ExecutionFactory
MODULE
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
boot
(boolean create, Properties startParams) This Factory is expected to be booted relative to a LanguageConnectionFactory.private static Object
bootServiceModule
(boolean create, Object serviceModule, String factoryInterface, Properties properties) Privileged startup.boolean
canSupport
(Properties startParams) See if this implementation can support any attributes that are listed in properties.Get the factory for constant actions.getIndexableRow
(int numColumns) This returns an indexable rowgetIndexableRow
(ExecRow valueRow) This returns the value row as an indexable rowgetQualifier
(int columnId, int operator, GeneratedMethod orderableGetter, Activation activation, boolean orderedNulls, boolean unknownRV, boolean negateCompareResult, int variantType) Get a Qualifier to use with a scan of a conglomerate.getResultColumnDescriptor
(ResultColumnDescriptor compileRCD) Create an execution time ResultColumnDescriptor from a compile time RCD.getResultDescription
(ResultColumnDescriptor[] columns, String statementType) Make a result descriptionFactories are generic and can be used by all connections.Get the ResultSetStatisticsFactory from this ExecutionFactory.getRowChanger
(long heapConglom, StaticCompiledOpenConglomInfo heapSCOCI, DynamicCompiledOpenConglomInfo heapDCOCI, IndexRowGenerator[] irgs, long[] indexCIDS, StaticCompiledOpenConglomInfo[] indexSCOCIs, DynamicCompiledOpenConglomInfo[] indexDCOCIs, int numberOfColumns, TransactionController tc, int[] changedColumnIds, int[] streamStorableHeapColIds, Activation activation) Create a new RowChanger for performing update and delete operations based on full before and after rows.getRowChanger
(long heapConglom, StaticCompiledOpenConglomInfo heapSCOCI, DynamicCompiledOpenConglomInfo heapDCOCI, IndexRowGenerator[] irgs, long[] indexCIDS, StaticCompiledOpenConglomInfo[] indexSCOCIs, DynamicCompiledOpenConglomInfo[] indexDCOCIs, int numberOfColumns, TransactionController tc, int[] changedColumnIds, FormatableBitSet baseRowReadList, int[] baseRowReadMap, int[] streamStorableColIds, Activation activation) Create a new RowChanger for doing insert update and delete operations based on partial before and after.ScanQualifier[][]
getScanQualifier
(int numQualifiers) Get an array of ScanQualifiers for a scan.(package private) InternalTriggerExecutionContext
getTriggerExecutionContext
(LanguageConnectionContext lcc, ConnectionContext cc, String statementText, int dmlType, UUID targetTableId, String targetTableName, Vector<AutoincrementCounter> aiCounters) Get a trigger execution contextgetValueRow
(int numColumns) This returns a new row that is storable but not indexableGet the XPLAINFactory from this ExecutionContext.We want a dependency context so that we can push it onto the stack.void
releaseScanQualifier
(ScanQualifier[][] qualifiers) Release a ScanQualifier[] (back to the pool or free it).void
stop()
Stop the module.
-
Field Details
-
rssFactory
Statistics factory for this factory. -
rsFactory
-
genericConstantActionFactory
-
xplainFactory
-
-
Constructor Details
-
GenericExecutionFactory
public GenericExecutionFactory()
-
-
Method Details
-
canSupport
Description copied from interface:ModuleSupportable
See if this implementation can support any attributes that are listed in properties. This call may be made on a newly created instance before the boot() method has been called, or after the boot method has been called for a running module.The module can check for attributes in the properties to see if it can fulfill the required behaviour. E.g. the raw store may define an attribute called RawStore.Recoverable. If a temporary raw store is required the property RawStore.recoverable=false would be added to the properties before calling bootServiceModule. If a raw store cannot support this attribute its canSupport method would return null. Also see the Monitor class's prologue to see how the identifier is used in looking up properties.
Actually a better way maybe to have properties of the form RawStore.Attributes.mandatory=recoverable,smallfootprint and RawStore.Attributes.requested=oltp,fast- Specified by:
canSupport
in interfaceModuleSupportable
- Returns:
- true if this instance can be used, false otherwise.
-
boot
This Factory is expected to be booted relative to a LanguageConnectionFactory.- Specified by:
boot
in interfaceModuleControl
- Throws:
StandardException
- Thrown on error- See Also:
-
stop
public void stop()Description copied from interface:ModuleControl
Stop the module. The module may be found via a findModule() method until some time after this method returns. Therefore the factory must be prepared to reject requests to it once it has been stopped. In addition other modules may cache a reference to the module and make requests of it after it has been stopped, these requests should be rejected as well.- Specified by:
stop
in interfaceModuleControl
- See Also:
-
getResultSetFactory
Factories are generic and can be used by all connections. We defer instantiation until needed to reduce boot time. We may instantiate too many instances in rare multi-user situation, but consistency will be maintained and at some point, usually always, we will have 1 and only 1 instance of each factory because assignment is atomic.- Specified by:
getResultSetFactory
in interfaceExecutionFactory
- Returns:
- the result set factory for this database.
-
getConstantActionFactory
Get the factory for constant actions.- Returns:
- the factory for constant actions.
-
getResultSetStatisticsFactory
Get the ResultSetStatisticsFactory from this ExecutionFactory.- Specified by:
getResultSetStatisticsFactory
in interfaceExecutionFactory
- Returns:
- The result set statistics factory associated with this ExecutionFactory
- Throws:
StandardException
- Thrown on error
-
newExecutionContext
We want a dependency context so that we can push it onto the stack. We could instead require the implementation push it onto the stack for us, but this way we know which context object exactly was pushed onto the stack.- Specified by:
newExecutionContext
in interfaceExecutionFactory
- Parameters:
cm
- the context manager
-
getScanQualifier
Description copied from interface:ExecutionFactory
Get an array of ScanQualifiers for a scan. ScanQualifiers are used with the DataDictionary.- Specified by:
getScanQualifier
in interfaceExecutionFactory
- Parameters:
numQualifiers
- The number of ScanQualifiers to get.
-
getResultDescription
public ResultDescription getResultDescription(ResultColumnDescriptor[] columns, String statementType) Make a result description- Specified by:
getResultDescription
in interfaceExecutionFactory
-
getResultColumnDescriptor
Create an execution time ResultColumnDescriptor from a compile time RCD.- Specified by:
getResultColumnDescriptor
in interfaceExecutionFactory
- Parameters:
compileRCD
- The compile time RCD.- Returns:
- The execution time ResultColumnDescriptor
-
releaseScanQualifier
Description copied from interface:ExecutionFactory
Release a ScanQualifier[] (back to the pool or free it).- Specified by:
releaseScanQualifier
in interfaceExecutionFactory
- See Also:
-
getQualifier
public Qualifier getQualifier(int columnId, int operator, GeneratedMethod orderableGetter, Activation activation, boolean orderedNulls, boolean unknownRV, boolean negateCompareResult, int variantType) Description copied from interface:ExecutionFactory
Get a Qualifier to use with a scan of a conglomerate.- Specified by:
getQualifier
in interfaceExecutionFactory
- Parameters:
columnId
- The store id of the column to qualifyoperator
- One of Orderable.ORDER_OP_EQUALS, Orderable.ORDER_OP_LESSTHAN, or Orderable.ORDER_OP_LESSOREQUALSorderableGetter
- A generated method that returns the Orderable to be compared with the columnactivation
- The Activation that acts as the receiver for the generated methodorderedNulls
- True means that null == null for the sake of this QualifierunknownRV
- The value to return if the comparison between the column and the Orderable value returns the unknown truth valuenegateCompareResult
- True means to negate the result of the comparison. So, for example, to do a > comparison, you would pass ORDER_OP_LESSOREQUALS and set negate to true.variantType
- The variantType for the qualifier's orderable. (Determines whether or not to cache the value.)- Returns:
- A new Qualifier
- See Also:
-
getRowChanger
public RowChanger getRowChanger(long heapConglom, StaticCompiledOpenConglomInfo heapSCOCI, DynamicCompiledOpenConglomInfo heapDCOCI, IndexRowGenerator[] irgs, long[] indexCIDS, StaticCompiledOpenConglomInfo[] indexSCOCIs, DynamicCompiledOpenConglomInfo[] indexDCOCIs, int numberOfColumns, TransactionController tc, int[] changedColumnIds, int[] streamStorableHeapColIds, Activation activation) throws StandardException Description copied from interface:ExecutionFactory
Create a new RowChanger for performing update and delete operations based on full before and after rows.- Specified by:
getRowChanger
in interfaceExecutionFactory
- Parameters:
heapConglom
- Conglomerate # for the heapheapSCOCI
- The SCOCI for the heap.heapDCOCI
- The DCOCI for the heap.irgs
- the IndexRowGenerators for the table's indexes. We use positions in this array as local id's for indexes. To support updates, only indexes that change need be included.indexCIDS
- the conglomerateids for the table's idexes. indexCIDS[ix] corresponds to the same index as irgs[ix].indexSCOCIs
- the SCOCIs for the table's idexes. indexSCOCIs[ix] corresponds to the same index as irgs[ix].indexDCOCIs
- the DCOCIs for the table's idexes. indexDCOCIs[ix] corresponds to the same index as irgs[ix].numberOfColumns
- Number of columns in a full row.tc
- the transaction controllerstreamStorableHeapColIds
- Column ids of stream storable columns. (0 based, Only needed for sync. null if none or not needed).activation
- The Activation.- Throws:
StandardException
- Thrown on error- See Also:
-
getRowChanger
public RowChanger getRowChanger(long heapConglom, StaticCompiledOpenConglomInfo heapSCOCI, DynamicCompiledOpenConglomInfo heapDCOCI, IndexRowGenerator[] irgs, long[] indexCIDS, StaticCompiledOpenConglomInfo[] indexSCOCIs, DynamicCompiledOpenConglomInfo[] indexDCOCIs, int numberOfColumns, TransactionController tc, int[] changedColumnIds, FormatableBitSet baseRowReadList, int[] baseRowReadMap, int[] streamStorableColIds, Activation activation) throws StandardException Description copied from interface:ExecutionFactory
Create a new RowChanger for doing insert update and delete operations based on partial before and after.- Specified by:
getRowChanger
in interfaceExecutionFactory
- Parameters:
heapConglom
- Conglomerate # for the heapheapSCOCI
- The SCOCI for the heap.heapDCOCI
- The DCOCI for the heap.irgs
- the IndexRowGenerators for the table's indexes. We use positions in this array as local id's for indexes. To support updates, only indexes that change need be included.indexCIDS
- the conglomerateids for the table's idexes. indexCIDS[ix] corresponds to the same index as irgs[ix].indexSCOCIs
- the SCOCIs for the table's idexes. indexSCOCIs[ix] corresponds to the same index as irgs[ix].indexDCOCIs
- the DCOCIs for the table's idexes. indexDCOCIs[ix] corresponds to the same index as irgs[ix].numberOfColumns
- Number of columns in partial row.tc
- the transaction controllerchangedColumnIds
- array of 1 based ints of columns to be updated. Used by update only.baseRowReadList
- the columns in the base row that were read (1 based)baseRowReadMap
- baseRowReadMap[heapColId]->readRowColId (0 based)streamStorableColIds
- Column ids of stream storable columns. (0 based, Only needed for sync. null if none or not needed).activation
- The Activation.- Throws:
StandardException
- Thrown on error- See Also:
-
getTriggerExecutionContext
InternalTriggerExecutionContext getTriggerExecutionContext(LanguageConnectionContext lcc, ConnectionContext cc, String statementText, int dmlType, UUID targetTableId, String targetTableName, Vector<AutoincrementCounter> aiCounters) throws StandardException Get a trigger execution context- Throws:
StandardException
- Thrown on error
-
getValueRow
Description copied from interface:ExecutionFactory
This returns a new row that is storable but not indexable- Specified by:
getValueRow
in interfaceExecutionFactory
-
getIndexableRow
Description copied from interface:ExecutionFactory
This returns an indexable row- Specified by:
getIndexableRow
in interfaceExecutionFactory
-
getIndexableRow
Description copied from interface:ExecutionFactory
This returns the value row as an indexable row- Specified by:
getIndexableRow
in interfaceExecutionFactory
-
getXPLAINFactory
Get the XPLAINFactory from this ExecutionContext.- Specified by:
getXPLAINFactory
in interfaceExecutionFactory
- Returns:
- The XPLAINFactory associated with this ExecutionContext
- Throws:
StandardException
- Thrown on error
-
bootServiceModule
private static Object bootServiceModule(boolean create, Object serviceModule, String factoryInterface, Properties properties) throws StandardException Privileged startup. Must be private so that user code can't call this entry point.- Throws:
StandardException
-