AbstractBindingSetEncoderTestCase (Blazegraph Database Platform 2.1.5 API)

java.lang.Object
- junit.framework.Assert
- - junit.framework.TestCase
  - - junit.framework.TestCase2
    - - com.bigdata.rdf.internal.encoder.AbstractBindingSetEncoderTestCase

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

TestIVBindingSetEncoder, TestIVBindingSetEncoderWithCache, TestIVSolutionSetEncoder
```
public abstract class AbstractBindingSetEncoderTestCase
extends TestCase2
```
Base class for IBindingSetEncoderand IBindingSetDecoder test suites.

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 BlobIV<BigdataLiteral>`	`blobIV` A `BlobIV` whose `IVCache` is set.
`protected IBindingSetDecoder`	`decoder` The decoder under test.
`protected IBindingSetEncoder`	`encoder` The encoder under test.
`protected FullyInlineTypedLiteralIV<BigdataLiteral>`	`fullyInlinedTypedLiteralIV` Fully inlined literal IVs (do not require materialization)
`protected FullyInlineURIIV<BigdataURI>`	`fullyInlineUriIV` Extension IVs (require materialization) and the like
`protected XSDIntegerIV<BigdataLiteral>`	`inlineIV1` An inline IV whose `IVCache` is set.
`protected XSDDecimalIV<BigdataLiteral>`	`inlineIV2` An inline IV whose `IVCache` is set.
`protected XSDNumericIV<BigdataLiteral>`	`inlineIV3` An inline IV whose `IVCache` is set.
`protected XSDBooleanIV<?>`	`inlineIV4` An inline IV whose `IVCache` is NOT set.
`protected IPv4AddrIV<BigdataLiteral>`	`ipV4AddrIv`
`protected LiteralArrayIV`	`literalArrayIV`
`protected LiteralExtensionIV<BigdataLiteral>`	`literalExtensionIV`
`protected TermId<BigdataValue>`	`mockIV1` A "mockIV".
`protected TermId<BigdataValue>`	`mockIV2` A "mockIV".
`protected TermId<BigdataValue>`	`mockIV3` A "mockIV".
`protected TermId<BigdataValue>`	`mockIVCarryingBNode` A "mockIV".
`protected TermId<BigdataValue>`	`mockIVCarryingUri` A "mockIV".
`protected String`	`namespace` The namespace for the `BigdataValueFactory`.
`protected PackedLongIV<BigdataLiteral>`	`packedLongIV`
`protected TermId<BigdataLiteral>`	`termId` A `TermId` whose `IVCache` is set.
`protected TermId<BigdataLiteral>`	`termId2` A `TermId` whose `IVCache` is set.
`protected boolean`	`testCache` When `true`, `doEncodeDecodeTest(IBindingSet)` will also verify that the `IVCache` assertions were decoded.
`protected XSDUnsignedByteIV<BigdataLiteral>`	`unsignedByteIV`
`protected XSDUnsignedIntIV<BigdataLiteral>`	`unsignedIntIV`
`protected XSDUnsignedLongIV<BigdataLiteral>`	`unsignedLongIV`
`protected XSDUnsignedShortIV<BigdataLiteral>`	`unsignedShortIV`
`protected URIExtensionIV<?>`	`uriExtensionIV`
`protected UUIDLiteralIV<BigdataLiteral>`	`uuidLiteralIV`
`protected BigdataValueFactory`	`valueFactory` The value factory for that namespace.
`protected VocabURIByteIV<BigdataURI>`	`vocabUriByteIV` Other IVs requiring materialization
`protected VocabURIShortIV<BigdataURI>`	`vocabUriShortIV`

Fields inherited from class junit.framework.TestCase2
_randomType, log

Constructor Summary

Constructors
Constructor and Description

AbstractBindingSetEncoderTestCase()

AbstractBindingSetEncoderTestCase(String name)

Constructors
Constructor and Description
`AbstractBindingSetEncoderTestCase()`
`AbstractBindingSetEncoderTestCase(String name)`

Method Summary

Methods
Modifier and Type	Method and Description
`protected void`	`assertEquals(IBindingSet expected, IBindingSet actual, boolean testCache)`
`protected IBindingSet`	`doEncodeDecodeTest(IBindingSet expected)`
`protected IBindingSet`	`doEncodeDecodeTest(IBindingSet expected, boolean testCache)`
`protected BlobIV<BigdataLiteral>`	`getVeryLargeLiteral()`
`protected void`	`setUp()`
`protected void`	`tearDown()`
`void`	`test_encodeEmpty()`
`void`	`test_encodeNonEmpty()`
`void`	`test_encodeNonEmpty2()`
`void`	`test_encodeNonEmptyWithCachedValue()`
`void`	`test_encodeNonEmptyWithCachedValues()`
`void`	`test_encodeNonEmptyWithCachedValuesAndInlineValues()` Test where an inline `IV` has its `IVCache` set.
`void`	`test_encodeNonEmptyWithCachedValuesAndInlineValues2()` Variant where the inline `IV` does NOT have its `IVCache` set.
`void`	`test_multipleSolutions()` Multiple solutions where a variable does not appear in the 2nd solution.
`void`	`test_multipleSolutions2()` Multiple solutions where a new variables appears in the 2nd solution.
`void`	`test_multipleSolutions3()` Multiple solutions where an empty solution appears in the middle of the sequence.
`void`	`test_multipleSolutions4()` Multiple solutions where an empty solution appears in the 1st solution.
`void`	`test_multipleSolutions5()` Multiple solutions where an empty solution appears in the last solution.
`void`	`test_multipleSolutionsWithCachedValue4()` Multiple solutions where an empty solution appears in the 1st solution.
`void`	`test_multipleSolutionsWithCachedValue5()` Multiple solutions where an empty solution appears in the last solution.
`void`	`test_multipleSolutionsWithCachedValues()` Multiple solutions where a variable does not appear in the 2nd solution.
`void`	`test_multipleSolutionsWithCachedValues2()` Multiple solutions where a new variables appears in the 2nd solution.
`void`	`test_multipleSolutionsWithCachedValues3()` Multiple solutions where an empty solution appears in the middle of the sequence.
`void`	`test_solutionWithAllMockIVs()` Unit test with all mock IVs.
`void`	`test_solutionWithMockIVAndOthersToo()` Unit test with all mix of MockIVs, TermIds, and BlobIVs.
`void`	`test_solutionWithMockIVsPreservesFlagsBits()` This issue showed up as part of BLZG-533 (vector query engine on native heap) where the flags bits (which indicate URI or BNode or Literal) were not being preserved for a MockIV.
`void`	`test_solutionWithOneMockIV()` Unit test with one mock IV.
`void`	`test_solutionWithSameValueBoundTwice()`
`void`	`test_solutionWithThreeBindings1()` Unit test of a solution with 3 bindings.
`void`	`test_solutionWithThreeBindings2()` Unit test of a solution with 3 bindings in a different order.
`void`	`test_solutionWithThreeBindingsSomeNotCached1()` Unit test of a solution with 3 bindings, some of which do not have an `IVCache` association.
`void`	`test_solutionWithThreeBindingsSomeNotCachedSomeInline()` Unit test of a solution with 3 bindings, some of which do not have an `IVCache` association and some of which have an inline IV.
`void`	`test_solutionWithVeryLargeObject()` Unit test of a solution having a `BlobIV` with a `BigdataLiteral` which is very large.
`void`	`test_solutionWithVeryLargeObject2()` Unit test of a solution having a `BlobIV` with a `BigdataLiteral` which is very large plus a few other bindings.
`void`	`test_solutionWithVeryLargeObject3()` Unit test of a solution having a `BlobIV` with a `BigdataLiteral` which is very large plus a few other bindings (different order from the test above).
`void`	`testAbstractLiteralIVs()`
`void`	`testFullyInlineUriIV()`
`void`	`testLiteralExtensionIV()`
`void`	`testUriExtensionIV()`
`void`	`testVocabUriByteIV()`
`void`	`testVocabUriShortIV()`

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, getProperties, 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
  - testCache
```
protected boolean testCache
```
    When true, doEncodeDecodeTest(IBindingSet) will also verify that the IVCache assertions were decoded.
  - namespace
```
protected String namespace
```
    The namespace for the BigdataValueFactory.
  - valueFactory
```
protected BigdataValueFactory valueFactory
```
    The value factory for that namespace.
  - termId
```
protected TermId<BigdataLiteral> termId
```
    A TermId whose IVCache is set.
  - termId2
```
protected TermId<BigdataLiteral> termId2
```
    A TermId whose IVCache is set.
  - blobIV
```
protected BlobIV<BigdataLiteral> blobIV
```
    A BlobIV whose IVCache is set.
  - mockIV1
```
protected TermId<BigdataValue> mockIV1
```
    A "mockIV".
  - mockIV2
```
protected TermId<BigdataValue> mockIV2
```
    A "mockIV".
  - mockIV3
```
protected TermId<BigdataValue> mockIV3
```
    A "mockIV".
  - mockIVCarryingUri
```
protected TermId<BigdataValue> mockIVCarryingUri
```
    A "mockIV".
  - mockIVCarryingBNode
```
protected TermId<BigdataValue> mockIVCarryingBNode
```
    A "mockIV".
  - inlineIV1
```
protected XSDIntegerIV<BigdataLiteral> inlineIV1
```
    An inline IV whose IVCache is set.
  - inlineIV2
```
protected XSDDecimalIV<BigdataLiteral> inlineIV2
```
    An inline IV whose IVCache is set.
  - inlineIV3
```
protected XSDNumericIV<BigdataLiteral> inlineIV3
```
    An inline IV whose IVCache is set.
  - inlineIV4
```
protected XSDBooleanIV<?> inlineIV4
```
    An inline IV whose IVCache is NOT set.
  - fullyInlinedTypedLiteralIV
```
protected FullyInlineTypedLiteralIV<BigdataLiteral> fullyInlinedTypedLiteralIV
```
    Fully inlined literal IVs (do not require materialization)
  - ipV4AddrIv
```
protected IPv4AddrIV<BigdataLiteral> ipV4AddrIv
```
  - literalArrayIV
```
protected LiteralArrayIV literalArrayIV
```
  - packedLongIV
```
protected PackedLongIV<BigdataLiteral> packedLongIV
```
  - uuidLiteralIV
```
protected UUIDLiteralIV<BigdataLiteral> uuidLiteralIV
```
  - unsignedByteIV
```
protected XSDUnsignedByteIV<BigdataLiteral> unsignedByteIV
```
  - unsignedIntIV
```
protected XSDUnsignedIntIV<BigdataLiteral> unsignedIntIV
```
  - unsignedLongIV
```
protected XSDUnsignedLongIV<BigdataLiteral> unsignedLongIV
```
  - unsignedShortIV
```
protected XSDUnsignedShortIV<BigdataLiteral> unsignedShortIV
```
  - fullyInlineUriIV
```
protected FullyInlineURIIV<BigdataURI> fullyInlineUriIV
```
    Extension IVs (require materialization) and the like
  - literalExtensionIV
```
protected LiteralExtensionIV<BigdataLiteral> literalExtensionIV
```
  - uriExtensionIV
```
protected URIExtensionIV<?> uriExtensionIV
```
  - vocabUriByteIV
```
protected VocabURIByteIV<BigdataURI> vocabUriByteIV
```
    Other IVs requiring materialization
  - vocabUriShortIV
```
protected VocabURIShortIV<BigdataURI> vocabUriShortIV
```
  - encoder
```
protected IBindingSetEncoder encoder
```
    The encoder under test.
  - decoder
```
protected IBindingSetDecoder decoder
```
    The decoder under test.
- Constructor Detail
  - AbstractBindingSetEncoderTestCase
```
public AbstractBindingSetEncoderTestCase()
```
  - AbstractBindingSetEncoderTestCase
```
public AbstractBindingSetEncoderTestCase(String name)
```
    Parameters:
    name -
- Method Detail
  - setUp
```
protected void setUp()
              throws Exception
```
    Overrides:
    
    setUp in class junit.framework.TestCase
    
    Throws:
    
    Exception
  - tearDown
```
protected void tearDown()
                 throws Exception
```
    Overrides:
    
    tearDown in class junit.framework.TestCase
    
    Throws:
    
    Exception
  - doEncodeDecodeTest
```
protected IBindingSet doEncodeDecodeTest(IBindingSet expected)
```
  - doEncodeDecodeTest
```
protected IBindingSet doEncodeDecodeTest(IBindingSet expected,
                             boolean testCache)
```
    Parameters:
    expected -
    testCache -
    
    Returns:
    The decoded binding set.
  - assertEquals
```
protected void assertEquals(IBindingSet expected,
                IBindingSet actual,
                boolean testCache)
```
  - test_encodeEmpty
```
public void test_encodeEmpty()
```
  - test_encodeNonEmpty
```
public void test_encodeNonEmpty()
```
  - test_encodeNonEmpty2
```
public void test_encodeNonEmpty2()
```
  - test_multipleSolutions
```
public void test_multipleSolutions()
```
    Multiple solutions where a variable does not appear in the 2nd solution.
  - test_multipleSolutions2
```
public void test_multipleSolutions2()
```
    Multiple solutions where a new variables appears in the 2nd solution.
  - test_multipleSolutions3
```
public void test_multipleSolutions3()
```
    Multiple solutions where an empty solution appears in the middle of the sequence.
  - test_multipleSolutions4
```
public void test_multipleSolutions4()
```
    Multiple solutions where an empty solution appears in the 1st solution.
  - test_multipleSolutions5
```
public void test_multipleSolutions5()
```
    Multiple solutions where an empty solution appears in the last solution.
  - test_encodeNonEmptyWithCachedValue
```
public void test_encodeNonEmptyWithCachedValue()
```
  - test_encodeNonEmptyWithCachedValues
```
public void test_encodeNonEmptyWithCachedValues()
```
  - test_encodeNonEmptyWithCachedValuesAndInlineValues
```
public void test_encodeNonEmptyWithCachedValuesAndInlineValues()
```
    Test where an inline IV has its IVCache set.
    
    See Also:
    ClassCastException during hash join (can not be cast to TermId)
  - test_encodeNonEmptyWithCachedValuesAndInlineValues2
```
public void test_encodeNonEmptyWithCachedValuesAndInlineValues2()
```
    Variant where the inline IV does NOT have its IVCache set.
    
    See Also:
    ClassCastException during hash join (can not be cast to TermId)
  - test_multipleSolutionsWithCachedValues
```
public void test_multipleSolutionsWithCachedValues()
```
    Multiple solutions where a variable does not appear in the 2nd solution.
  - test_multipleSolutionsWithCachedValues2
```
public void test_multipleSolutionsWithCachedValues2()
```
    Multiple solutions where a new variables appears in the 2nd solution.
  - test_multipleSolutionsWithCachedValues3
```
public void test_multipleSolutionsWithCachedValues3()
```
    Multiple solutions where an empty solution appears in the middle of the sequence.
  - test_multipleSolutionsWithCachedValue4
```
public void test_multipleSolutionsWithCachedValue4()
```
    Multiple solutions where an empty solution appears in the 1st solution.
  - test_multipleSolutionsWithCachedValue5
```
public void test_multipleSolutionsWithCachedValue5()
```
    Multiple solutions where an empty solution appears in the last solution.
  - test_solutionWithThreeBindings1
```
public void test_solutionWithThreeBindings1()
```
    Unit test of a solution with 3 bindings.
  - test_solutionWithThreeBindingsSomeNotCached1
```
public void test_solutionWithThreeBindingsSomeNotCached1()
```
    Unit test of a solution with 3 bindings, some of which do not have an IVCache association. This test was added when some IVCache associations were observed to be associated with the wrong variables.
  - test_solutionWithThreeBindingsSomeNotCachedSomeInline
```
public void test_solutionWithThreeBindingsSomeNotCachedSomeInline()
```
    Unit test of a solution with 3 bindings, some of which do not have an IVCache association and some of which have an inline IV. This test was added when it was observed that we were pushing inline IVs into the cache for the IVBindingSetEncoderWithIVCache.
    
    See Also:
    ClassCastException during hash join (can not be cast to TermId)
  - test_solutionWithThreeBindings2
```
public void test_solutionWithThreeBindings2()
```
    Unit test of a solution with 3 bindings in a different order.
  - testAbstractLiteralIVs
```
public void testAbstractLiteralIVs()
```
  - testFullyInlineUriIV
```
public void testFullyInlineUriIV()
```
  - testLiteralExtensionIV
```
public void testLiteralExtensionIV()
```
  - testUriExtensionIV
```
public void testUriExtensionIV()
```
  - testVocabUriByteIV
```
public void testVocabUriByteIV()
```
  - testVocabUriShortIV
```
public void testVocabUriShortIV()
```
  - getVeryLargeLiteral
```
protected BlobIV<BigdataLiteral> getVeryLargeLiteral()
```
  - test_solutionWithVeryLargeObject
```
public void test_solutionWithVeryLargeObject()
```
    Unit test of a solution having a BlobIV with a BigdataLiteral which is very large.
  - test_solutionWithVeryLargeObject2
```
public void test_solutionWithVeryLargeObject2()
```
    Unit test of a solution having a BlobIV with a BigdataLiteral which is very large plus a few other bindings.
  - test_solutionWithVeryLargeObject3
```
public void test_solutionWithVeryLargeObject3()
```
    Unit test of a solution having a BlobIV with a BigdataLiteral which is very large plus a few other bindings (different order from the test above).
  - test_solutionWithSameValueBoundTwice
```
public void test_solutionWithSameValueBoundTwice()
```
  - test_solutionWithOneMockIV
```
public void test_solutionWithOneMockIV()
```
    Unit test with one mock IV.
    Note: TermId.mockIV(VTE) is used to generate "mock" IVs by operators which produce values (such as SUBSTR()) that are not in the database. The termId for all "mock" IV is 0L. While TermId.equals(Object) takes the IVCache association into account, the association is not yet available when we are de-serializing an encoded solution and is not part of the key when the key is constructed using IVUtility.encode(IKeyBuilder, IV). In each case this can lead to incorrectly resolving two "mock" IVs to the same value in an internal case.
    
    See Also:
    Optimize serialization for query messages on cluster
  - test_solutionWithAllMockIVs
```
public void test_solutionWithAllMockIVs()
```
    Unit test with all mock IVs.
  - test_solutionWithMockIVAndOthersToo
```
public void test_solutionWithMockIVAndOthersToo()
```
    Unit test with all mix of MockIVs, TermIds, and BlobIVs.
  - test_solutionWithMockIVsPreservesFlagsBits
```
public void test_solutionWithMockIVsPreservesFlagsBits()
```
    This issue showed up as part of BLZG-533 (vector query engine on native heap) where the flags bits (which indicate URI or BNode or Literal) were not being preserved for a MockIV.
    
    See Also:
    SolutionSetStream incorrectly decodes VTE of MockIVs

Class AbstractBindingSetEncoderTestCase

Nested Class Summary

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

Field Summary

Fields inherited from class junit.framework.TestCase2

Constructor Summary

Method Summary

Methods inherited from class junit.framework.TestCase2

Methods inherited from class junit.framework.TestCase

Methods inherited from class java.lang.Object

Field Detail

testCache

namespace

valueFactory

termId

termId2

blobIV

mockIV1

mockIV2

mockIV3

mockIVCarryingUri

mockIVCarryingBNode

inlineIV1

inlineIV2

inlineIV3

inlineIV4

fullyInlinedTypedLiteralIV

ipV4AddrIv

literalArrayIV

packedLongIV

uuidLiteralIV

unsignedByteIV

unsignedIntIV

unsignedLongIV

unsignedShortIV

fullyInlineUriIV

literalExtensionIV

uriExtensionIV

vocabUriByteIV

vocabUriShortIV

encoder

decoder

Constructor Detail

AbstractBindingSetEncoderTestCase

AbstractBindingSetEncoderTestCase

Method Detail

setUp

tearDown

doEncodeDecodeTest

doEncodeDecodeTest

assertEquals

test_encodeEmpty

test_encodeNonEmpty

test_encodeNonEmpty2

test_multipleSolutions

test_multipleSolutions2

test_multipleSolutions3

test_multipleSolutions4

test_multipleSolutions5

test_encodeNonEmptyWithCachedValue

test_encodeNonEmptyWithCachedValues

test_encodeNonEmptyWithCachedValuesAndInlineValues

test_encodeNonEmptyWithCachedValuesAndInlineValues2

test_multipleSolutionsWithCachedValues

test_multipleSolutionsWithCachedValues2

test_multipleSolutionsWithCachedValues3

test_multipleSolutionsWithCachedValue4

test_multipleSolutionsWithCachedValue5

test_solutionWithThreeBindings1

test_solutionWithThreeBindingsSomeNotCached1

test_solutionWithThreeBindingsSomeNotCachedSomeInline

test_solutionWithThreeBindings2

testAbstractLiteralIVs

testFullyInlineUriIV

testLiteralExtensionIV

testUriExtensionIV

testVocabUriByteIV

testVocabUriShortIV

getVeryLargeLiteral

test_solutionWithVeryLargeObject