com.bigdata.bop.join

Class TestPipelineJoin

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.bop.join.TestPipelineJoin

All Implemented Interfaces:

junit.framework.Test

public class TestPipelineJoin
extends TestCase2

Unit tests for the PipelineJoin operator.

Note: The logic to map binding sets over shards is tested independently.

Version:

$Id$

Author:

Bryan Thompson

Nested Class Summary

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

TestCase2.MyProperties, TestCase2.RandomType

Field Summary

Fields inherited from class junit.framework.TestCase2

_randomType, log

Constructor Summary

Constructors

Constructor and Description
TestPipelineJoin()
TestPipelineJoin(String name)

Method Summary

Methods

Modifier and Type	Method and Description
Properties	getProperties() Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy.
protected ThickAsynchronousIterator<IBindingSet[]>	newBindingSetIterator(IBindingSet bindingSet) Return an IAsynchronousIterator that will read a single IBindingSet.
void	setUp()
void	tearDown()
void	test_join_constraint() Unit test for a join with an IConstraint.
void	test_join_duplicateElimination() Unit test for a pipeline join in which we expect duplicate access paths to be eliminated.
void	test_join_noSharedVariables_emptySourceSolution() Unit test for a pipeline join without shared variables and fed by a single empty binding set.
void	test_join_noSharedVariables_multipleSourceSolutions() Unit test for a join without shared variables with multiple source solutions.
void	test_join_selectVariables() Unit test for a join which selects a subset of the variables to pass along.
void	test_join_sharedVariables_multipleSourceSolutions() Unit test for a join with shared variables with multiple source solutions (the source solutions already have a bound value for the shared variable so the join turns into a point test).
void	test_optionalJoin_withAltSink() Unit test for an optional PipelineJoin when the alternative sink is specified.
void	test_optionalJoin_withConstraint() Unit tests for optional joins with a constraint.
void	test_optionalJoin() Unit tests for optional joins.

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

Constructor Detail

TestPipelineJoin

public TestPipelineJoin()

TestPipelineJoin

public TestPipelineJoin(String name)

Parameters:

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

newBindingSetIterator

protected ThickAsynchronousIterator<IBindingSet[]> newBindingSetIterator(IBindingSet bindingSet)

Return an IAsynchronousIterator that will read a single IBindingSet.

Parameters:

bindingSet - the binding set.

test_join_noSharedVariables_emptySourceSolution

public void test_join_noSharedVariables_emptySourceSolution()
                                                     throws InterruptedException,
                                                            ExecutionException

Unit test for a pipeline join without shared variables and fed by a single empty binding set.

Throws:

ExecutionException

InterruptedException

test_join_noSharedVariables_multipleSourceSolutions

public void test_join_noSharedVariables_multipleSourceSolutions()
                                                         throws InterruptedException,
                                                                ExecutionException

Unit test for a join without shared variables with multiple source solutions.

Throws:

InterruptedException

ExecutionException

test_join_sharedVariables_multipleSourceSolutions

public void test_join_sharedVariables_multipleSourceSolutions()
                                                       throws InterruptedException,
                                                              ExecutionException

Unit test for a join with shared variables with multiple source solutions (the source solutions already have a bound value for the shared variable so the join turns into a point test).

Throws:

InterruptedException

ExecutionException

test_join_duplicateElimination

public void test_join_duplicateElimination()
                                    throws InterruptedException,
                                           ExecutionException

Unit test for a pipeline join in which we expect duplicate access paths to be eliminated.

Throws:

ExecutionException

InterruptedException

test_join_constraint

public void test_join_constraint()
                          throws InterruptedException,
                                 ExecutionException

Unit test for a join with an IConstraint. The constraint is used to filter out one of the solutions where "Mary" is the present in the first column of the relation.

Throws:

ExecutionException

InterruptedException

test_join_selectVariables

public void test_join_selectVariables()
                               throws InterruptedException,
                                      ExecutionException

Unit test for a join which selects a subset of the variables to pass along.

Note: The order of the expected solutions for this test depends on the order of the keys associated with the tuples in the relation. Since the key is [name,value], the result order is based on this tuple order:

 E("John", "Mary") 
 E("Leon", "Paul") 
 E("Mary", "John") 
 E("Mary", "Paul") 
 E("Paul", "Leon")
 

Throws:

ExecutionException

InterruptedException

test_optionalJoin

public void test_optionalJoin()
                       throws InterruptedException,
                              ExecutionException

Unit tests for optional joins. For an optional join, an alternative sink may be specified for the join. When specified, it is used if the join fails (if not specified, the binding sets which do not join are forwarded to the primary sink). Binding sets which join go to the primary sink regardless.

Throws:

ExecutionException

InterruptedException

test_optionalJoin_withAltSink

public void test_optionalJoin_withAltSink()
                                   throws InterruptedException,
                                          ExecutionException

Unit test for an optional PipelineJoin when the alternative sink is specified.

Throws:

InterruptedException

ExecutionException

test_optionalJoin_withConstraint

public void test_optionalJoin_withConstraint()
                                      throws InterruptedException,
                                             ExecutionException

Unit tests for optional joins with a constraint. The constraint is applied to test each solution which joins. Solutions which do not join, or which join but fail the constraint, are passed along as "optional" solutions.

Throws:

ExecutionException

InterruptedException