org.apache.jackrabbit.oak.benchmark

Class ConcurrentWriteReadTest

java.lang.Object

org.apache.jackrabbit.oak.benchmark.Benchmark

org.apache.jackrabbit.oak.benchmark.ConcurrentReadTest

org.apache.jackrabbit.oak.benchmark.ConcurrentWriteReadTest

All Implemented Interfaces:

CSVResultGenerator

public class ConcurrentWriteReadTest
extends ConcurrentReadTest

A variant of ConcurrentReadTest with a that tests the performance of a single writer thread that continuously updates the nodes being accessed by the background readers.

Field Summary

Fields inherited from class org.apache.jackrabbit.oak.benchmark.ConcurrentReadTest

NODE_COUNT, ROOT_NODE_NAME

Constructor Summary

Constructors

Constructor and Description
ConcurrentWriteReadTest()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addBackgroundJob(Runnable job) Adds a background thread that repeatedly executes the given job until all the iterations of this test have been executed.
protected void	afterTest()
protected void	beforeTest()
long	execute() Executes a single iteration of this test.
protected void	failOnRepositoryVersions(String... versions)
protected javax.jcr.Credentials	getCredentials()
protected javax.jcr.Repository	getRepository()
protected static int	getScale(int def)
protected javax.jcr.Session	login(javax.jcr.Credentials credentials) Returns a new session for the given user that will be automatically closed once all the iterations of this test have been executed.
protected javax.jcr.Session	loginAnonymous() Returns a new reader session that will be automatically closed once all the iterations of this test have been executed.
protected javax.jcr.Session	loginWriter() Returns a new writer session that will be automatically closed once all the iterations of this test have been executed.
protected void	logout(javax.jcr.Session session) Logs out and removes the session from the internal pool.
void	run(Iterable<RepositoryFixture> fixtures) Runs this benchmark against all the given repository fixtures.
void	run(Iterable<RepositoryFixture> fixtures, List<Integer> concurrencyLevels)
void	setPrintStream(PrintStream out)
void	setUp(javax.jcr.Repository repository, javax.jcr.Credentials credentials) Prepares this performance benchmark.
void	tearDown() Cleans up after this performance benchmark.

Methods inherited from class org.apache.jackrabbit.oak.benchmark.ConcurrentReadTest

afterSuite, beforeSuite, runTest

Methods inherited from class org.apache.jackrabbit.oak.benchmark.Benchmark

toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ConcurrentWriteReadTest

public ConcurrentWriteReadTest()

Method Detail

setPrintStream

public void setPrintStream(PrintStream out)

Specified by:

setPrintStream in interface CSVResultGenerator

getScale

protected static int getScale(int def)

setUp

public void setUp(javax.jcr.Repository repository,
         javax.jcr.Credentials credentials)
           throws Exception

Prepares this performance benchmark.

Parameters:

repository - the repository to use

credentials - credentials of a user with write access

Throws:

Exception - if the benchmark can not be prepared

run

public void run(Iterable<RepositoryFixture> fixtures)

Description copied from class: Benchmark

Runs this benchmark against all the given repository fixtures. The benchmark report is written to standard output.

Specified by:

run in class Benchmark

Parameters:

fixtures - repository fixtures

run

public void run(Iterable<RepositoryFixture> fixtures,
       List<Integer> concurrencyLevels)

Overrides:

run in class Benchmark

execute

public long execute()
             throws Exception

Executes a single iteration of this test.

Returns:

number of milliseconds spent in this iteration

Throws:

Exception - if an error occurs

tearDown

public void tearDown()
              throws Exception

Cleans up after this performance benchmark.

Throws:

Exception - if the benchmark can not be cleaned up

beforeTest

protected void beforeTest()
                   throws Exception

Throws:

Exception

afterTest

protected void afterTest()
                  throws Exception

Throws:

Exception

failOnRepositoryVersions

protected void failOnRepositoryVersions(String... versions)
                                 throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException

getRepository

protected javax.jcr.Repository getRepository()

getCredentials

protected javax.jcr.Credentials getCredentials()

loginAnonymous

protected javax.jcr.Session loginAnonymous()

Returns a new reader session that will be automatically closed once all the iterations of this test have been executed.

Returns:

reader session

login

protected javax.jcr.Session login(javax.jcr.Credentials credentials)

Returns a new session for the given user that will be automatically closed once all the iterations of this test have been executed.

Parameters:

credentials - the user credentials

Returns:

user session

logout

protected void logout(javax.jcr.Session session)

Logs out and removes the session from the internal pool.

Parameters:

session - the session to logout

loginWriter

protected javax.jcr.Session loginWriter()

Returns a new writer session that will be automatically closed once all the iterations of this test have been executed.

Returns:

writer session

addBackgroundJob

protected void addBackgroundJob(Runnable job)

Adds a background thread that repeatedly executes the given job until all the iterations of this test have been executed.

Parameters:

job - background job