com.tinkerpop.blueprints.ThreadedTransactionalGraph Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of blueprints-core Show documentation

Core interfaces and utilities for Blueprints

There is a newer version: 2.6.0

package com.tinkerpop.blueprints;

/**
 * ThreadedTransactionalGraph provides more fine grained control over the transactional context.
 * While TransactionalGraph binds each transaction to the executing thread, ThreadedTransactionalGraph's {@link #startTransaction} returns a {@link TransactionalGraph} that represents its own transactional context independent of the executing thread.
 * Hence, one can have multiple threads operating against a single transaction represented by the returned TransactionalGraph object. This is useful for parallelizing graph algorithms.
 *
 * Note, that one needs to call {@link TransactionalGraph#stopTransaction(com.tinkerpop.blueprints.TransactionalGraph.Conclusion)} to close the transactions returned
 * by {@link #startTransaction()}.
 * 
 * @author Matthias Brocheler (http://matthiasb.com)
 */
public interface ThreadedTransactionalGraph extends TransactionalGraph {

    /**
     * Returns a {@link TransactionalGraph} that represents a transactional context independent of the executing transaction.
     *
     * @return A transactional context. Invoking TransactionalGraph.shutdown() successfully commits the transaction.
     */
    public TransactionalGraph startTransaction();

}