rocksdb-native 0.0.0 → 0.0.1

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

@@ -1,55 +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;
-
-/**
- * IndexType used in conjunction with BlockBasedTable.
- */
-public enum IndexType {
-  /**
-   * A space efficient index block that is optimized for
-   * binary-search-based index.
-   */
-  kBinarySearch((byte) 0),
-  /**
-   * The hash index, if enabled, will do the hash lookup when
-   * {@code Options.prefix_extractor} is provided.
-   */
-  kHashSearch((byte) 1),
-  /**
-   * A two-level index implementation. Both levels are binary search indexes.
-   */
-  kTwoLevelIndexSearch((byte) 2),
-  /**
-   * Like {@link #kBinarySearch}, but index also contains first key of each block.
-   * This allows iterators to defer reading the block until it's actually
-   * needed. May significantly reduce read amplification of short range scans.
-   * Without it, iterator seek usually reads one block from each level-0 file
-   * and from each level, which may be expensive.
-   * Works best in combination with:
-   *   - IndexShorteningMode::kNoShortening,
-   *   - custom FlushBlockPolicy to cut blocks at some meaningful boundaries,
-   *     e.g. when prefix changes.
-   * Makes the index significantly bigger (2x or more), especially when keys
-   * are long.
-   */
-  kBinarySearchWithFirstKey((byte) 3);
-
-  /**
-   * Returns the byte value of the enumerations value
-   *
-   * @return byte representation
-   */
-  public byte getValue() {
-    return value_;
-  }
-
-  IndexType(final byte value) {
-    value_ = value;
-  }
-
-  private final byte value_;
-}

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

@@ -1,49 +0,0 @@
-// Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
-package org.rocksdb;
-
-/**
- * RocksDB log levels.
- */
-public enum InfoLogLevel {
-  DEBUG_LEVEL((byte)0),
-  INFO_LEVEL((byte)1),
-  WARN_LEVEL((byte)2),
-  ERROR_LEVEL((byte)3),
-  FATAL_LEVEL((byte)4),
-  HEADER_LEVEL((byte)5),
-  NUM_INFO_LOG_LEVELS((byte)6);
-
-  private final byte value_;
-
-  InfoLogLevel(final byte value) {
-    value_ = value;
-  }
-
-  /**
-   * Returns the byte value of the enumerations value
-   *
-   * @return byte representation
-   */
-  public byte getValue() {
-    return value_;
-  }
-
-  /**
-   * Get InfoLogLevel by byte value.
-   *
-   * @param value byte representation of InfoLogLevel.
-   *
-   * @return {@link org.rocksdb.InfoLogLevel} instance.
-   * @throws java.lang.IllegalArgumentException if an invalid
-   *     value is provided.
-   */
-  public static InfoLogLevel getInfoLogLevel(final byte value) {
-    for (final InfoLogLevel infoLogLevel : InfoLogLevel.values()) {
-      if (infoLogLevel.getValue() == value) {
-        return infoLogLevel;
-      }
-    }
-    throw new IllegalArgumentException(
-        "Illegal value provided for InfoLogLevel.");
-  }
-}

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

@@ -1,227 +0,0 @@
-package org.rocksdb;
-// 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).
-
-import java.util.List;
-
-/**
- * IngestExternalFileOptions is used by
- * {@link RocksDB#ingestExternalFile(ColumnFamilyHandle, List, IngestExternalFileOptions)}.
- */
-public class IngestExternalFileOptions extends RocksObject {
-
-  public IngestExternalFileOptions() {
-    super(newIngestExternalFileOptions());
-  }
-
-  /**
-   * @param moveFiles {@link #setMoveFiles(boolean)}
-   * @param snapshotConsistency {@link #setSnapshotConsistency(boolean)}
-   * @param allowGlobalSeqNo {@link #setAllowGlobalSeqNo(boolean)}
-   * @param allowBlockingFlush {@link #setAllowBlockingFlush(boolean)}
-   */
-  public IngestExternalFileOptions(final boolean moveFiles,
-      final boolean snapshotConsistency, final boolean allowGlobalSeqNo,
-      final boolean allowBlockingFlush) {
-    super(newIngestExternalFileOptions(moveFiles, snapshotConsistency,
-        allowGlobalSeqNo, allowBlockingFlush));
-  }
-
-  /**
-   * Can be set to true to move the files instead of copying them.
-   *
-   * @return true if files will be moved
-   */
-  public boolean moveFiles() {
-    return moveFiles(nativeHandle_);
-  }
-
-  /**
-   * Can be set to true to move the files instead of copying them.
-   *
-   * @param moveFiles true if files should be moved instead of copied
-   *
-   * @return the reference to the current IngestExternalFileOptions.
-   */
-  public IngestExternalFileOptions setMoveFiles(final boolean moveFiles) {
-    setMoveFiles(nativeHandle_, moveFiles);
-    return this;
-  }
-
-  /**
-   * If set to false, an ingested file keys could appear in existing snapshots
-   * that where created before the file was ingested.
-   *
-   * @return true if snapshot consistency is assured
-   */
-  public boolean snapshotConsistency() {
-    return snapshotConsistency(nativeHandle_);
-  }
-
-  /**
-   * If set to false, an ingested file keys could appear in existing snapshots
-   * that where created before the file was ingested.
-   *
-   * @param snapshotConsistency true if snapshot consistency is required
-   *
-   * @return the reference to the current IngestExternalFileOptions.
-   */
-  public IngestExternalFileOptions setSnapshotConsistency(
-      final boolean snapshotConsistency) {
-    setSnapshotConsistency(nativeHandle_, snapshotConsistency);
-    return this;
-  }
-
-  /**
-   * If set to false, {@link RocksDB#ingestExternalFile(ColumnFamilyHandle, List, IngestExternalFileOptions)}
-   * will fail if the file key range overlaps with existing keys or tombstones in the DB.
-   *
-   * @return true if global seq numbers are assured
-   */
-  public boolean allowGlobalSeqNo() {
-    return allowGlobalSeqNo(nativeHandle_);
-  }
-
-  /**
-   * If set to false, {@link RocksDB#ingestExternalFile(ColumnFamilyHandle, List, IngestExternalFileOptions)}
-   * will fail if the file key range overlaps with existing keys or tombstones in the DB.
-   *
-   * @param allowGlobalSeqNo true if global seq numbers are required
-   *
-   * @return the reference to the current IngestExternalFileOptions.
-   */
-  public IngestExternalFileOptions setAllowGlobalSeqNo(
-      final boolean allowGlobalSeqNo) {
-    setAllowGlobalSeqNo(nativeHandle_, allowGlobalSeqNo);
-    return this;
-  }
-
-  /**
-   * If set to false and the file key range overlaps with the memtable key range
-   * (memtable flush required), IngestExternalFile will fail.
-   *
-   * @return true if blocking flushes may occur
-   */
-  public boolean allowBlockingFlush() {
-    return allowBlockingFlush(nativeHandle_);
-  }
-
-  /**
-   * If set to false and the file key range overlaps with the memtable key range
-   * (memtable flush required), IngestExternalFile will fail.
-   *
-   * @param allowBlockingFlush true if blocking flushes are allowed
-   *
-   * @return the reference to the current IngestExternalFileOptions.
-   */
-  public IngestExternalFileOptions setAllowBlockingFlush(
-      final boolean allowBlockingFlush) {
-    setAllowBlockingFlush(nativeHandle_, allowBlockingFlush);
-    return this;
-  }
-
-  /**
-   * Returns true if duplicate keys in the file being ingested are
-   * to be skipped rather than overwriting existing data under that key.
-   *
-   * @return true if duplicate keys in the file being ingested are to be
-   *     skipped, false otherwise.
-   */
-  public boolean ingestBehind() {
-    return ingestBehind(nativeHandle_);
-  }
-
-  /**
-   * Set to true if you would like duplicate keys in the file being ingested
-   * to be skipped rather than overwriting existing data under that key.
-   * <p>
-   * Usecase: back-fill of some historical data in the database without
-   * over-writing existing newer version of data.
-   * <p>
-   * This option could only be used if the DB has been running
-   * with DBOptions#allowIngestBehind() == true since the dawn of time.
-   * <p>
-   * All files will be ingested at the bottommost level with seqno=0.
-   * <p>
-   * Default: false
-   *
-   * @param ingestBehind true if you would like duplicate keys in the file being
-   *     ingested to be skipped.
-   *
-   * @return the reference to the current IngestExternalFileOptions.
-   */
-  public IngestExternalFileOptions setIngestBehind(final boolean ingestBehind) {
-    setIngestBehind(nativeHandle_, ingestBehind);
-    return this;
-  }
-
-  /**
-   * Returns true write if the global_seqno is written to a given offset
-   * in the external SST file for backward compatibility.
-   * <p>
-   * See {@link #setWriteGlobalSeqno(boolean)}.
-   *
-   * @return true if the global_seqno is written to a given offset,
-   *     false otherwise.
-   */
-  public boolean writeGlobalSeqno() {
-    return writeGlobalSeqno(nativeHandle_);
-  }
-
-  /**
-   * Set to true if you would like to write the global_seqno to a given offset
-   * in the external SST file for backward compatibility.
-   * <p>
-   * Older versions of RocksDB write the global_seqno to a given offset within
-   * the ingested SST files, and new versions of RocksDB do not.
-   * <p>
-   * If you ingest an external SST using new version of RocksDB and would like
-   * to be able to downgrade to an older version of RocksDB, you should set
-   * {@link #writeGlobalSeqno()} to true.
-   * <p>
-   * If your service is just starting to use the new RocksDB, we recommend that
-   * you set this option to false, which brings two benefits:
-   *    1. No extra random write for global_seqno during ingestion.
-   *    2. Without writing external SST file, it's possible to do checksum.
-   * <p>
-   * We have a plan to set this option to false by default in the future.
-   * <p>
-   * Default: true
-   *
-   * @param writeGlobalSeqno true to write the gloal_seqno to a given offset,
-   *     false otherwise
-   *
-   * @return the reference to the current IngestExternalFileOptions.
-   */
-  public IngestExternalFileOptions setWriteGlobalSeqno(
-      final boolean writeGlobalSeqno) {
-    setWriteGlobalSeqno(nativeHandle_, writeGlobalSeqno);
-    return this;
-  }
-
-  private static native long newIngestExternalFileOptions();
-  private static native long newIngestExternalFileOptions(final boolean moveFiles,
-      final boolean snapshotConsistency, final boolean allowGlobalSeqNo,
-      final boolean allowBlockingFlush);
-  @Override protected final native void disposeInternal(final long handle);
-
-  private native boolean moveFiles(final long handle);
-  private native void setMoveFiles(final long handle, final boolean move_files);
-  private native boolean snapshotConsistency(final long handle);
-  private native void setSnapshotConsistency(final long handle,
-      final boolean snapshotConsistency);
-  private native boolean allowGlobalSeqNo(final long handle);
-  private native void setAllowGlobalSeqNo(final long handle,
-      final boolean allowGloablSeqNo);
-  private native boolean allowBlockingFlush(final long handle);
-  private native void setAllowBlockingFlush(final long handle,
-      final boolean allowBlockingFlush);
-  private native boolean ingestBehind(final long handle);
-  private native void setIngestBehind(final long handle,
-      final boolean ingestBehind);
-  private native boolean writeGlobalSeqno(final long handle);
-  private native void setWriteGlobalSeqno(final long handle,
-      final boolean writeGlobalSeqNo);
-}

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

@@ -1,35 +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.Objects;
-
-public class KeyMayExist {
-  @Override
-  public boolean equals(final Object o) {
-    if (this == o)
-      return true;
-    if (o == null || getClass() != o.getClass())
-      return false;
-    final KeyMayExist that = (KeyMayExist) o;
-    return (valueLength == that.valueLength && exists == that.exists);
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(exists, valueLength);
-  }
-
-  public enum KeyMayExistEnum { kNotExist, kExistsWithoutValue, kExistsWithValue }
-
-  public KeyMayExist(final KeyMayExistEnum exists, final int valueLength) {
-    this.exists = exists;
-    this.valueLength = valueLength;
-  }
-
-  public final KeyMayExistEnum exists;
-  public final int valueLength;
-}

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

@@ -1,106 +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;
-
-/**
- * Least Recently Used Cache
- */
-public class LRUCache extends Cache {
-
-  /**
-   * Create a new cache with a fixed size capacity
-   *
-   * @param capacity The fixed size capacity of the cache
-   */
-  public LRUCache(final long capacity) {
-    this(capacity, -1, false, 0.0, 0.0);
-  }
-
-  /**
-   * 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 LRUCache(final long capacity, final int numShardBits) {
-    super(newLRUCache(capacity, numShardBits, false, 0.0, 0.0));
-  }
-
-  /**
-   * 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 LRUCache(final long capacity, final int numShardBits,
-                  final boolean strictCapacityLimit) {
-    super(newLRUCache(capacity, numShardBits, strictCapacityLimit, 0.0, 0.0));
-  }
-
-  /**
-   * 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. User can also
-   * set percentage of the cache reserves for high priority entries via
-   * highPriPoolRatio.
-   * 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
-   * @param highPriPoolRatio percentage of the cache reserves for high priority
-   *     entries
-   */
-  public LRUCache(final long capacity, final int numShardBits, final boolean strictCapacityLimit,
-      final double highPriPoolRatio) {
-    super(newLRUCache(capacity, numShardBits, strictCapacityLimit, highPriPoolRatio, 0.0));
-  }
-
-  /**
-   * 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. User can also
-   * set percentage of the cache reserves for high priority entries and low
-   * priority entries via highPriPoolRatio and lowPriPoolRatio.
-   * 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
-   * @param highPriPoolRatio percentage of the cache reserves for high priority
-   *     entries
-   * @param lowPriPoolRatio percentage of the cache reserves for low priority
-   *     entries
-   */
-  public LRUCache(final long capacity, final int numShardBits, final boolean strictCapacityLimit,
-      final double highPriPoolRatio, final double lowPriPoolRatio) {
-    super(newLRUCache(
-        capacity, numShardBits, strictCapacityLimit, highPriPoolRatio, lowPriPoolRatio));
-  }
-
-  private static native long newLRUCache(final long capacity, final int numShardBits,
-      final boolean strictCapacityLimit, final double highPriPoolRatio,
-      final double lowPriPoolRatio);
-  @Override protected final native void disposeInternal(final long handle);
-}

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

@@ -1,56 +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.List;
-
-/**
- * The metadata that describes a level.
- */
-public class LevelMetaData {
-  private final int level;
-  private final long size;
-  private final SstFileMetaData[] files;
-
-  /**
-   * Called from JNI C++
-   */
-  private LevelMetaData(final int level, final long size,
-      final SstFileMetaData[] files) {
-    this.level = level;
-    this.size = size;
-    this.files = files;
-  }
-
-  /**
-   * The level which this meta data describes.
-   *
-   * @return the level
-   */
-  public int level() {
-    return level;
-  }
-
-  /**
-   * The size of this level in bytes, which is equal to the sum of
-   * the file size of its {@link #files()}.
-   *
-   * @return the size
-   */
-  public long size() {
-    return size;
-  }
-
-  /**
-   * The metadata of all sst files in this level.
-   *
-   * @return the metadata of the files
-   */
-  public List<SstFileMetaData> files() {
-    return Arrays.asList(files);
-  }
-}

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

@@ -1,55 +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;
-
-/**
- * The full set of metadata associated with each SST file.
- */
-public class LiveFileMetaData extends SstFileMetaData {
-  private final byte[] columnFamilyName;
-  private final int level;
-
-  /**
-   * Called from JNI C++
-   */
-  private LiveFileMetaData(
-      final byte[] columnFamilyName,
-      final int level,
-      final String fileName,
-      final String path,
-      final long size,
-      final long smallestSeqno,
-      final long largestSeqno,
-      final byte[] smallestKey,
-      final byte[] largestKey,
-      final long numReadsSampled,
-      final boolean beingCompacted,
-      final long numEntries,
-      final long numDeletions) {
-    super(fileName, path, size, smallestSeqno, largestSeqno, smallestKey,
-        largestKey, numReadsSampled, beingCompacted, numEntries, numDeletions);
-    this.columnFamilyName = columnFamilyName;
-    this.level = level;
-  }
-
-  /**
-   * Get the name of the column family.
-   *
-   * @return the name of the column family
-   */
-  public byte[] columnFamilyName() {
-    return columnFamilyName;
-  }
-
-  /**
-   * Get the level at which this file resides.
-   *
-   * @return the level at which the file resides.
-   */
-  public int level() {
-    return level;
-  }
-}

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

@@ -1,75 +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 LogFile {
-  private final String pathName;
-  private final long logNumber;
-  private final WalFileType type;
-  private final long startSequence;
-  private final long sizeFileBytes;
-
-  /**
-   * Called from JNI C++
-   */
-  private LogFile(final String pathName, final long logNumber,
-      final byte walFileTypeValue, final long startSequence,
-      final long sizeFileBytes) {
-    this.pathName = pathName;
-    this.logNumber = logNumber;
-    this.type = WalFileType.fromValue(walFileTypeValue);
-    this.startSequence = startSequence;
-    this.sizeFileBytes = sizeFileBytes;
-  }
-
-  /**
-   * Returns log file's pathname relative to the main db dir
-   * Eg. For a live-log-file = /000003.log
-   * For an archived-log-file = /archive/000003.log
-   *
-   * @return log file's pathname
-   */
-  public String pathName() {
-    return pathName;
-  }
-
-  /**
-   * Primary identifier for log file.
-   * This is directly proportional to creation time of the log file
-   *
-   * @return the log number
-   */
-  public long logNumber() {
-    return logNumber;
-  }
-
-  /**
-   * Log file can be either alive or archived.
-   *
-   * @return the type of the log file.
-   */
-  public WalFileType type() {
-    return type;
-  }
-
-  /**
-   * Starting sequence number of writebatch written in this log file.
-   *
-   * @return the stating sequence number
-   */
-  public long startSequence() {
-    return startSequence;
-  }
-
-  /**
-   * Size of log file on disk in Bytes.
-   *
-   * @return size of log file
-   */
-  public long sizeFileBytes() {
-    return sizeFileBytes;
-  }
-}