org.jsimpledb.kv.RetryTransactionException Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jsimpledb-kv Show documentation

JSimpleDB classes relating to the key/value store API.

The newest version!


/*
 * Copyright (C) 2015 Archie L. Cobbs. All rights reserved.
 */

package org.jsimpledb.kv;

/**
 * Exception thrown when an attempt to access a {@link KVTransaction} results
 * in a conflict or other condition requiring that the transaction be retried.
 *
 * 
 * Note: although it is usually the case, a {@link RetryTransactionException}
 * does not necessarily mean that the transaction failed. In some situations
 * (e.g., involving failed network communication) it may not be possible to determine
 * whether a transaction succeeded or not, and this situation is indicated by throwing a
 * {@link RetryTransactionException}. Whether and how often such a "false negative" can
 * occur is a function of the {@link KVDatabase} implementation being used; ideally, all
 * transactions are idempotent and therefore correct in either case.
 */
@SuppressWarnings("serial")
public class RetryTransactionException extends KVTransactionException {

    private static final String DEFAULT_MESSAGE = "transaction must be retried";

    public RetryTransactionException(KVTransaction kvt) {
        super(kvt, DEFAULT_MESSAGE);
    }

    public RetryTransactionException(KVTransaction kvt, Throwable cause) {
        super(kvt, DEFAULT_MESSAGE, cause);
    }

    public RetryTransactionException(KVTransaction kvt, String message) {
        super(kvt, message);
    }

    public RetryTransactionException(KVTransaction kvt, String message, Throwable cause) {
        super(kvt, message, cause);
    }

    @Override
    public RetryTransactionException duplicate() {
        return (RetryTransactionException)super.duplicate();
    }
}