rocksdb-native 0.0.0 → 0.0.1

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

@@ -1,55 +0,0 @@
-// Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
-package org.rocksdb;
-
-/**
- * Algorithm used to make a compaction request stop picking new files
- * into a single compaction run
- */
-public enum CompactionStopStyle {
-
-  /**
-   * Pick files of similar size
-   */
-  CompactionStopStyleSimilarSize((byte)0x0),
-
-  /**
-   * Total size of picked files > next file
-   */
-  CompactionStopStyleTotalSize((byte)0x1);
-
-
-  private final byte value;
-
-  CompactionStopStyle(final byte value) {
-    this.value = value;
-  }
-
-  /**
-   * Returns the byte value of the enumerations value
-   *
-   * @return byte representation
-   */
-  public byte getValue() {
-    return value;
-  }
-
-  /**
-   * Get CompactionStopStyle by byte value.
-   *
-   * @param value byte representation of CompactionStopStyle.
-   *
-   * @return {@link org.rocksdb.CompactionStopStyle} instance or null.
-   * @throws java.lang.IllegalArgumentException if an invalid
-   *     value is provided.
-   */
-  public static CompactionStopStyle getCompactionStopStyle(final byte value) {
-    for (final CompactionStopStyle compactionStopStyle :
-        CompactionStopStyle.values()) {
-      if (compactionStopStyle.getValue() == value){
-        return compactionStopStyle;
-      }
-    }
-    throw new IllegalArgumentException(
-        "Illegal value provided for CompactionStopStyle.");
-  }
-}

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

@@ -1,81 +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;
-
-/**
- * Enum CompactionStyle
- * <p>
- * RocksDB supports different styles of compaction. Available
- * compaction styles can be chosen using this enumeration.
- *
- * <ol>
- *   <li><strong>LEVEL</strong> - Level based Compaction style</li>
- *   <li><strong>UNIVERSAL</strong> - Universal Compaction Style is a
- *   compaction style, targeting the use cases requiring lower write
- *   amplification, trading off read amplification and space
- *   amplification.</li>
- *   <li><strong>FIFO</strong> - FIFO compaction style is the simplest
- *   compaction strategy. It is suited for keeping event log data with
- *   very low overhead (query log for example). It periodically deletes
- *   the old data, so it's basically a TTL compaction style.</li>
- *   <li><strong>NONE</strong> - Disable background compaction.
- *   Compaction jobs are submitted
- *   {@link RocksDB#compactFiles(CompactionOptions, ColumnFamilyHandle, List, int, int,
- * CompactionJobInfo)} ()}.</li>
- * </ol>
- *
- * @see <a
- * href="https://github.com/facebook/rocksdb/wiki/Universal-Compaction">
- * Universal Compaction</a>
- * @see <a
- * href="https://github.com/facebook/rocksdb/wiki/FIFO-compaction-style">
- * FIFO Compaction</a>
- */
-public enum CompactionStyle {
-  LEVEL((byte) 0x0),
-  UNIVERSAL((byte) 0x1),
-  FIFO((byte) 0x2),
-  NONE((byte) 0x3);
-
-  private final byte value;
-
-  CompactionStyle(final byte value) {
-    this.value = value;
-  }
-
-  /**
-   * Get the internal representation value.
-   *
-   * @return the internal representation value.
-   */
-  //TODO(AR) should be made package-private
-  public byte getValue() {
-    return value;
-  }
-
-  /**
-   * Get the Compaction style from the internal representation value.
-   *
-   * @param value the internal representation value.
-   *
-   * @return the Compaction style
-   *
-   * @throws IllegalArgumentException if the value does not match a
-   *     CompactionStyle
-   */
-  static CompactionStyle fromValue(final byte value)
-      throws IllegalArgumentException {
-    for (final CompactionStyle compactionStyle : CompactionStyle.values()) {
-      if (compactionStyle.value == value) {
-        return compactionStyle;
-      }
-    }
-    throw new IllegalArgumentException("Unknown value for CompactionStyle: "
-        + value);
-  }
-}

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

@@ -1,133 +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;
-
-/**
- * This class controls the behaviour
- * of Java implementations of
- * AbstractComparator
- * <p>
- * Note that dispose() must be called before a ComparatorOptions
- * instance becomes out-of-scope to release the allocated memory in C++.
- */
-public class ComparatorOptions extends RocksObject {
-  public ComparatorOptions() {
-    super(newComparatorOptions());
-  }
-
-  /**
-   * Get the synchronisation type used to guard the reused buffers.
-   * Only used if {@link #maxReusedBufferSize()} &gt; 0
-   * Default: {@link ReusedSynchronisationType#ADAPTIVE_MUTEX}
-   *
-   * @return the synchronisation type
-   */
-  public ReusedSynchronisationType reusedSynchronisationType() {
-    assert(isOwningHandle());
-    return ReusedSynchronisationType.getReusedSynchronisationType(
-        reusedSynchronisationType(nativeHandle_));
-  }
-
-  /**
-   * Set the synchronisation type used to guard the reused buffers.
-   * Only used if {@link #maxReusedBufferSize()} &gt; 0
-   * Default: {@link ReusedSynchronisationType#ADAPTIVE_MUTEX}
-   *
-   * @param reusedSynchronisationType the synchronisation type
-   *
-   * @return the reference to the current comparator options.
-   */
-  public ComparatorOptions setReusedSynchronisationType(
-      final ReusedSynchronisationType reusedSynchronisationType) {
-    assert (isOwningHandle());
-    setReusedSynchronisationType(nativeHandle_,
-        reusedSynchronisationType.getValue());
-    return this;
-  }
-
-  /**
-   * Indicates if a direct byte buffer (i.e. outside the normal
-   * garbage-collected heap) is used, as opposed to a non-direct byte buffer
-   * which is a wrapper around an on-heap byte[].
-   * <p>
-   * Default: true
-   *
-   * @return true if a direct byte buffer will be used, false otherwise
-   */
-  public boolean useDirectBuffer() {
-    assert(isOwningHandle());
-    return useDirectBuffer(nativeHandle_);
-  }
-
-  /**
-   * Controls whether a direct byte buffer (i.e. outside the normal
-   * garbage-collected heap) is used, as opposed to a non-direct byte buffer
-   * which is a wrapper around an on-heap byte[].
-   * <p>
-   * Default: true
-   *
-   * @param useDirectBuffer true if a direct byte buffer should be used,
-   *     false otherwise
-   * @return the reference to the current comparator options.
-   */
-  public ComparatorOptions setUseDirectBuffer(final boolean useDirectBuffer) {
-    assert(isOwningHandle());
-    setUseDirectBuffer(nativeHandle_, useDirectBuffer);
-    return this;
-  }
-
-  /**
-   * Maximum size of a buffer (in bytes) that will be reused.
-   * Comparators will use 5 of these buffers,
-   * so the retained memory size will be 5 * max_reused_buffer_size.
-   * When a buffer is needed for transferring data to a callback,
-   * if it requires less than {@code maxReuseBufferSize}, then an
-   * existing buffer will be reused, else a new buffer will be
-   * allocated just for that callback.
-   * <p>
-   * Default: 64 bytes
-   *
-   * @return the maximum size of a buffer which is reused,
-   *     or 0 if reuse is disabled
-   */
-  public int maxReusedBufferSize() {
-    assert(isOwningHandle());
-    return maxReusedBufferSize(nativeHandle_);
-  }
-
-  /**
-   * Sets the maximum size of a buffer (in bytes) that will be reused.
-   * Comparators will use 5 of these buffers,
-   * so the retained memory size will be 5 * max_reused_buffer_size.
-   * When a buffer is needed for transferring data to a callback,
-   * if it requires less than {@code maxReuseBufferSize}, then an
-   * existing buffer will be reused, else a new buffer will be
-   * allocated just for that callback.
-   * <p>
-   * Default: 64 bytes
-   *
-   * @param maxReusedBufferSize the maximum size for a buffer to reuse, or 0 to
-   *     disable reuse
-   *
-   * @return the maximum size of a buffer which is reused
-   */
-  public ComparatorOptions setMaxReusedBufferSize(final int maxReusedBufferSize) {
-    assert(isOwningHandle());
-    setMaxReusedBufferSize(nativeHandle_, maxReusedBufferSize);
-    return this;
-  }
-
-  private static native long newComparatorOptions();
-  private native byte reusedSynchronisationType(final long handle);
-  private native void setReusedSynchronisationType(final long handle,
-      final byte reusedSynchronisationType);
-  private native boolean useDirectBuffer(final long handle);
-  private native void setUseDirectBuffer(final long handle,
-      final boolean useDirectBuffer);
-  private native int maxReusedBufferSize(final long handle);
-  private native void setMaxReusedBufferSize(final long handle,
-      final int maxReuseBufferSize);
-  @Override protected final native void disposeInternal(final long handle);
-}

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

@@ -1,48 +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;
-
-enum ComparatorType {
-  JAVA_COMPARATOR((byte)0x0),
-  JAVA_NATIVE_COMPARATOR_WRAPPER((byte)0x1);
-
-  private final byte value;
-
-  ComparatorType(final byte value) {
-    this.value = value;
-  }
-
-  /**
-   * <p>Returns the byte value of the enumerations value.</p>
-   *
-   * @return byte representation
-   */
-  byte getValue() {
-    return value;
-  }
-
-  /**
-   * <p>Get the ComparatorType enumeration value by
-   * passing the byte identifier to this method.</p>
-   *
-   * @param byteIdentifier of ComparatorType.
-   *
-   * @return ComparatorType instance.
-   *
-   * @throws IllegalArgumentException if the comparator type for the byteIdentifier
-   *     cannot be found
-   */
-  static ComparatorType getComparatorType(final byte byteIdentifier) {
-    for (final ComparatorType comparatorType : ComparatorType.values()) {
-      if (comparatorType.getValue() == byteIdentifier) {
-        return comparatorType;
-      }
-    }
-
-    throw new IllegalArgumentException(
-        "Illegal value provided for ComparatorType.");
-  }
-}

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

@@ -1,150 +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;
-
-/**
- * Options for Compression
- */
-public class CompressionOptions extends RocksObject {
-
-  public CompressionOptions() {
-    super(newCompressionOptions());
-  }
-
-  public CompressionOptions setWindowBits(final int windowBits) {
-    setWindowBits(nativeHandle_, windowBits);
-    return this;
-  }
-
-  public int windowBits() {
-    return windowBits(nativeHandle_);
-  }
-
-  public CompressionOptions setLevel(final int level) {
-    setLevel(nativeHandle_, level);
-    return this;
-  }
-
-  public int level() {
-    return level(nativeHandle_);
-  }
-
-  public CompressionOptions setStrategy(final int strategy) {
-    setStrategy(nativeHandle_, strategy);
-    return this;
-  }
-
-  public int strategy() {
-    return strategy(nativeHandle_);
-  }
-
-  /**
-   * Maximum size of dictionary used to prime the compression library. Currently
-   * this dictionary will be constructed by sampling the first output file in a
-   * subcompaction when the target level is bottommost. This dictionary will be
-   * loaded into the compression library before compressing/uncompressing each
-   * data block of subsequent files in the subcompaction. Effectively, this
-   * improves compression ratios when there are repetitions across data blocks.
-   * <p>
-   * A value of 0 indicates the feature is disabled.
-   * <p>
-   * Default: 0.
-   *
-   * @param maxDictBytes Maximum bytes to use for the dictionary
-   *
-   * @return the reference to the current options
-   */
-  public CompressionOptions setMaxDictBytes(final int maxDictBytes) {
-    setMaxDictBytes(nativeHandle_, maxDictBytes);
-    return this;
-  }
-
-  /**
-   * Maximum size of dictionary used to prime the compression library.
-   *
-   * @return The maximum bytes to use for the dictionary
-   */
-  public int maxDictBytes() {
-    return maxDictBytes(nativeHandle_);
-  }
-
-  /**
-   * Maximum size of training data passed to zstd's dictionary trainer. Using
-   * zstd's dictionary trainer can achieve even better compression ratio
-   * improvements than using {@link #setMaxDictBytes(int)} alone.
-   * <p>
-   * The training data will be used to generate a dictionary
-   * of {@link #maxDictBytes()}.
-   * <p>
-   * Default: 0.
-   *
-   * @param zstdMaxTrainBytes Maximum bytes to use for training ZStd.
-   *
-   * @return the reference to the current options
-   */
-  public CompressionOptions setZStdMaxTrainBytes(final int zstdMaxTrainBytes) {
-    setZstdMaxTrainBytes(nativeHandle_, zstdMaxTrainBytes);
-    return this;
-  }
-
-  /**
-   * Maximum size of training data passed to zstd's dictionary trainer.
-   *
-   * @return Maximum bytes to use for training ZStd
-   */
-  public int zstdMaxTrainBytes() {
-    return zstdMaxTrainBytes(nativeHandle_);
-  }
-
-  /**
-   * When the compression options are set by the user, it will be set to "true".
-   * For bottommost_compression_opts, to enable it, user must set enabled=true.
-   * Otherwise, bottommost compression will use compression_opts as default
-   * compression options.
-   * <p>
-   * For compression_opts, if compression_opts.enabled=false, it is still
-   * used as compression options for compression process.
-   * <p>
-   * Default: false.
-   *
-   * @param enabled true to use these compression options
-   *     for the bottommost_compression_opts, false otherwise
-   *
-   * @return the reference to the current options
-   */
-  public CompressionOptions setEnabled(final boolean enabled) {
-    setEnabled(nativeHandle_, enabled);
-    return this;
-  }
-
-  /**
-   * Determine whether these compression options
-   * are used for the bottommost_compression_opts.
-   *
-   * @return true if these compression options are used
-   *     for the bottommost_compression_opts, false otherwise
-   */
-  public boolean enabled() {
-    return enabled(nativeHandle_);
-  }
-
-  private static native long newCompressionOptions();
-  @Override protected final native void disposeInternal(final long handle);
-
-  private native void setWindowBits(final long handle, final int windowBits);
-  private native int windowBits(final long handle);
-  private native void setLevel(final long handle, final int level);
-  private native int level(final long handle);
-  private native void setStrategy(final long handle, final int strategy);
-  private native int strategy(final long handle);
-  private native void setMaxDictBytes(final long handle, final int maxDictBytes);
-  private native int maxDictBytes(final long handle);
-  private native void setZstdMaxTrainBytes(final long handle,
-      final int zstdMaxTrainBytes);
-  private native int zstdMaxTrainBytes(final long handle);
-  private native void setEnabled(final long handle, final boolean enabled);
-  private native boolean enabled(final long handle);
-}

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

@@ -1,121 +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;
-
-/**
- * Enum CompressionType
- *
- * <p>DB contents are stored in a set of blocks, each of which holds a
- * sequence of key,value pairs. Each block may be compressed before
- * being stored in a file. The following enum describes which
- * compression method (if any) is used to compress a block.</p>
- */
-public enum CompressionType {
-  NO_COMPRESSION((byte) 0x0, null, "kNoCompression"),
-  SNAPPY_COMPRESSION((byte) 0x1, "snappy", "kSnappyCompression"),
-  ZLIB_COMPRESSION((byte) 0x2, "z", "kZlibCompression"),
-  BZLIB2_COMPRESSION((byte) 0x3, "bzip2", "kBZip2Compression"),
-  LZ4_COMPRESSION((byte) 0x4, "lz4", "kLZ4Compression"),
-  LZ4HC_COMPRESSION((byte) 0x5, "lz4hc", "kLZ4HCCompression"),
-  XPRESS_COMPRESSION((byte) 0x6, "xpress", "kXpressCompression"),
-  ZSTD_COMPRESSION((byte) 0x7, "zstd", "kZSTD"),
-  DISABLE_COMPRESSION_OPTION((byte) 0x7F, null, "kDisableCompressionOption");
-
-  /**
-   * <p>Get the CompressionType enumeration value by
-   * passing the library name to this method.</p>
-   *
-   * <p>If library cannot be found the enumeration
-   * value {@code NO_COMPRESSION} will be returned.</p>
-   *
-   * @param libraryName compression library name.
-   *
-   * @return CompressionType instance.
-   */
-  public static CompressionType getCompressionType(final String libraryName) {
-    if (libraryName != null) {
-      for (final CompressionType compressionType : CompressionType.values()) {
-        if (compressionType.getLibraryName() != null &&
-            compressionType.getLibraryName().equals(libraryName)) {
-          return compressionType;
-        }
-      }
-    }
-    return CompressionType.NO_COMPRESSION;
-  }
-
-  /**
-   * <p>Get the CompressionType enumeration value by
-   * passing the byte identifier to this method.</p>
-   *
-   * @param byteIdentifier of CompressionType.
-   *
-   * @return CompressionType instance.
-   *
-   * @throws IllegalArgumentException If CompressionType cannot be found for the
-   *   provided byteIdentifier
-   */
-  public static CompressionType getCompressionType(final byte byteIdentifier) {
-    for (final CompressionType compressionType : CompressionType.values()) {
-      if (compressionType.getValue() == byteIdentifier) {
-        return compressionType;
-      }
-    }
-
-    throw new IllegalArgumentException(
-        "Illegal value provided for CompressionType.");
-  }
-
-  /**
-   * <p>Get a CompressionType value based on the string key in the C++ options output.
-   * This gets used in support of getting options into Java from an options string,
-   * which is generated at the C++ level.
-   * </p>
-   *
-   * @param internalName the internal (C++) name by which the option is known.
-   *
-   * @return CompressionType instance (optional)
-   */
-  static CompressionType getFromInternal(final String internalName) {
-    for (final CompressionType compressionType : CompressionType.values()) {
-      if (compressionType.internalName_.equals(internalName)) {
-        return compressionType;
-      }
-    }
-
-    throw new IllegalArgumentException(
-        "Illegal internalName '" + internalName + " ' provided for CompressionType.");
-  }
-
-  /**
-   * <p>Returns the byte value of the enumerations value.</p>
-   *
-   * @return byte representation
-   */
-  public byte getValue() {
-    return value_;
-  }
-
-  /**
-   * <p>Returns the library name of the compression type
-   * identified by the enumeration value.</p>
-   *
-   * @return library name
-   */
-  public String getLibraryName() {
-    return libraryName_;
-  }
-
-  CompressionType(final byte value, final String libraryName, final String internalName) {
-    value_ = value;
-    libraryName_ = libraryName;
-    internalName_ = internalName;
-  }
-
-  private final byte value_;
-  private final String libraryName_;
-  private final String internalName_;
-}

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

@@ -1,44 +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;
-
-public abstract class ConcurrentTaskLimiter extends RocksObject {
-  protected ConcurrentTaskLimiter(final long nativeHandle) {
-    super(nativeHandle);
-  }
-
-  /**
-   * Returns a name that identifies this concurrent task limiter.
-   *
-   * @return Concurrent task limiter name.
-   */
-  public abstract String name();
-
-  /**
-   * Set max concurrent tasks.<br>
-   * limit = 0 means no new task allowed.<br>
-   * limit &lt; 0 means no limitation.
-   *
-   * @param maxOutstandinsTask max concurrent tasks.
-   * @return the reference to the current instance of ConcurrentTaskLimiter.
-   */
-  public abstract ConcurrentTaskLimiter setMaxOutstandingTask(final int maxOutstandinsTask);
-
-  /**
-   * Reset to unlimited max concurrent task.
-   *
-   * @return the reference to the current instance of ConcurrentTaskLimiter.
-   */
-  public abstract ConcurrentTaskLimiter resetMaxOutstandingTask();
-
-  /**
-   * Returns current outstanding task count.
-   *
-   * @return current outstanding task count.
-   */
-  public abstract int outstandingTask();
-}

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

@@ -1,48 +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;
-
-public class ConcurrentTaskLimiterImpl extends ConcurrentTaskLimiter {
-  public ConcurrentTaskLimiterImpl(final String name, final int maxOutstandingTask) {
-    super(newConcurrentTaskLimiterImpl0(name, maxOutstandingTask));
-  }
-
-  @Override
-  public String name() {
-    assert (isOwningHandle());
-    return name(nativeHandle_);
-  }
-
-  @Override
-  public ConcurrentTaskLimiter setMaxOutstandingTask(final int maxOutstandingTask) {
-    assert (isOwningHandle());
-    setMaxOutstandingTask(nativeHandle_, maxOutstandingTask);
-    return this;
-  }
-
-  @Override
-  public ConcurrentTaskLimiter resetMaxOutstandingTask() {
-    assert (isOwningHandle());
-    resetMaxOutstandingTask(nativeHandle_);
-    return this;
-  }
-
-  @Override
-  public int outstandingTask() {
-    assert (isOwningHandle());
-    return outstandingTask(nativeHandle_);
-  }
-
-  private static native long newConcurrentTaskLimiterImpl0(
-      final String name, final int maxOutstandingTask);
-  private static native String name(final long handle);
-  private static native void setMaxOutstandingTask(final long handle, final int limit);
-  private static native void resetMaxOutstandingTask(final long handle);
-  private static native int outstandingTask(final long handle);
-
-  @Override protected final native void disposeInternal(final long handle);
-}