rocksdb-native 0.0.0 → 0.0.1

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

@@ -1,224 +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.List;
-
-/**
- * Database with Transaction support.
- */
-public class OptimisticTransactionDB extends RocksDB
-    implements TransactionalDB<OptimisticTransactionOptions> {
-
-  /**
-   * Private constructor.
-   *
-   * @param nativeHandle The native handle of the C++ OptimisticTransactionDB
-   *     object
-   */
-  private OptimisticTransactionDB(final long nativeHandle) {
-    super(nativeHandle);
-  }
-
-  /**
-   * Open an OptimisticTransactionDB similar to
-   * {@link RocksDB#open(Options, String)}.
-   *
-   * @param options {@link org.rocksdb.Options} instance.
-   * @param path the path to the rocksdb.
-   *
-   * @return a {@link OptimisticTransactionDB} instance on success, null if the
-   * specified {@link OptimisticTransactionDB} can not be opened.
-   *
-   * @throws RocksDBException if an error occurs whilst opening the database.
-   */
-  public static OptimisticTransactionDB open(final Options options,
-      final String path) throws RocksDBException {
-    final OptimisticTransactionDB otdb = new OptimisticTransactionDB(open(
-        options.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.
-    otdb.storeOptionsInstance(options);
-
-    return otdb;
-  }
-
-  /**
-   * Open an OptimisticTransactionDB similar to
-   * {@link RocksDB#open(DBOptions, String, List, List)}.
-   *
-   * @param dbOptions {@link org.rocksdb.DBOptions} 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 OptimisticTransactionDB} instance on success, null if the
-   *     specified {@link OptimisticTransactionDB} can not be opened.
-   *
-   * @throws RocksDBException if an error occurs whilst opening the database.
-   */
-  public static OptimisticTransactionDB open(final DBOptions dbOptions,
-      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_, path, cfNames,
-        cfOptionHandles);
-    final OptimisticTransactionDB otdb =
-        new OptimisticTransactionDB(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.
-    otdb.storeOptionsInstance(dbOptions);
-
-    for (int i = 1; i < handles.length; i++) {
-      columnFamilyHandles.add(new ColumnFamilyHandle(otdb, handles[i]));
-    }
-
-    return otdb;
-  }
-
-  /**
-   * 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 OptimisticTransactionOptions optimisticTransactionOptions) {
-    return new Transaction(this, beginTransaction(nativeHandle_,
-        writeOptions.nativeHandle_,
-        optimisticTransactionOptions.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 jtxn_handle = 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(jtxn_handle == oldTransaction.nativeHandle_);
-
-    return oldTransaction;
-  }
-
-  @Override
-  public Transaction beginTransaction(final WriteOptions writeOptions,
-      final OptimisticTransactionOptions optimisticTransactionOptions,
-      final Transaction oldTransaction) {
-    final long jtxn_handle = beginTransaction_withOld(nativeHandle_,
-        writeOptions.nativeHandle_, optimisticTransactionOptions.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;
-  }
-
-  /**
-   * Get the underlying database that was opened.
-   *
-   * @return The underlying database that was opened.
-   */
-  public RocksDB getBaseDB() {
-    final RocksDB db = new RocksDB(getBaseDB(nativeHandle_));
-    db.disOwnNativeHandle();
-    return db;
-  }
-
-  @Override protected final native void disposeInternal(final long handle);
-
-  protected static native long open(final long optionsHandle,
-      final String path) throws RocksDBException;
-  protected static native long[] open(final long handle, 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 optimisticTransactionOptionsHandle);
-  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 optimisticTransactionOptionsHandle,
-      final long oldTransactionHandle);
-  private native long getBaseDB(final long handle);
-}

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

@@ -1,53 +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 OptimisticTransactionOptions extends RocksObject
-    implements TransactionalOptions<OptimisticTransactionOptions> {
-
-  public OptimisticTransactionOptions() {
-    super(newOptimisticTransactionOptions());
-  }
-
-  @Override
-  public boolean isSetSnapshot() {
-    assert(isOwningHandle());
-    return isSetSnapshot(nativeHandle_);
-  }
-
-  @Override
-  public OptimisticTransactionOptions setSetSnapshot(
-      final boolean setSnapshot) {
-    assert(isOwningHandle());
-    setSetSnapshot(nativeHandle_, setSnapshot);
-    return this;
-  }
-
-  /**
-   * Should be set if the DB has a non-default comparator.
-   * See comment in
-   * {@link WriteBatchWithIndex#WriteBatchWithIndex(AbstractComparator, int, boolean)}
-   * constructor.
-   *
-   * @param comparator The comparator to use for the transaction.
-   *
-   * @return this OptimisticTransactionOptions instance
-   */
-  public OptimisticTransactionOptions setComparator(
-      final AbstractComparator comparator) {
-    assert(isOwningHandle());
-    setComparator(nativeHandle_, comparator.nativeHandle_);
-    return this;
-  }
-
-  private static native long newOptimisticTransactionOptions();
-  private native boolean isSetSnapshot(final long handle);
-  private native void setSetSnapshot(final long handle,
-      final boolean setSnapshot);
-  private native void setComparator(final long handle,
-      final long comparatorHandle);
-  @Override protected final native void disposeInternal(final long handle);
-}

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

@@ -1,261 +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.Objects;
-
-public class OptionString {
-  private static final char kvPairSeparator = ';';
-  private static final char kvSeparator = '=';
-  private static final char complexValueBegin = '{';
-  private static final char complexValueEnd = '}';
-  private static final char wrappedValueBegin = '{';
-  private static final char wrappedValueEnd = '}';
-  private static final char arrayValueSeparator = ':';
-
-  static class Value {
-    final List<String> list;
-    final List<Entry> complex;
-
-    public Value(final List<String> list, final List<Entry> complex) {
-      this.list = list;
-      this.complex = complex;
-    }
-
-    public boolean isList() {
-      return (this.list != null && this.complex == null);
-    }
-
-    public static Value fromList(final List<String> list) {
-      return new Value(list, null);
-    }
-
-    public static Value fromComplex(final List<Entry> complex) {
-      return new Value(null, complex);
-    }
-
-    public String toString() {
-      final StringBuilder sb = new StringBuilder();
-      if (isList()) {
-        for (final String item : list) {
-          sb.append(item).append(arrayValueSeparator);
-        }
-        // remove the final separator
-        if (sb.length() > 0)
-          sb.delete(sb.length() - 1, sb.length());
-      } else {
-        sb.append('[');
-        for (final Entry entry : complex) {
-          sb.append(entry.toString()).append(';');
-        }
-        sb.append(']');
-      }
-      return sb.toString();
-    }
-  }
-
-  static class Entry {
-    public final String key;
-    public final Value value;
-
-    private Entry(final String key, final Value value) {
-      this.key = key;
-      this.value = value;
-    }
-
-    public String toString() {
-      return "" + key + "=" + value;
-    }
-  }
-
-  static class Parser {
-    static class Exception extends RuntimeException {
-      public Exception(final String s) {
-        super(s);
-      }
-    }
-
-    final String str;
-    final StringBuilder sb;
-
-    private Parser(final String str) {
-      this.str = str;
-      this.sb = new StringBuilder(str);
-    }
-
-    private void exception(final String message) {
-      final int pos = str.length() - sb.length();
-      final int before = Math.min(pos, 64);
-      final int after = Math.min(64, str.length() - pos);
-      final String here =
-          str.substring(pos - before, pos) + "__*HERE*__" + str.substring(pos, pos + after);
-
-      throw new Parser.Exception(message + " at [" + here + "]");
-    }
-
-    private void skipWhite() {
-      while (sb.length() > 0 && Character.isWhitespace(sb.charAt(0))) {
-        sb.delete(0, 1);
-      }
-    }
-
-    private char first() {
-      if (sb.length() == 0)
-        exception("Unexpected end of input");
-      return sb.charAt(0);
-    }
-
-    private char next() {
-      if (sb.length() == 0)
-        exception("Unexpected end of input");
-      final char c = sb.charAt(0);
-      sb.delete(0, 1);
-      return c;
-    }
-
-    private boolean hasNext() {
-      return (sb.length() > 0);
-    }
-
-    private boolean is(final char c) {
-      return (sb.length() > 0 && sb.charAt(0) == c);
-    }
-
-    private boolean isKeyChar() {
-      if (!hasNext())
-        return false;
-      final char c = first();
-      return (Character.isAlphabetic(c) || Character.isDigit(c) || "_".indexOf(c) != -1);
-    }
-
-    private boolean isValueChar() {
-      if (!hasNext())
-        return false;
-      final char c = first();
-      return (Character.isAlphabetic(c) || Character.isDigit(c) || "_-+.[]".indexOf(c) != -1);
-    }
-
-    private String parseKey() {
-      final StringBuilder sbKey = new StringBuilder();
-      sbKey.append(next());
-      while (isKeyChar()) {
-        sbKey.append(next());
-      }
-
-      return sbKey.toString();
-    }
-
-    private String parseSimpleValue() {
-      if (is(wrappedValueBegin)) {
-        next();
-        final String result = parseSimpleValue();
-        if (!is(wrappedValueEnd)) {
-          exception("Expected to end a wrapped value with " + wrappedValueEnd);
-        }
-        next();
-
-        return result;
-      } else {
-        final StringBuilder sbValue = new StringBuilder();
-        while (isValueChar()) sbValue.append(next());
-
-        return sbValue.toString();
-      }
-    }
-
-    private List<String> parseList() {
-      final List<String> list = new ArrayList<>(1);
-      while (true) {
-        list.add(parseSimpleValue());
-        if (!is(arrayValueSeparator))
-          break;
-
-        next();
-      }
-
-      return list;
-    }
-
-    private Entry parseOption() {
-      skipWhite();
-      if (!isKeyChar()) {
-        exception("No valid key character(s) for key in key=value ");
-      }
-      final String key = parseKey();
-      skipWhite();
-      if (is(kvSeparator)) {
-        next();
-      } else {
-        exception("Expected = separating key and value");
-      }
-      skipWhite();
-      final Value value = parseValue();
-      return new Entry(key, value);
-    }
-
-    private Value parseValue() {
-      skipWhite();
-      if (is(complexValueBegin)) {
-        next();
-        skipWhite();
-        final Value value = Value.fromComplex(parseComplex());
-        skipWhite();
-        if (is(complexValueEnd)) {
-          next();
-          skipWhite();
-        } else {
-          exception("Expected } ending complex value");
-        }
-        return value;
-      } else if (isValueChar()) {
-        return Value.fromList(parseList());
-      } else if (is(kvPairSeparator)) {
-        // e.g. empty vector embedded in a struct option looks like
-        // struct_opt = {vector_opt=;...}
-        final List<String> entries = new ArrayList<>();
-        return Value.fromList(entries);
-      }
-
-      exception("No valid value character(s) for value in key=value");
-      return null;
-    }
-
-    private List<Entry> parseComplex() {
-      final List<Entry> entries = new ArrayList<>();
-
-      skipWhite();
-      if (hasNext()) {
-        entries.add(parseOption());
-        skipWhite();
-        while (is(kvPairSeparator)) {
-          next();
-          skipWhite();
-          if (!isKeyChar()) {
-            // the separator was a terminator
-            break;
-          }
-          entries.add(parseOption());
-          skipWhite();
-        }
-      }
-      return entries;
-    }
-
-    public static List<Entry> parse(final String str) {
-      Objects.requireNonNull(str);
-
-      final Parser parser = new Parser(str);
-      final List<Entry> result = parser.parseComplex();
-      if (parser.hasNext()) {
-        parser.exception("Unexpected end of parsing ");
-      }
-
-      return result;
-    }
-  }
-}