com.bigdata.bop.join

Class HashIndexOpTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.bop.join.HashIndexOpTestCase

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

TestHTreeHashIndexOp, TestJVMHashIndexOp

public abstract class HashIndexOpTestCase
extends TestCase2

Abstract test suite for HashIndexOp implementations. TODO Test variant with non-empty join vars. TODO Test variant with SELECT projects only the selected variables.

Author:

Bryan Thompson

Nested Class Summary

Nested classes/interfaces inherited from class junit.framework.TestCase2

TestCase2.MyProperties, TestCase2.RandomType

Field Summary

Fields

Modifier and Type	Field and Description
protected QueryEngine	queryEngine

Fields inherited from class junit.framework.TestCase2

_randomType, log

Constructor Summary

Constructors

Constructor and Description
HashIndexOpTestCase()
HashIndexOpTestCase(String name)

Method Summary

Methods

Modifier and Type	Method and Description
protected static <T> T[]	concat(T[] a, T[] b) Combines the two arrays, appending the contents of the 2nd array to the contents of the first array.
Properties	getProperties() Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy.
protected abstract HashIndexOp	newHashIndexOp(String namespace, BOp[] args, NV... anns) Factory for the HashIndexOp implementations.
protected abstract SolutionSetHashJoinOp	newSolutionSetHashJoinOp(BOp[] args, NV... anns) Factory for the SolutionSetHashJoinOp implementation.
void	setUp()
void	tearDown()
void	test_hashIndexOp_01() A simple test of a HashIndexOp followed by a SolutionSetHashJoinOp.
void	test_hashIndexOp_02() Unit test of variant with an OPTIONAL join.
void	test_hashIndexOp_buildFromSolutionSet() Test variant where the index is built from a SolutionSetStream available as an attribute to the IRunningQuery.

Methods inherited from class junit.framework.TestCase2

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEqualsWithinUlps, assertSameArray, assertSameArray, assertSameBigDecimal, assertSameBigDecimal, assertSameBigInteger, assertSameBigInteger, assertSameIterator, assertSameIterator, assertSameIteratorAnyOrder, assertSameIteratorAnyOrder, assertSameValue, assertSameValue, assertZeroUlps, assertZeroUlps, fail, getInnerCause, getNormalInt, getProjectBuildPath, getRandomObject, getRandomObject, getRandomOrder, getRandomString, getTestInputStream, getTestResource, getTestResource, getUlps, getUlps, isDEBUG, isDEBUG, isINFO, isINFO, isInnerCause, logProperties

Methods inherited from class junit.framework.TestCase

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runBare, runTest, setName, toString

Methods inherited from class java.lang.Object

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

Field Detail

queryEngine

protected QueryEngine queryEngine

Constructor Detail

HashIndexOpTestCase

public HashIndexOpTestCase()

HashIndexOpTestCase

public HashIndexOpTestCase(String name)

Method Detail

getProperties

public Properties getProperties()

Description copied from class: TestCase2

Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy. If a property name is not bound at the top-level of the returned Properties object, then the lower levels of the hierarchy are recursively searched.

The hierarchy is constructed from the following properties files in the following order. The first property file in this list corresponds to the top of the property hierarchy. The last property file in this list corresponds to the bottom of the property hierarchy. The property resources are:

1. The System properties specified using the -D argument on the command line.
2. ${user.home}/build.properties. ${user.home} is the value of the Java system environment variable named "user.home" and corresponds to the user home directory. A warning is logged if this properties file does not exist. Note: The JUnit UI can wind up with a different value for this property than when you execute tests without the UI. It is an error if the properties file exists but can not be read.
3. {class}.properties, where {class} is the class name reported by Java reflection, is loaded iff it is found.
4. {class} is repeatedly truncated by dropping the last package name component to generate a package name. If a properties file named "test.properties" exists in that package then those properties are loaded.

Overrides:

getProperties in class TestCase2

Returns:

A Properties object that supplies bindings for property names according to the described hierarchy among property resources. The returned Properties is NOT cached. TODO This does not handle the recursive truncation of the class name to search for "test.properties" yet.

setUp

public void setUp()
           throws Exception

Overrides:

setUp in class junit.framework.TestCase

Throws:

Exception

tearDown

public void tearDown()
              throws Exception

Overrides:

tearDown in class junit.framework.TestCase

Throws:

Exception

newHashIndexOp

protected abstract HashIndexOp newHashIndexOp(String namespace,
                         BOp[] args,
                         NV... anns)

Factory for the HashIndexOp implementations.

Parameters:

namespace - The namespace of the lexicon relation (required by the ivCache for the HTree variants of the HashIndexOp).

newSolutionSetHashJoinOp

protected abstract SolutionSetHashJoinOp newSolutionSetHashJoinOp(BOp[] args,
                                             NV... anns)

Factory for the SolutionSetHashJoinOp implementation.

concat

protected static <T> T[] concat(T[] a,
             T[] b)

Combines the two arrays, appending the contents of the 2nd array to the contents of the first array.

Parameters:

a -

b -

Returns:

test_hashIndexOp_01

public void test_hashIndexOp_01()
                         throws Exception

A simple test of a HashIndexOp followed by a SolutionSetHashJoinOp. In practice we should never follow the HashIndexOp immediately with a SolutionSetHashJoinOp as this is basically a complex NOP. However, this does provide a simple test of the most basic mechanisms for those two operators.

Throws:

Exception

test_hashIndexOp_02

public void test_hashIndexOp_02()
                         throws Exception

Unit test of variant with an OPTIONAL join.

Note: Since there are no intervening joins or filters, this produces the same output as the unit test above. However, in this case the joinSet will have been created by the HashIndexOp and utilized by the SolutionSetHashJoinOp.

Throws:

Exception

test_hashIndexOp_buildFromSolutionSet

public void test_hashIndexOp_buildFromSolutionSet()
                                           throws Exception

Test variant where the index is built from a SolutionSetStream available as an attribute to the IRunningQuery. FIXME Also test with IHashJoinUtility query attribute as the source (rather than a SolutionSetStream) and an IPredicate.

Throws:

Exception