com.bigdata.rdf.sail.webapp

Class Test_REST_TX_API<S extends IIndexManager>

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.rdf.sail.webapp.AbstractIndexManagerTestCase<S>

com.bigdata.rdf.sail.webapp.ProxyTestCase<S>

com.bigdata.rdf.sail.webapp.AbstractTestNanoSparqlClient<S>

com.bigdata.rdf.sail.webapp.Test_REST_TX_API<S>

Type Parameters:

S -

All Implemented Interfaces:

IProxyTest, junit.framework.Test

Direct Known Subclasses:

Test_REST_TX_API.NoReadWriteTx, Test_REST_TX_API.ReadWriteTx

public class Test_REST_TX_API<S extends IIndexManager>
extends AbstractTestNanoSparqlClient<S>

Proxied test suite for testing the transaction management API. The outer class provides a test suite for behaviors that are consistent without regard to whether or not isolatable indices have been enabled. There are then two inner classes that provide tests where we are controlling the configuration and verifying behaviors that are specific to when isolatable indices are / are not enabled.

See Also:

Support read/write transactions in the REST API FIXME (***) Test operations isolated by transactions. FIXME Test that a sequence of queries may be isolated by a read-only transaction and that the queries have snapshot isolation across the transaction that is preserved even when there are new commit points that write on the namespace. FIXME Write tests in which we force operations where the transaction is not active and make sure that the API is behaving itself in terms of the error messages. FIXME Write HA tests for transaction coordination. See #1189 FIXME Modify the multi-tenancy API stress test to obtain a stress test that also operations against namespaces that are configured with isolatable index support. TODO Test that a transaction may be created without regard to the end point. The transaction is about the transaction manager, not a given namespace. Isolation of a namespace is obtained by having the transaction pin the commit point associated with its start time (its readsOnCommitTime). Thus we can actually use a single transaction to coordinate an operation on more than one namespace in the same database. TODO Write unit test that is federation specific and which verifies that read/write transactions are correctly rejected since they are not supported for scale-out (we do not support distributed 2-phase transactions). FIXME Write a test suite that uses a mixture of unisolated and read/write transactions. Verify that we can use unisolated transactions for bulk load and isolated transactions for smaller mutations and that the indices are consistent (especially, this is concerned with the revision timestamps on the indices that are used to detect write-write conflicts in read/write transactions - the unisolated updates need to be touching those timestamps if the index supports isolation in order for the read/write transactions to detect a conflict created by an unisolated update since the read/write transaction was created.)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Test_REST_TX_API.NoReadWriteTx<S extends IIndexManager> An *extension* of the test suite that uses a namespace that is NOT configured to support read/write transactions.
static class	Test_REST_TX_API.ReadWriteTx<S extends IIndexManager> An *extension* of the test suite that uses a namespace that is configured to support read/write transactions.

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

TestCase2.MyProperties, TestCase2.RandomType

Field Summary

Fields inherited from class com.bigdata.rdf.sail.webapp.AbstractTestNanoSparqlClient

m_client, m_fixture, m_mgr, m_repo, m_rootURL, m_serviceURL, namespace, packagePath

Fields inherited from class junit.framework.TestCase2

_randomType, log

Constructor Summary

Constructors

Constructor and Description
Test_REST_TX_API()
Test_REST_TX_API(String name)

Method Summary

Methods

Modifier and Type	Method and Description
static junit.framework.Test	suite()
void	test_CREATE_TX_READ_ONLY_01() Create an read-only transaction, verify its metadata, and abort it.
void	test_CREATE_TX_READ_ONLY_02() Create an read-only transaction and commit it.
void	test_CREATE_TX_UNISOLATED_01() Create an unisolated transaction, verify its metadata, and abort it.
void	test_CREATE_TX_UNISOLATED_02() Create an unisolated transaction and commit it.

Methods inherited from class com.bigdata.rdf.sail.webapp.AbstractTestNanoSparqlClient

asGraph, asGraph, assertSameGraph, assertSameGraph, countAll, countMatches, countResults, countResults, countResults, doConstructTest, doDeleteWithAccessPath, doDeleteWithBody, doDeleteWithPostTest, doDeleteWithQuery, doDescribeTest, doInsertByBody, doInsertbyURL, doInsertWithBodyTest, genNTRIPLES, genNTRIPLES2, getExactSize, getMatches, getResponseBody, getTestMode, getVeryLargeLiteral, loadGraphFromResource, newFixture, readFromFile, readGraphFromFile, setUp, setupDataOnServer, setupQuadsDataOnServer, tearDown, writeOnBuffer

Methods inherited from class com.bigdata.rdf.sail.webapp.ProxyTestCase

getDelegate, getIndexManager, getOurDelegate, getProperties, setDelegate

Methods inherited from class com.bigdata.rdf.sail.webapp.AbstractIndexManagerTestCase

checkIfProxy, setUp, tearDown, tearDownAfterSuite

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

Methods inherited from interface junit.framework.Test

countTestCases, run

Constructor Detail

Test_REST_TX_API

public Test_REST_TX_API()

Test_REST_TX_API

public Test_REST_TX_API(String name)

Method Detail

suite

public static junit.framework.Test suite()

test_CREATE_TX_UNISOLATED_01

public void test_CREATE_TX_UNISOLATED_01()
                                  throws Exception

Create an unisolated transaction, verify its metadata, and abort it.

Throws:

Exception

test_CREATE_TX_UNISOLATED_02

public void test_CREATE_TX_UNISOLATED_02()
                                  throws Exception

Create an unisolated transaction and commit it. This should be a NOP since nothing is written on the database. TODO Create an unisolated transaction, write on the transaction, commit the transaction and verify that we can read back the write set after the commit. Note that we can only write on the resulting transaction if the namespace supports isolatable indices.

Throws:

Exception

test_CREATE_TX_READ_ONLY_01

public void test_CREATE_TX_READ_ONLY_01()
                                 throws Exception

Create an read-only transaction, verify its metadata, and abort it.

Throws:

Exception

test_CREATE_TX_READ_ONLY_02

public void test_CREATE_TX_READ_ONLY_02()
                                 throws Exception

Create an read-only transaction and commit it. This should be a NOP since nothing is written on the database. TODO Actually read on the transaction. Verify that we do not see concurrent updates. TODO Do something similar with read-historical transactions. Verify that we do not see concurrent updates and that we do not see updates for commit points after the transaction start (this is nearly the same thing, but we also should create the read-only tx only once we know that a commit point has been pinned and that subsequent commits have been applied and verify that the new tx is also reading from the correct commit point.)

Throws:

Exception