rocksdb-native 0.0.0 → 0.0.2

package/vendor/rocksdb/java/src/main/java/org/rocksdb/TransactionDB.java

@@ -1,401 +0,0 @@
-// Copyright (c) 2011-present, Facebook, Inc.  All rights reserved.
-//  This source code is licensed under both the GPLv2 (found in the
-//  COPYING file in the root directory) and Apache 2.0 License
-//  (found in the LICENSE.Apache file in the root directory).
-
-package org.rocksdb;
-
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Map;
-
-/**
- * Database with Transaction support
- */
-public class TransactionDB extends RocksDB
-    implements TransactionalDB<TransactionOptions> {
-
-  private TransactionDBOptions transactionDbOptions_;
-
-  /**
-   * Private constructor.
-   *
-   * @param nativeHandle The native handle of the C++ TransactionDB object
-   */
-  private TransactionDB(final long nativeHandle) {
-    super(nativeHandle);
-  }
-
-  /**
-   * Open a TransactionDB, similar to {@link RocksDB#open(Options, String)}.
-   *
-   * @param options {@link org.rocksdb.Options} instance.
-   * @param transactionDbOptions {@link org.rocksdb.TransactionDBOptions}
-   *     instance.
-   * @param path the path to the rocksdb.
-   *
-   * @return a {@link TransactionDB} instance on success, null if the specified
-   *     {@link TransactionDB} can not be opened.
-   *
-   * @throws RocksDBException if an error occurs whilst opening the database.
-   */
-  public static TransactionDB open(final Options options,
-      final TransactionDBOptions transactionDbOptions, final String path)
-      throws RocksDBException {
-    final TransactionDB tdb = new TransactionDB(open(options.nativeHandle_,
-        transactionDbOptions.nativeHandle_, path));
-
-    // when non-default Options is used, keeping an Options reference
-    // in RocksDB can prevent Java to GC during the life-time of
-    // the currently-created RocksDB.
-    tdb.storeOptionsInstance(options);
-    tdb.storeTransactionDbOptions(transactionDbOptions);
-
-    return tdb;
-  }
-
-  /**
-   * Open a TransactionDB, similar to
-   * {@link RocksDB#open(DBOptions, String, List, List)}.
-   *
-   * @param dbOptions {@link org.rocksdb.DBOptions} instance.
-   * @param transactionDbOptions {@link org.rocksdb.TransactionDBOptions}
-   *     instance.
-   * @param path the path to the rocksdb.
-   * @param columnFamilyDescriptors list of column family descriptors
-   * @param columnFamilyHandles will be filled with ColumnFamilyHandle instances
-   *
-   * @return a {@link TransactionDB} instance on success, null if the specified
-   *     {@link TransactionDB} can not be opened.
-   *
-   * @throws RocksDBException if an error occurs whilst opening the database.
-   */
-  public static TransactionDB open(final DBOptions dbOptions,
-      final TransactionDBOptions transactionDbOptions,
-      final String path,
-      final List<ColumnFamilyDescriptor> columnFamilyDescriptors,
-      final List<ColumnFamilyHandle> columnFamilyHandles)
-      throws RocksDBException {
-
-    final byte[][] cfNames = new byte[columnFamilyDescriptors.size()][];
-    final long[] cfOptionHandles = new long[columnFamilyDescriptors.size()];
-    for (int i = 0; i < columnFamilyDescriptors.size(); i++) {
-      final ColumnFamilyDescriptor cfDescriptor = columnFamilyDescriptors
-          .get(i);
-      cfNames[i] = cfDescriptor.getName();
-      cfOptionHandles[i] = cfDescriptor.getOptions().nativeHandle_;
-    }
-
-    final long[] handles = open(dbOptions.nativeHandle_,
-        transactionDbOptions.nativeHandle_, path, cfNames, cfOptionHandles);
-    final TransactionDB tdb = new TransactionDB(handles[0]);
-
-    // when non-default Options is used, keeping an Options reference
-    // in RocksDB can prevent Java to GC during the life-time of
-    // the currently-created RocksDB.
-    tdb.storeOptionsInstance(dbOptions);
-    tdb.storeTransactionDbOptions(transactionDbOptions);
-
-    for (int i = 1; i < handles.length; i++) {
-      columnFamilyHandles.add(new ColumnFamilyHandle(tdb, handles[i]));
-    }
-
-    return tdb;
-  }
-
-  /**
-   * This is similar to {@link #close()} except that it
-   * throws an exception if any error occurs.
-   * <p>
-   * This will not fsync the WAL files.
-   * If syncing is required, the caller must first call {@link #syncWal()}
-   * or {@link #write(WriteOptions, WriteBatch)} using an empty write batch
-   * with {@link WriteOptions#setSync(boolean)} set to true.
-   * <p>
-   * See also {@link #close()}.
-   *
-   * @throws RocksDBException if an error occurs whilst closing.
-   */
-  public void closeE() throws RocksDBException {
-    if (owningHandle_.compareAndSet(true, false)) {
-      try {
-        closeDatabase(nativeHandle_);
-      } finally {
-        disposeInternal();
-      }
-    }
-  }
-
-  /**
-   * This is similar to {@link #closeE()} except that it
-   * silently ignores any errors.
-   * <p>
-   * This will not fsync the WAL files.
-   * If syncing is required, the caller must first call {@link #syncWal()}
-   * or {@link #write(WriteOptions, WriteBatch)} using an empty write batch
-   * with {@link WriteOptions#setSync(boolean)} set to true.
-   * <p>
-   * See also {@link #close()}.
-   */
-  @Override
-  public void close() {
-    if (owningHandle_.compareAndSet(true, false)) {
-      try {
-        closeDatabase(nativeHandle_);
-      } catch (final RocksDBException e) {
-        // silently ignore the error report
-      } finally {
-        disposeInternal();
-      }
-    }
-  }
-
-  @Override
-  public Transaction beginTransaction(final WriteOptions writeOptions) {
-    return new Transaction(this, beginTransaction(nativeHandle_,
-        writeOptions.nativeHandle_));
-  }
-
-  @Override
-  public Transaction beginTransaction(final WriteOptions writeOptions,
-      final TransactionOptions transactionOptions) {
-    return new Transaction(this, beginTransaction(nativeHandle_,
-        writeOptions.nativeHandle_, transactionOptions.nativeHandle_));
-  }
-
-  // TODO(AR) consider having beingTransaction(... oldTransaction) set a
-  // reference count inside Transaction, so that we can always call
-  // Transaction#close but the object is only disposed when there are as many
-  // closes as beginTransaction. Makes the try-with-resources paradigm easier for
-  // java developers
-
-  @Override
-  public Transaction beginTransaction(final WriteOptions writeOptions,
-      final Transaction oldTransaction) {
-    final long jtxnHandle = beginTransaction_withOld(nativeHandle_,
-        writeOptions.nativeHandle_, oldTransaction.nativeHandle_);
-
-    // RocksJava relies on the assumption that
-    // we do not allocate a new Transaction object
-    // when providing an old_txn
-    assert(jtxnHandle == oldTransaction.nativeHandle_);
-
-    return oldTransaction;
-  }
-
-  @Override
-  public Transaction beginTransaction(final WriteOptions writeOptions,
-      final TransactionOptions transactionOptions,
-      final Transaction oldTransaction) {
-    final long jtxn_handle = beginTransaction_withOld(nativeHandle_,
-        writeOptions.nativeHandle_, transactionOptions.nativeHandle_,
-        oldTransaction.nativeHandle_);
-
-    // RocksJava relies on the assumption that
-    // we do not allocate a new Transaction object
-    // when providing an old_txn
-    assert(jtxn_handle == oldTransaction.nativeHandle_);
-
-    return oldTransaction;
-  }
-
-  public Transaction getTransactionByName(final String transactionName) {
-    final long jtxnHandle = getTransactionByName(nativeHandle_, transactionName);
-    if(jtxnHandle == 0) {
-      return null;
-    }
-
-    final Transaction txn = new Transaction(this, jtxnHandle);
-
-    // this instance doesn't own the underlying C++ object
-    txn.disOwnNativeHandle();
-
-    return txn;
-  }
-
-  public List<Transaction> getAllPreparedTransactions() {
-    final long[] jtxnHandles = getAllPreparedTransactions(nativeHandle_);
-
-    final List<Transaction> txns = new ArrayList<>();
-    for(final long jtxnHandle : jtxnHandles) {
-      final Transaction txn = new Transaction(this, jtxnHandle);
-
-      // this instance doesn't own the underlying C++ object
-      txn.disOwnNativeHandle();
-
-      txns.add(txn);
-    }
-    return txns;
-  }
-
-  public static class KeyLockInfo {
-    private final String key;
-    private final long[] transactionIDs;
-    private final boolean exclusive;
-
-    public KeyLockInfo(final String key, final long[] transactionIDs, final boolean exclusive) {
-      this.key = key;
-      this.transactionIDs = transactionIDs;
-      this.exclusive = exclusive;
-    }
-
-    /**
-     * Get the key.
-     *
-     * @return the key
-     */
-    public String getKey() {
-      return key;
-    }
-
-    /**
-     * Get the Transaction IDs.
-     *
-     * @return the Transaction IDs.
-     */
-    public long[] getTransactionIDs() {
-      return transactionIDs;
-    }
-
-    /**
-     * Get the Lock status.
-     *
-     * @return true if the lock is exclusive, false if the lock is shared.
-     */
-    public boolean isExclusive() {
-      return exclusive;
-    }
-  }
-
-  /**
-   * Returns map of all locks held.
-   *
-   * @return a map of all the locks held.
-   */
-  public Map<Long, KeyLockInfo> getLockStatusData() {
-    return getLockStatusData(nativeHandle_);
-  }
-
-  /**
-   * Called from C++ native method {@link #getDeadlockInfoBuffer(long)}
-   * to construct a DeadlockInfo object.
-   *
-   * @param transactionID The transaction id
-   * @param columnFamilyId The id of the {@link ColumnFamilyHandle}
-   * @param waitingKey the key that we are waiting on
-   * @param exclusive true if the lock is exclusive, false if the lock is shared
-   *
-   * @return The waiting transactions
-   */
-  private DeadlockInfo newDeadlockInfo(
-      final long transactionID, final long columnFamilyId,
-      final String waitingKey, final boolean exclusive) {
-    return new DeadlockInfo(transactionID, columnFamilyId,
-        waitingKey, exclusive);
-  }
-
-  public static class DeadlockInfo {
-    private final long transactionID;
-    private final long columnFamilyId;
-    private final String waitingKey;
-    private final boolean exclusive;
-
-    private DeadlockInfo(final long transactionID, final long columnFamilyId,
-      final String waitingKey, final boolean exclusive) {
-      this.transactionID = transactionID;
-      this.columnFamilyId = columnFamilyId;
-      this.waitingKey = waitingKey;
-      this.exclusive = exclusive;
-    }
-
-    /**
-     * Get the Transaction ID.
-     *
-     * @return the transaction ID
-     */
-    public long getTransactionID() {
-      return transactionID;
-    }
-
-    /**
-     * Get the Column Family ID.
-     *
-     * @return The column family ID
-     */
-    public long getColumnFamilyId() {
-      return columnFamilyId;
-    }
-
-    /**
-     * Get the key that we are waiting on.
-     *
-     * @return the key that we are waiting on
-     */
-    public String getWaitingKey() {
-      return waitingKey;
-    }
-
-    /**
-     * Get the Lock status.
-     *
-     * @return true if the lock is exclusive, false if the lock is shared.
-     */
-    public boolean isExclusive() {
-      return exclusive;
-    }
-  }
-
-  public static class DeadlockPath {
-    final DeadlockInfo[] path;
-    final boolean limitExceeded;
-
-    public DeadlockPath(final DeadlockInfo[] path, final boolean limitExceeded) {
-      this.path = path;
-      this.limitExceeded = limitExceeded;
-    }
-
-    public boolean isEmpty() {
-      return path.length == 0 && !limitExceeded;
-    }
-  }
-
-  public DeadlockPath[] getDeadlockInfoBuffer() {
-    return getDeadlockInfoBuffer(nativeHandle_);
-  }
-
-  public void setDeadlockInfoBufferSize(final int targetSize) {
-    setDeadlockInfoBufferSize(nativeHandle_, targetSize);
-  }
-
-  private void storeTransactionDbOptions(
-      final TransactionDBOptions transactionDbOptions) {
-    this.transactionDbOptions_ = transactionDbOptions;
-  }
-
-  @Override protected final native void disposeInternal(final long handle);
-
-  private static native long open(final long optionsHandle,
-      final long transactionDbOptionsHandle, final String path)
-      throws RocksDBException;
-  private static native long[] open(final long dbOptionsHandle,
-      final long transactionDbOptionsHandle, final String path,
-      final byte[][] columnFamilyNames, final long[] columnFamilyOptions);
-  private static native void closeDatabase(final long handle) throws RocksDBException;
-  private native long beginTransaction(final long handle,
-      final long writeOptionsHandle);
-  private native long beginTransaction(final long handle,
-      final long writeOptionsHandle, final long transactionOptionsHandle);
-  private native long beginTransaction_withOld(final long handle,
-      final long writeOptionsHandle, final long oldTransactionHandle);
-  private native long beginTransaction_withOld(final long handle,
-      final long writeOptionsHandle, final long transactionOptionsHandle,
-      final long oldTransactionHandle);
-  private native long getTransactionByName(final long handle,
-      final String name);
-  private native long[] getAllPreparedTransactions(final long handle);
-  private native Map<Long, KeyLockInfo> getLockStatusData(
-      final long handle);
-  private native DeadlockPath[] getDeadlockInfoBuffer(final long handle);
-  private native void setDeadlockInfoBufferSize(final long handle,
-      final int targetSize);
-}

package/vendor/rocksdb/java/src/main/java/org/rocksdb/TransactionDBOptions.java

@@ -1,216 +0,0 @@
-// Copyright (c) 2011-present, Facebook, Inc.  All rights reserved.
-//  This source code is licensed under both the GPLv2 (found in the
-//  COPYING file in the root directory) and Apache 2.0 License
-//  (found in the LICENSE.Apache file in the root directory).
-
-package org.rocksdb;
-
-public class TransactionDBOptions extends RocksObject {
-
-  public TransactionDBOptions() {
-    super(newTransactionDBOptions());
-  }
-
-  /**
-   * Specifies the maximum number of keys that can be locked at the same time
-   * per column family.
-   * <p>
-   * If the number of locked keys is greater than {@code #getMaxNumLocks()},
-   * transaction writes (or GetForUpdate) will return an error.
-   *
-   * @return The maximum number of keys that can be locked
-   */
-  public long getMaxNumLocks() {
-    assert(isOwningHandle());
-    return getMaxNumLocks(nativeHandle_);
-  }
-
-  /**
-   * Specifies the maximum number of keys that can be locked at the same time
-   * per column family.
-   * <p>
-   * If the number of locked keys is greater than {@link #getMaxNumLocks()},
-   * transaction writes (or GetForUpdate) will return an error.
-   *
-   * @param maxNumLocks The maximum number of keys that can be locked;
-   *     If this value is not positive, no limit will be enforced.
-   *
-   * @return this TransactionDBOptions instance
-   */
-  public TransactionDBOptions setMaxNumLocks(final long maxNumLocks) {
-    assert(isOwningHandle());
-    setMaxNumLocks(nativeHandle_, maxNumLocks);
-    return this;
-  }
-
-  /**
-   * The number of sub-tables per lock table (per column family)
-   *
-   * @return The number of sub-tables
-   */
-  public long getNumStripes() {
-    assert(isOwningHandle());
-    return getNumStripes(nativeHandle_);
-  }
-
-  /**
-   * Increasing this value will increase the concurrency by dividing the lock
-   * table (per column family) into more sub-tables, each with their own
-   * separate mutex.
-   * <p>
-   * Default: 16
-   *
-   * @param numStripes The number of sub-tables
-   *
-   * @return this TransactionDBOptions instance
-   */
-  public TransactionDBOptions setNumStripes(final long numStripes) {
-    assert(isOwningHandle());
-    setNumStripes(nativeHandle_, numStripes);
-    return this;
-  }
-
-  /**
-   * The default wait timeout in milliseconds when
-   * a transaction attempts to lock a key if not specified by
-   * {@link TransactionOptions#setLockTimeout(long)}
-   *
-   * If 0, no waiting is done if a lock cannot instantly be acquired.
-   * If negative, there is no timeout.
-   *
-   * @return the default wait timeout in milliseconds
-   */
-  public long getTransactionLockTimeout() {
-    assert(isOwningHandle());
-    return getTransactionLockTimeout(nativeHandle_);
-  }
-
-  /**
-   * If positive, specifies the default wait timeout in milliseconds when
-   * a transaction attempts to lock a key if not specified by
-   * {@link TransactionOptions#setLockTimeout(long)}
-   *
-   * If 0, no waiting is done if a lock cannot instantly be acquired.
-   * If negative, there is no timeout. Not using a timeout is not recommended
-   * as it can lead to deadlocks.  Currently, there is no deadlock-detection to
-   * recover from a deadlock.
-   * <p>
-   * Default: 1000
-   *
-   * @param transactionLockTimeout the default wait timeout in milliseconds
-   *
-   * @return this TransactionDBOptions instance
-   */
-  public TransactionDBOptions setTransactionLockTimeout(
-      final long transactionLockTimeout) {
-    assert(isOwningHandle());
-    setTransactionLockTimeout(nativeHandle_, transactionLockTimeout);
-    return this;
-  }
-
-  /**
-   * The wait timeout in milliseconds when writing a key
-   * OUTSIDE of a transaction (ie by calling {@link RocksDB#put},
-   * {@link RocksDB#merge}, {@link RocksDB#delete} or {@link RocksDB#write}
-   * directly).
-   * <p>
-   * If 0, no waiting is done if a lock cannot instantly be acquired.
-   * If negative, there is no timeout and will block indefinitely when acquiring
-   * a lock.
-   *
-   * @return the timeout in milliseconds when writing a key OUTSIDE of a
-   *     transaction
-   */
-  public long getDefaultLockTimeout() {
-    assert(isOwningHandle());
-    return getDefaultLockTimeout(nativeHandle_);
-  }
-
-  /**
-   * If positive, specifies the wait timeout in milliseconds when writing a key
-   * OUTSIDE of a transaction (ie by calling {@link RocksDB#put},
-   * {@link RocksDB#merge}, {@link RocksDB#delete} or {@link RocksDB#write}
-   * directly).
-   * <p>
-   * If 0, no waiting is done if a lock cannot instantly be acquired.
-   * If negative, there is no timeout and will block indefinitely when acquiring
-   * a lock.
-   * <p>
-   * Not using a timeout can lead to deadlocks. Currently, there
-   * is no deadlock-detection to recover from a deadlock.  While DB writes
-   * cannot deadlock with other DB writes, they can deadlock with a transaction.
-   * A negative timeout should only be used if all transactions have a small
-   * expiration set.
-   * <p>
-   * Default: 1000
-   *
-   * @param defaultLockTimeout the timeout in milliseconds when writing a key
-   *     OUTSIDE of a transaction
-   * @return this TransactionDBOptions instance
-   */
-  public TransactionDBOptions setDefaultLockTimeout(final long defaultLockTimeout) {
-    assert (isOwningHandle());
-    setDefaultLockTimeout(nativeHandle_, defaultLockTimeout);
-    return this;
-  }
-
-//  /**
-//   * If set, the {@link TransactionDB} will use this implementation of a mutex
-//   * and condition variable for all transaction locking instead of the default
-//   * mutex/condvar implementation.
-//   *
-//   * @param transactionDbMutexFactory the mutex factory for the transactions
-//   *
-//   * @return this TransactionDBOptions instance
-//   */
-//  public TransactionDBOptions setCustomMutexFactory(
-//      final TransactionDBMutexFactory transactionDbMutexFactory) {
-//
-//  }
-
-  /**
-   * The policy for when to write the data into the DB. The default policy is to
-   * write only the committed data {@link TxnDBWritePolicy#WRITE_COMMITTED}.
-   * The data could be written before the commit phase. The DB then needs to
-   * provide the mechanisms to tell apart committed from uncommitted data.
-   *
-   * @return The write policy.
-   */
-  public TxnDBWritePolicy getWritePolicy() {
-    assert(isOwningHandle());
-    return TxnDBWritePolicy.getTxnDBWritePolicy(getWritePolicy(nativeHandle_));
-  }
-
-  /**
-   * The policy for when to write the data into the DB. The default policy is to
-   * write only the committed data {@link TxnDBWritePolicy#WRITE_COMMITTED}.
-   * The data could be written before the commit phase. The DB then needs to
-   * provide the mechanisms to tell apart committed from uncommitted data.
-   *
-   * @param writePolicy The write policy.
-   *
-   * @return this TransactionDBOptions instance
-   */
-  public TransactionDBOptions setWritePolicy(
-      final TxnDBWritePolicy writePolicy) {
-    assert(isOwningHandle());
-    setWritePolicy(nativeHandle_, writePolicy.getValue());
-    return this;
-  }
-
-  private static native long newTransactionDBOptions();
-  private native long getMaxNumLocks(final long handle);
-  private native void setMaxNumLocks(final long handle,
-      final long maxNumLocks);
-  private native long getNumStripes(final long handle);
-  private native void setNumStripes(final long handle, final long numStripes);
-  private native long getTransactionLockTimeout(final long handle);
-  private native void setTransactionLockTimeout(final long handle,
-      final long transactionLockTimeout);
-  private native long getDefaultLockTimeout(final long handle);
-  private native void setDefaultLockTimeout(final long handle,
-      final long transactionLockTimeout);
-  private native byte getWritePolicy(final long handle);
-  private native void setWritePolicy(final long handle, final byte writePolicy);
-  @Override protected final native void disposeInternal(final long handle);
-}