com.pivotal.gemfirexd.internal.impl.store.access.conglomerate.TemplateRow Maven / Gradle / Ivy
Show all versions of snappydata-store-core Show documentation
/*
Derby - Class com.pivotal.gemfirexd.internal.impl.store.access.conglomerate.TemplateRow
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to you under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package com.pivotal.gemfirexd.internal.impl.store.access.conglomerate;
import com.pivotal.gemfirexd.internal.iapi.error.StandardException;
import com.pivotal.gemfirexd.internal.iapi.reference.SQLState;
import com.pivotal.gemfirexd.internal.iapi.services.io.ArrayUtil;
import com.pivotal.gemfirexd.internal.iapi.services.io.FormatableBitSet;
import com.pivotal.gemfirexd.internal.iapi.services.io.Storable;
import com.pivotal.gemfirexd.internal.iapi.services.sanity.SanityManager;
import com.pivotal.gemfirexd.internal.iapi.store.access.RowUtil;
import com.pivotal.gemfirexd.internal.iapi.store.raw.Transaction;
import com.pivotal.gemfirexd.internal.iapi.types.DataValueDescriptor;
import com.pivotal.gemfirexd.internal.iapi.types.DataValueFactory;
import com.pivotal.gemfirexd.internal.iapi.types.SQLLongint;
public final class TemplateRow
{
/*
** Constructors of TemplateRow
*/
private TemplateRow() {
}
/* Private/Protected methods of This class: */
/**
* Allocate new objects to array based on format id's and column_list.
*
*
* @param num_cols_to_allocate The number of columns to allocate for array.
* @param column_list description of partial set of columns to
* built as described in RowUtil. If null do
* all the columns.
* @param format_ids An array of format ids representing every
* column in the table. column_list describes
* which of these columns to populate into the
* columns array.
*
* @exception StandardException Standard exception policy.
**/
private static DataValueDescriptor[] allocate_objects(
Transaction rawtran,
int num_cols_to_allocate,
FormatableBitSet column_list,
int[] format_ids,
int[] collation_ids)
throws StandardException
{
DataValueDescriptor[] ret_row =
new DataValueDescriptor[num_cols_to_allocate];
int num_cols =
(column_list == null ? format_ids.length : column_list.getLength());
DataValueFactory dvf = rawtran.getDataValueFactory();
for (int i = 0; i < num_cols; i++)
{
// does caller want this column?
if ((column_list != null) && (!column_list.get(i)))
{
// no - column should be skipped.
}
else
{
// yes - create the column
// get empty instance of object identified by the format id.
ret_row[i] = dvf.getNull(format_ids[i], collation_ids[i]);
if (SanityManager.DEBUG)
{
DataValueDescriptor o = ret_row[i];
if (o == null)
{
SanityManager.THROWASSERT(
"obj from DataValueFactory.newNull(" +
format_ids[i] + ", " + collation_ids[i] + ") null." +
";src column position = " + i +
";dest column position = " + i +
";num_cols = " + num_cols +
";format_ids.length = " + format_ids.length);
}
if ( ! (o instanceof Storable))
SanityManager.THROWASSERT(
"object:(" + o.getClass() +"):(" + o +
") not an instanceof Storable");
}
}
}
return(ret_row);
}
/* Public Methods of This class: */
/**
Constuctor for creating a template row which stores n SQLLongint's
**/
public static DataValueDescriptor[] newU8Row(int nkeys)
{
DataValueDescriptor[] columns = new DataValueDescriptor[nkeys];
for (int i = 0; i < columns.length; i++)
{
columns[i] = new SQLLongint(Long.MIN_VALUE);
}
return columns;
}
/**
* 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.
*
*
*
* @param template An array which represents a row as described in
* RowUtil.
*
* @exception StandardException Standard exception policy.
*
* @return The new row.
*
* @see RowUtil
**/
public static DataValueDescriptor[] newRow(
DataValueDescriptor[] template)
throws StandardException
{
DataValueDescriptor[] columns =
new DataValueDescriptor[template.length];
for (int i = template.length; i-- > 0 ;)
{
// get empty instance of object identified by the format id.
columns[i] = template[i].getNewNull();
}
return columns;
}
/**
* 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.
*
*
* @return The new row.
*
* @param format_ids an array of format id's, one per column in row.
*
* @exception StandardException Standard exception policy.
**/
public static DataValueDescriptor[] newRow(
Transaction rawtran,
FormatableBitSet column_list,
int[] format_ids,
int[] collation_ids)
throws StandardException
{
return(
allocate_objects(
rawtran, format_ids.length, column_list,
format_ids, collation_ids));
}
/**
* 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.
*
*
* @return The new row.
*
* @param format_ids an array of format id's, one per column in row.
* @param page_ptr The object to place in the last column of the template.
*
* @exception StandardException Standard exception policy.
**/
public static DataValueDescriptor[] newBranchRow(
Transaction rawtran,
int[] format_ids,
int[] collation_ids,
DataValueDescriptor page_ptr)
throws StandardException
{
// allocate an object array with the number of columns in the template
// row (ie. number of columns in the leaf row) + one column to hold
// the page pointer in the branch row.
DataValueDescriptor[] columns =
allocate_objects(
rawtran,
format_ids.length + 1,
(FormatableBitSet) null, format_ids, collation_ids);
// tack on the page pointer to the extra column allocated onto the
// end of the row built from a leafrow template.
columns[format_ids.length] = page_ptr;
return(columns);
}
/**
* Check that columns in the row conform to a set of format id's,
* both in number and type.
*
* @return boolean indicating if template matches format id's
*
* @param format_ids array of format ids which are the types of cols in row
* @param row the array of columns that make up the row.
*
* @exception StandardException Standard exception policy.
**/
static public boolean checkColumnTypes(
DataValueFactory dvf,
int[] format_ids,
int[] collation_ids,
DataValueDescriptor[] row)
throws StandardException
{
boolean ret_val = true;
while (true)
{
int nCols = row.length;
if (format_ids.length != row.length)
{
if (SanityManager.DEBUG)
{
SanityManager.THROWASSERT(
"format_ids[] length (" + format_ids.length +
") expected to be = row length (" + row.length + ")");
}
ret_val = false;
break;
}
if (SanityManager.DEBUG)
{
Object column;
Object column_template;
for (int colid = 0; colid < nCols; colid++)
{
column = row[colid];
if (column == null)
{
SanityManager.THROWASSERT(
"column[" + colid + "] is null");
}
column_template =
dvf.getNull(format_ids[colid], collation_ids[colid]);
// is this the right check?
if (column.getClass() != column_template.getClass())
{
SanityManager.DEBUG_PRINT(
"check", "row = " + RowUtil.toString(row));
SanityManager.THROWASSERT(
"input column["+colid+"] (" + column.getClass() +
") did not match expected template class (" +
column_template.getClass() + ")" +
"\ncolumn value = " + column +
"\nformat_ids = " +
ArrayUtil.toString(format_ids) +
"\ncollation = " +
ArrayUtil.toString(collation_ids));
}
}
}
break;
}
return(ret_val);
}
/**
* Check that columns in the row conform to a set of format id's,
* both in number and type.
*
* @return boolean indicating if template matches format id's
*
* @param format_ids array of format ids which are the types of cols in row
* @param row the array of columns that make up the row.
*
* @exception StandardException Standard exception policy.
**/
static public boolean checkPartialColumnTypes(
int[] format_ids,
FormatableBitSet validColumns,
int[] fieldStates,
DataValueDescriptor[] row)
throws StandardException
{
boolean ret_val = true;
return(ret_val);
}
}