org.apache.derby.impl.sql.execute
Class UpdatableVTIConstantAction

java.lang.Object
  org.apache.derby.impl.sql.execute.WriteCursorConstantAction
      org.apache.derby.impl.sql.execute.UpdatableVTIConstantAction

All Implemented Interfaces:

ConstantAction, java.io.Externalizable, Formatable, java.io.Serializable, TypedFormat

public class UpdatableVTIConstantAction

extends WriteCursorConstantAction

This class describes compiled constants that are passed into Updatable VTIResultSets.

Author:

Jerry Brenner

See Also:

Serialized Form

Field Summary

int[]	changedColumnIds This class implements Formatable.
long	conglomId This class implements Formatable.
boolean	deferred
StaticCompiledOpenConglomInfo	heapSCOCI
long[]	indexCIDS
java.lang.String[]	indexNames
StaticCompiledOpenConglomInfo[]	indexSCOCIs
IndexRowGenerator[]	irgs
int	lockMode
boolean	singleRowSource
int	statementType
java.util.Properties	targetProperties
UUID	targetUUID

Fields inherited from interface org.apache.derby.iapi.sql.execute.ConstantAction

RUNTIMESTATISTICS, STATISTICSTIMING

Constructor Summary

UpdatableVTIConstantAction()
Public niladic constructor.

UpdatableVTIConstantAction(int statementType, boolean deferred, int[] changedColumnIds)
Make the ConstantAction for an updatable VTI statement.

Method Summary

void	executeConstantAction(Activation activation) NOP routine.
FormatableBitSet	getBaseRowReadList()
int[]	getBaseRowReadMap()
long	getConglomerateId() Get the conglomerate id for the changed heap.
ExecRow	getEmptyHeapRow(LanguageConnectionContext lcc) Get emptyHeapRow
FKInfo[]	getFKInfo(ExecutionContext ec) Gets the foreign key information for this constant action.
java.lang.String	getIndexNameFromCID(long indexCID) get the index name given the conglomerate id of the index.
java.lang.String[]	getIndexNames()
java.lang.String	getProperty(java.lang.String key) The the value of the specified key, if it exists, from the targetProperties.
int[]	getStreamStorableHeapColIds()
java.util.Properties	getTargetProperties() Get the targetProperties from the constant action.
TriggerInfo	getTriggerInfo(ExecutionContext ec) Basically, the same as getFKInfo but for triggers.
int	getTypeFormatId() Get the formatID which corresponds to this class.
boolean	modifiesTableId(UUID tableId) Does this constant action modify the passed in table uuid?
void	readExternal(java.io.ObjectInput in) Read this object from a stream of stored objects.
boolean	upToDate() Reports whether these constants are up-to-date.
void	writeExternal(java.io.ObjectOutput out) Write this object to a stream of stored objects.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

changedColumnIds

public int[] changedColumnIds

This class implements Formatable. But it is NOT used across either major or minor releases. It is only written persistently in stored prepared statements, not in the replication stage. SO, IT IS OK TO CHANGE ITS read/writeExternal.

statementType

public int statementType

conglomId

public long conglomId

This class implements Formatable. But it is NOT used across either major or minor releases. It is only written persistently in stored prepared statements, not in the replication stage. SO, IT IS OK TO CHANGE ITS read/writeExternal.

heapSCOCI

public StaticCompiledOpenConglomInfo heapSCOCI

irgs

public IndexRowGenerator[] irgs

indexCIDS

public long[] indexCIDS

indexSCOCIs

public StaticCompiledOpenConglomInfo[] indexSCOCIs

indexNames

public java.lang.String[] indexNames

deferred

public boolean deferred

targetProperties

public java.util.Properties targetProperties

targetUUID

public UUID targetUUID

lockMode

public int lockMode

singleRowSource

public boolean singleRowSource

Constructor Detail

UpdatableVTIConstantAction

public UpdatableVTIConstantAction()

Public niladic constructor. Needed for Formatable interface to work.

UpdatableVTIConstantAction

public UpdatableVTIConstantAction(int statementType,
                                  boolean deferred,
                                  int[] changedColumnIds)

Make the ConstantAction for an updatable VTI statement.

Parameters:

deferred - Whether or not to do operation in deferred mode

changedColumnIds - Array of ids of changed columns

Method Detail

modifiesTableId

public boolean modifiesTableId(UUID tableId)

Does this constant action modify the passed in table uuid? By modify we mean add or drop things tied to this table (e.g. index, trigger, constraint). Things like views or spses that reference this table don't count.

Specified by:

modifiesTableId in interface ConstantAction

Overrides:

modifiesTableId in class WriteCursorConstantAction

Parameters:

tableId - on error

getTypeFormatId

public int getTypeFormatId()

Get the formatID which corresponds to this class.

Returns:

the formatID of this class

executeConstantAction

public void executeConstantAction(Activation activation)
                           throws StandardException

NOP routine. The work is done in subclass.

Specified by:

executeConstantAction in interface ConstantAction

Overrides:

executeConstantAction in class WriteCursorConstantAction

Throws:

StandardException - Thrown on failure

See Also:

ConstantAction.executeConstantAction(org.apache.derby.iapi.sql.Activation)

getFKInfo

public FKInfo[] getFKInfo(ExecutionContext ec)
                   throws StandardException

Gets the foreign key information for this constant action. A full list of foreign keys was compiled into this constant action. However, we prune this list at run time so that we enforce only the foreign keys that we absolutely must. What's going on here? Well, in certain contexts (REFRESH and when intially booting a Target), we don't have to enforce some foreign keys. We allow the ExecutionContext to rule on which foreign keys are relevant and which aren't.

Parameters:

ec - the ExecutionContext

Returns:

the list of foreign keys to enforce for this action

Throws:

StandardException - Thrown on failure

getTriggerInfo

public TriggerInfo getTriggerInfo(ExecutionContext ec)
                           throws StandardException

Basically, the same as getFKInfo but for triggers.

Returns:

the triggers that should be fired

Throws:

StandardException - Thrown on failure

upToDate

public boolean upToDate()

Reports whether these constants are up-to-date. This returns true for homogenous Cloudscape/Cloudsync. For the Plugin, this may return false;

Specified by:

upToDate in interface ConstantAction

Returns:

true if these constants are up-to-date false otherwise

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Read this object from a stream of stored objects.

Specified by:

readExternal in interface java.io.Externalizable

Parameters:

in - read this.

Throws:

java.io.IOException - thrown on error

java.lang.ClassNotFoundException - thrown on error

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException

Write this object to a stream of stored objects.

Specified by:

writeExternal in interface java.io.Externalizable

Parameters:

out - write bytes here.

Throws:

java.io.IOException - thrown on error

getConglomerateId

public long getConglomerateId()

Get the conglomerate id for the changed heap.

Returns:

the conglomerate id.

getEmptyHeapRow

public ExecRow getEmptyHeapRow(LanguageConnectionContext lcc)
                        throws StandardException

Get emptyHeapRow

Parameters:

lcc - The LanguageConnectionContext to use.

Returns:

an empty base table row for the table being updated.

Throws:

StandardException - on error

getTargetProperties

public java.util.Properties getTargetProperties()

Get the targetProperties from the constant action.

Returns:

The targetProperties

getProperty

public java.lang.String getProperty(java.lang.String key)

The the value of the specified key, if it exists, from the targetProperties.

Parameters:

key - The key to search for

Returns:

The value for the specified key if it exists, otherwise null. (Return null if targetProperties is null.)

getBaseRowReadList

public FormatableBitSet getBaseRowReadList()

getBaseRowReadMap

public int[] getBaseRowReadMap()

getStreamStorableHeapColIds

public int[] getStreamStorableHeapColIds()

getIndexNameFromCID

public java.lang.String getIndexNameFromCID(long indexCID)

get the index name given the conglomerate id of the index.

Parameters:

indexCID - conglomerate ID of the index.

Returns:

index name of given index.

getIndexNames

public java.lang.String[] getIndexNames()