rocksdb-native 0.0.0 → 0.0.1

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

@@ -1,73 +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;
-
-/**
- * Bloom filter policy that uses a bloom filter with approximately
- * the specified number of bits per key.
- *
- * <p>
- * Note: if you are using a custom comparator that ignores some parts
- * of the keys being compared, you must not use this {@code BloomFilter}
- * and must provide your own FilterPolicy that also ignores the
- * corresponding parts of the keys. For example, if the comparator
- * ignores trailing spaces, it would be incorrect to use a
- * FilterPolicy (like {@code BloomFilter}) that does not ignore
- * trailing spaces in keys.</p>
- */
-public class BloomFilter extends Filter {
-
-  private static final double DEFAULT_BITS_PER_KEY = 10.0;
-
-  /**
-   * BloomFilter constructor
-   *
-   * <p>
-   * Callers must delete the result after any database that is using the
-   * result has been closed.</p>
-   */
-  public BloomFilter() {
-    this(DEFAULT_BITS_PER_KEY);
-  }
-
-  /**
-   * BloomFilter constructor
-   *
-   * <p>
-   * bits_per_key: bits per key in bloom filter. A good value for bits_per_key
-   * is 9.9, which yields a filter with ~ 1% false positive rate.
-   * </p>
-   * <p>
-   * Callers must delete the result after any database that is using the
-   * result has been closed.</p>
-   *
-   * @param bitsPerKey number of bits to use
-   */
-  public BloomFilter(final double bitsPerKey) {
-    super(createNewBloomFilter(bitsPerKey));
-  }
-
-  /**
-   * BloomFilter constructor
-   *
-   * <p>
-   * bits_per_key: bits per key in bloom filter. A good value for bits_per_key
-   * is 10, which yields a filter with ~ 1% false positive rate.
-   * <p><strong>default bits_per_key</strong>: 10</p>
-   *
-   * <p>
-   * Callers must delete the result after any database that is using the
-   * result has been closed.</p>
-   *
-   * @param bitsPerKey number of bits to use
-   * @param IGNORED_useBlockBasedMode obsolete, ignored parameter
-   */
-  public BloomFilter(final double bitsPerKey, final boolean IGNORED_useBlockBasedMode) {
-    this(bitsPerKey);
-  }
-
-  private static native long createNewBloomFilter(final double bitsKeyKey);
-}

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

@@ -1,20 +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;
-
-/**
- * Builtin RocksDB comparators
- *
- * <ol>
- *   <li>BYTEWISE_COMPARATOR - Sorts all keys in ascending bytewise
- *   order.</li>
- *   <li>REVERSE_BYTEWISE_COMPARATOR - Sorts all keys in descending bytewise
- *   order</li>
- * </ol>
- */
-public enum BuiltinComparator {
-  BYTEWISE_COMPARATOR, REVERSE_BYTEWISE_COMPARATOR
-}

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

@@ -1,50 +0,0 @@
-//  Copyright (c) Meta Platforms, Inc. and affiliates.
-//
-//  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.nio.ByteBuffer;
-import java.util.List;
-
-/**
- * A ByteBuffer containing fetched data, together with a result for the fetch
- * and the total size of the object fetched.
- * <p>
- * Used for the individual results of
- * {@link RocksDB#multiGetByteBuffers(List, List)}
- * {@link RocksDB#multiGetByteBuffers(List, List, List)}
- * {@link RocksDB#multiGetByteBuffers(ReadOptions, List, List)}
- * {@link RocksDB#multiGetByteBuffers(ReadOptions, List, List, List)}
- */
-public class ByteBufferGetStatus {
-  public final Status status;
-  public final int requiredSize;
-  public final ByteBuffer value;
-
-  /**
-   * Constructor used for success status, when the value is contained in the buffer
-   *
-   * @param status the status of the request to fetch into the buffer
-   * @param requiredSize the size of the data, which may be bigger than the buffer
-   * @param value the buffer containing as much of the value as fits
-   */
-  ByteBufferGetStatus(final Status status, final int requiredSize, final ByteBuffer value) {
-    this.status = status;
-    this.requiredSize = requiredSize;
-    this.value = value;
-  }
-
-  /**
-   * Constructor used for a failure status, when no value is filled in
-   *
-   * @param status the status of the request to fetch into the buffer
-   */
-  ByteBufferGetStatus(final Status status) {
-    this.status = status;
-    this.requiredSize = 0;
-    this.value = null;
-  }
-}

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

@@ -1,40 +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 abstract class Cache extends RocksObject {
-  protected Cache(final long nativeHandle) {
-    super(nativeHandle);
-  }
-
-  /**
-   * Returns the memory size for the entries
-   * residing in cache.
-   *
-   * @return cache usage size.
-   *
-   */
-  public long getUsage() {
-    assert (isOwningHandle());
-    return getUsage(this.nativeHandle_);
-  }
-
-  /**
-   * Returns the memory size for the entries
-   * being pinned in cache.
-   *
-   * @return cache pinned usage size.
-   *
-   */
-  public long getPinnedUsage() {
-    assert (isOwningHandle());
-    return getPinnedUsage(this.nativeHandle_);
-  }
-
-  private static native long getUsage(final long handle);
-  private static native long getPinnedUsage(final long handle);
-}

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

@@ -1,20 +0,0 @@
-//  Copyright (c) 2017-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;
-
-/**
- * Just a Java wrapper around CassandraCompactionFilter implemented in C++
- */
-public class CassandraCompactionFilter
-    extends AbstractCompactionFilter<Slice> {
-  public CassandraCompactionFilter(
-      final boolean purgeTtlOnExpiration, final int gcGracePeriodInSeconds) {
-    super(createNewCassandraCompactionFilter0(purgeTtlOnExpiration, gcGracePeriodInSeconds));
-  }
-
-  private static native long createNewCassandraCompactionFilter0(
-      boolean purgeTtlOnExpiration, int gcGracePeriodInSeconds);
-}

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

@@ -1,25 +0,0 @@
-//  Copyright (c) 2017-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;
-
-/**
- * CassandraValueMergeOperator is a merge operator that merges two cassandra wide column
- * values.
- */
-public class CassandraValueMergeOperator extends MergeOperator {
-  public CassandraValueMergeOperator(final int gcGracePeriodInSeconds) {
-    super(newSharedCassandraValueMergeOperator(gcGracePeriodInSeconds, 0));
-  }
-
-  public CassandraValueMergeOperator(final int gcGracePeriodInSeconds, final int operandsLimit) {
-    super(newSharedCassandraValueMergeOperator(gcGracePeriodInSeconds, operandsLimit));
-  }
-
-  private static native long newSharedCassandraValueMergeOperator(
-      int gcGracePeriodInSeconds, int limit);
-
-  @Override protected final native void disposeInternal(final long handle);
-}

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

@@ -1,62 +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;
-
-/**
- * Provides Checkpoint functionality. Checkpoints
- * provide persistent snapshots of RocksDB databases.
- */
-public class Checkpoint extends RocksObject {
-
-  /**
-   * Creates a Checkpoint object to be used for creating open-able
-   * snapshots.
-   *
-   * @param db {@link RocksDB} instance.
-   * @return a Checkpoint instance.
-   *
-   * @throws java.lang.IllegalArgumentException if {@link RocksDB}
-   *     instance is null.
-   * @throws java.lang.IllegalStateException if {@link RocksDB}
-   *     instance is not initialized.
-   */
-  public static Checkpoint create(final RocksDB db) {
-    if (db == null) {
-      throw new IllegalArgumentException(
-          "RocksDB instance shall not be null.");
-    } else if (!db.isOwningHandle()) {
-      throw new IllegalStateException(
-          "RocksDB instance must be initialized.");
-    }
-    return new Checkpoint(db);
-  }
-
-  /**
-   * <p>Builds an open-able snapshot of RocksDB on the same disk, which
-   * accepts an output directory on the same disk, and under the directory
-   * (1) hard-linked SST files pointing to existing live SST files
-   * (2) a copied manifest files and other files</p>
-   *
-   * @param checkpointPath path to the folder where the snapshot is going
-   *     to be stored.
-   * @throws RocksDBException thrown if an error occurs within the native
-   *     part of the library.
-   */
-  public void createCheckpoint(final String checkpointPath)
-      throws RocksDBException {
-    createCheckpoint(nativeHandle_, checkpointPath);
-  }
-
-  private Checkpoint(final RocksDB db) {
-    super(newCheckpoint(db.nativeHandle_));
-  }
-
-  private static native long newCheckpoint(long dbHandle);
-  @Override protected final native void disposeInternal(final long handle);
-
-  private native void createCheckpoint(long handle, String checkpointPath)
-      throws RocksDBException;
-}

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

@@ -1,45 +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;
-
-/**
- * Checksum types used in conjunction with BlockBasedTable.
- */
-public enum ChecksumType {
-  /**
-   * Not implemented yet.
-   */
-  kNoChecksum((byte) 0),
-  /**
-   * CRC32 Checksum
-   */
-  kCRC32c((byte) 1),
-  /**
-   * XX Hash
-   */
-  kxxHash((byte) 2),
-  /**
-   * XX Hash 64
-   */
-  kxxHash64((byte) 3),
-
-  kXXH3((byte) 4);
-
-  /**
-   * Returns the byte value of the enumerations value
-   *
-   * @return byte representation
-   */
-  public byte getValue() {
-    return value_;
-  }
-
-  private ChecksumType(final byte value) {
-    value_ = value;
-  }
-
-  private final byte value_;
-}

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

@@ -1,59 +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;
-
-/**
- * Similar to {@link LRUCache}, but based on the CLOCK algorithm with
- * better concurrent performance in some cases
- */
-public class ClockCache extends Cache {
-
-  /**
-   * Create a new cache with a fixed size capacity.
-   *
-   * @param capacity The fixed size capacity of the cache
-   */
-  public ClockCache(final long capacity) {
-    super(newClockCache(capacity, -1, false));
-  }
-
-  /**
-   * Create a new cache with a fixed size capacity. The cache is sharded
-   * to 2^numShardBits shards, by hash of the key. The total capacity
-   * is divided and evenly assigned to each shard.
-   * numShardBits = -1 means it is automatically determined: every shard
-   * will be at least 512KB and number of shard bits will not exceed 6.
-   *
-   * @param capacity The fixed size capacity of the cache
-   * @param numShardBits The cache is sharded to 2^numShardBits shards,
-   *     by hash of the key
-   */
-  public ClockCache(final long capacity, final int numShardBits) {
-    super(newClockCache(capacity, numShardBits, false));
-  }
-
-  /**
-   * Create a new cache with a fixed size capacity. The cache is sharded
-   * to 2^numShardBits shards, by hash of the key. The total capacity
-   * is divided and evenly assigned to each shard. If strictCapacityLimit
-   * is set, insert to the cache will fail when cache is full.
-   * numShardBits = -1 means it is automatically determined: every shard
-   * will be at least 512KB and number of shard bits will not exceed 6.
-   *
-   * @param capacity The fixed size capacity of the cache
-   * @param numShardBits The cache is sharded to 2^numShardBits shards,
-   *     by hash of the key
-   * @param strictCapacityLimit insert to the cache will fail when cache is full
-   */
-  public ClockCache(final long capacity, final int numShardBits,
-      final boolean strictCapacityLimit) {
-    super(newClockCache(capacity, numShardBits, strictCapacityLimit));
-  }
-
-  private static native long newClockCache(
-      final long capacity, final int numShardBits, final boolean strictCapacityLimit);
-  @Override protected final native void disposeInternal(final long handle);
-}

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

@@ -1,84 +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.Arrays;
-
-/**
- * <p>Describes a column family with a
- * name and respective Options.</p>
- */
-public class ColumnFamilyDescriptor {
-
-  /**
-   * <p>Creates a new Column Family using a name and default
-   * options,</p>
-   *
-   * @param columnFamilyName name of column family.
-   * @since 3.10.0
-   */
-  public ColumnFamilyDescriptor(final byte[] columnFamilyName) {
-    this(columnFamilyName, new ColumnFamilyOptions());
-  }
-
-  /**
-   * <p>Creates a new Column Family using a name and custom
-   * options.</p>
-   *
-   * @param columnFamilyName name of column family.
-   * @param columnFamilyOptions options to be used with
-   *     column family.
-   * @since 3.10.0
-   */
-  public ColumnFamilyDescriptor(final byte[] columnFamilyName,
-                                final ColumnFamilyOptions columnFamilyOptions) {
-    columnFamilyName_ = columnFamilyName;
-    columnFamilyOptions_ = columnFamilyOptions;
-  }
-
-  /**
-   * Retrieve name of column family.
-   *
-   * @return column family name.
-   * @since 3.10.0
-   */
-  public byte[] getName() {
-    return columnFamilyName_;
-  }
-
-  /**
-   * Retrieve assigned options instance.
-   *
-   * @return Options instance assigned to this instance.
-   */
-  public ColumnFamilyOptions getOptions() {
-    return columnFamilyOptions_;
-  }
-
-  @Override
-  public boolean equals(final Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-
-    final ColumnFamilyDescriptor that = (ColumnFamilyDescriptor) o;
-    return Arrays.equals(columnFamilyName_, that.columnFamilyName_)
-            && columnFamilyOptions_.nativeHandle_ == that.columnFamilyOptions_.nativeHandle_;
-  }
-
-  @Override
-  public int hashCode() {
-    int result = (int) (columnFamilyOptions_.nativeHandle_ ^ (columnFamilyOptions_.nativeHandle_ >>> 32));
-    result = 31 * result + Arrays.hashCode(columnFamilyName_);
-    return result;
-  }
-
-  private final byte[] columnFamilyName_;
-  private final ColumnFamilyOptions columnFamilyOptions_;
-}

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

@@ -1,151 +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.Arrays;
-import java.util.Objects;
-
-/**
- * ColumnFamilyHandle class to hold handles to underlying rocksdb
- * ColumnFamily Pointers.
- */
-public class ColumnFamilyHandle extends RocksObject {
-  /**
-   * Constructs column family Java object, which operates on underlying native object.
-   *
-   * @param rocksDB db instance associated with this column family
-   * @param nativeHandle native handle to underlying native ColumnFamily object
-   */
-  ColumnFamilyHandle(final RocksDB rocksDB,
-      final long nativeHandle) {
-    super(nativeHandle);
-    // rocksDB must point to a valid RocksDB instance;
-    assert(rocksDB != null);
-    // ColumnFamilyHandle must hold a reference to the related RocksDB instance
-    // to guarantee that while a GC cycle starts ColumnFamilyHandle instances
-    // are freed prior to RocksDB instances.
-    this.rocksDB_ = rocksDB;
-  }
-
-  /**
-   * Constructor called only from JNI.
-   * <p>
-   * NOTE: we are producing an additional Java Object here to represent the underlying native C++
-   * ColumnFamilyHandle object. The underlying object is not owned by ourselves. The Java API user
-   * likely already had a ColumnFamilyHandle Java object which owns the underlying C++ object, as
-   * they will have been presented it when they opened the database or added a Column Family.
-   * <p>
-   *
-   * TODO(AR) - Potentially a better design would be to cache the active Java Column Family Objects
-   * in RocksDB, and return the same Java Object instead of instantiating a new one here. This could
-   * also help us to improve the Java API semantics for Java users. See for example
-   * <a href="https://github.com/facebook/rocksdb/issues/2687">...</a>.
-   *
-   * @param nativeHandle native handle to the column family.
-   */
-  ColumnFamilyHandle(final long nativeHandle) {
-    super(nativeHandle);
-    rocksDB_ = null;
-    disOwnNativeHandle();
-  }
-
-  /**
-   * Gets the name of the Column Family.
-   *
-   * @return The name of the Column Family.
-   *
-   * @throws RocksDBException if an error occurs whilst retrieving the name.
-   */
-  public byte[] getName() throws RocksDBException {
-    assert(isOwningHandle() || isDefaultColumnFamily());
-    return getName(nativeHandle_);
-  }
-
-  /**
-   * Gets the ID of the Column Family.
-   *
-   * @return the ID of the Column Family.
-   */
-  public int getID() {
-    assert(isOwningHandle() || isDefaultColumnFamily());
-    return getID(nativeHandle_);
-  }
-
-  /**
-   * Gets the up-to-date descriptor of the column family
-   * associated with this handle. Since it fills "*desc" with the up-to-date
-   * information, this call might internally lock and release DB mutex to
-   * access the up-to-date CF options. In addition, all the pointer-typed
-   * options cannot be referenced any longer than the original options exist.
-   * <p>
-   * Note that this function is not supported in RocksDBLite.
-   *
-   * @return the up-to-date descriptor.
-   *
-   * @throws RocksDBException if an error occurs whilst retrieving the
-   *     descriptor.
-   */
-  public ColumnFamilyDescriptor getDescriptor() throws RocksDBException {
-    assert(isOwningHandle() || isDefaultColumnFamily());
-    return getDescriptor(nativeHandle_);
-  }
-
-  @Override
-  public boolean equals(final Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-
-    final ColumnFamilyHandle that = (ColumnFamilyHandle) o;
-    try {
-      return rocksDB_.nativeHandle_ == that.rocksDB_.nativeHandle_ &&
-          getID() == that.getID() &&
-          Arrays.equals(getName(), that.getName());
-    } catch (final RocksDBException e) {
-      throw new RuntimeException("Cannot compare column family handles", e);
-    }
-  }
-
-  @Override
-  public int hashCode() {
-    try {
-      int result = Objects.hash(getID(), rocksDB_.nativeHandle_);
-      result = 31 * result + Arrays.hashCode(getName());
-      return result;
-    } catch (final RocksDBException e) {
-      throw new RuntimeException("Cannot calculate hash code of column family handle", e);
-    }
-  }
-
-  protected boolean isDefaultColumnFamily() {
-    return nativeHandle_ == rocksDB_.getDefaultColumnFamily().nativeHandle_;
-  }
-
-  /**
-   * <p>Deletes underlying C++ iterator pointer.</p>
-   *
-   * <p>Note: the underlying handle can only be safely deleted if the RocksDB
-   * instance related to a certain ColumnFamilyHandle is still valid and
-   * initialized. Therefore {@code disposeInternal()} checks if the RocksDB is
-   * initialized before freeing the native handle.</p>
-   */
-  @Override
-  protected void disposeInternal() {
-    if(rocksDB_.isOwningHandle()) {
-      disposeInternal(nativeHandle_);
-    }
-  }
-
-  private native byte[] getName(final long handle) throws RocksDBException;
-  private native int getID(final long handle);
-  private native ColumnFamilyDescriptor getDescriptor(final long handle) throws RocksDBException;
-  @Override protected final native void disposeInternal(final long handle);
-
-  private final RocksDB rocksDB_;
-}