org.apache.derby.impl.store.access.conglomerate

Class TemplateRow

java.lang.Object

org.apache.derby.impl.store.access.conglomerate.TemplateRow

public final class TemplateRow
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
static boolean	checkColumnTypes(DataValueFactory dvf, int[] format_ids, int[] collation_ids, DataValueDescriptor[] row) Check that columns in the row conform to a set of format id's, both in number and type.
static DataValueDescriptor[]	newBranchRow(Transaction rawtran, int[] format_ids, int[] collation_ids, DataValueDescriptor page_ptr) Generate an "empty" row to match the format id + coluumn specification.
static DataValueDescriptor[]	newRow(DataValueDescriptor[] template) Generate an "empty" row to match the format id specification.
static DataValueDescriptor[]	newRow(Transaction rawtran, FormatableBitSet column_list, int[] format_ids, int[] collation_ids) Generate an "empty" row to match the format id specification.
static DataValueDescriptor[]	newU8Row(int nkeys) Constuctor for creating a template row which stores n SQLLongint's

Methods inherited from class java.lang.Object

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

Method Detail

newU8Row

public static DataValueDescriptor[] newU8Row(int nkeys)

Constuctor for creating a template row which stores n SQLLongint's

newRow

public static DataValueDescriptor[] newRow(DataValueDescriptor[] template)
                                    throws StandardException

Generate an "empty" row to match the format id specification.

Generate an array of new'd objects matching the format id specification passed in. This routine is mostly used by the btree code to generate temporary rows needed during operations like split. It is more efficient to allocate new objects based on the old object vs. calling the Monitor.

Parameters:

template - An array which represents a row as described in RowUtil.

Returns:

The new row.

Throws:

StandardException - Standard exception policy.

See Also:

RowUtil

newRow

public static DataValueDescriptor[] newRow(Transaction rawtran,
                                           FormatableBitSet column_list,
                                           int[] format_ids,
                                           int[] collation_ids)
                                    throws StandardException

Generate an "empty" row to match the format id specification.

Generate an array of new'd objects matching the format id specification passed in. This routine is mostly used by the btree code to generate temporary rows needed during operations like split.

Parameters:

format_ids - an array of format id's, one per column in row.

Returns:

The new row.

Throws:

StandardException - Standard exception policy.

newBranchRow

public static DataValueDescriptor[] newBranchRow(Transaction rawtran,
                                                 int[] format_ids,
                                                 int[] collation_ids,
                                                 DataValueDescriptor page_ptr)
                                          throws StandardException

Generate an "empty" row to match the format id + coluumn specification.

Generate an array of new'd objects matching the format id specification passed in, and the column passed in. The new row is first made up of columns matching the format ids, and then followed by one other column matching the column passed in. This routine is mostly used by the btree code to generate temporary branch rows needed during operations like split.

Parameters:

format_ids - an array of format id's, one per column in row.

page_ptr - The object to place in the last column of the template.

Returns:

The new row.

Throws:

StandardException - Standard exception policy.

checkColumnTypes

public static boolean checkColumnTypes(DataValueFactory dvf,
                                       int[] format_ids,
                                       int[] collation_ids,
                                       DataValueDescriptor[] row)
                                throws StandardException

Check that columns in the row conform to a set of format id's, both in number and type.

Parameters:

format_ids - array of format ids which are the types of cols in row

row - the array of columns that make up the row.

Returns:

boolean indicating if template matches format id's

Throws:

StandardException - Standard exception policy.