rocksdb-native 0.0.0 → 0.0.1

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

@@ -1,44 +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;
-
-/**
- * A RocksDBException encapsulates the error of an operation.  This exception
- * type is used to describe an internal error from the c++ rocksdb library.
- */
-public class RocksDBException extends Exception {
-
-  /* @Nullable */ private final Status status;
-
-  /**
-   * The private construct used by a set of public static factory method.
-   *
-   * @param msg the specified error message.
-   */
-  public RocksDBException(final String msg) {
-    this(msg, null);
-  }
-
-  public RocksDBException(final String msg, final Status status) {
-    super(msg);
-    this.status = status;
-  }
-
-  public RocksDBException(final Status status) {
-    super(status.getState() != null ? status.getState()
-        : status.getCodeString());
-    this.status = status;
-  }
-
-  /**
-   * Get the status returned from RocksDB
-   *
-   * @return The status reported by RocksDB, or null if no status is available
-   */
-  public Status getStatus() {
-    return status;
-  }
-}

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

@@ -1,31 +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;
-
-/**
- * <p>A RocksEnv is an interface used by the rocksdb implementation to access
- * operating system functionality like the filesystem etc.</p>
- *
- * <p>All Env implementations are safe for concurrent access from
- * multiple threads without any external synchronization.</p>
- */
-public class RocksEnv extends Env {
-
-  /**
-   * <p>Package-private constructor that uses the specified native handle
-   * to construct a RocksEnv.</p>
-   *
-   * <p>Note that the ownership of the input handle
-   * belongs to the caller, and the newly created RocksEnv will not take
-   * the ownership of the input handle.  As a result, calling
-   * {@code dispose()} of the created RocksEnv will be no-op.</p>
-   */
-  RocksEnv(final long handle) {
-    super(handle);
-  }
-
-  @Override protected final native void disposeInternal(final long handle);
-}

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

@@ -1,140 +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.nio.ByteBuffer;
-
-/**
- * <p>An iterator that yields a sequence of key/value pairs from a source.
- * Multiple implementations are provided by this library.
- * In particular, iterators are provided
- * to access the contents of a Table or a DB.</p>
- *
- * <p>Multiple threads can invoke const methods on an RocksIterator without
- * external synchronization, but if any of the threads may call a
- * non-const method, all threads accessing the same RocksIterator must use
- * external synchronization.</p>
- *
- * @see org.rocksdb.RocksObject
- */
-public class RocksIterator extends AbstractRocksIterator<RocksDB> {
-  protected RocksIterator(final RocksDB rocksDB, final long nativeHandle) {
-    super(rocksDB, nativeHandle);
-  }
-
-  /**
-   * <p>Return the key for the current entry.  The underlying storage for
-   * the returned slice is valid only until the next modification of
-   * the iterator.</p>
-   *
-   * <p>REQUIRES: {@link #isValid()}</p>
-   *
-   * @return key for the current entry.
-   */
-  public byte[] key() {
-    assert(isOwningHandle());
-    return key0(nativeHandle_);
-  }
-
-  /**
-   * <p>Return the key for the current entry.  The underlying storage for
-   * the returned slice is valid only until the next modification of
-   * the iterator.</p>
-   *
-   * <p>REQUIRES: {@link #isValid()}</p>
-   *
-   * @param key the out-value to receive the retrieved key.
-   *     It is using position and limit. Limit is set according to key size.
-   *     Supports direct buffer only.
-   * @return The size of the actual key. If the return key is greater than the
-   *     length of {@code key}, then it indicates that the size of the
-   *     input buffer {@code key} is insufficient and partial result will
-   *     be returned.
-   */
-  public int key(final ByteBuffer key) {
-    assert isOwningHandle();
-    final int result;
-    if (key.isDirect()) {
-      result = keyDirect0(nativeHandle_, key, key.position(), key.remaining());
-    } else {
-      assert key.hasArray();
-      result = keyByteArray0(
-          nativeHandle_, key.array(), key.arrayOffset() + key.position(), key.remaining());
-    }
-    key.limit(Math.min(key.position() + result, key.limit()));
-    return result;
-  }
-
-  /**
-   * <p>Return the value for the current entry.  The underlying storage for
-   * the returned slice is valid only until the next modification of
-   * the iterator.</p>
-   *
-   * <p>REQUIRES: !AtEnd() &amp;&amp; !AtStart()</p>
-   * @return value for the current entry.
-   */
-  public byte[] value() {
-    assert(isOwningHandle());
-    return value0(nativeHandle_);
-  }
-
-  /**
-   * <p>Return the value for the current entry.  The underlying storage for
-   * the returned slice is valid only until the next modification of
-   * the iterator.</p>
-   *
-   * <p>REQUIRES: {@link #isValid()}</p>
-   *
-   * @param value the out-value to receive the retrieved value.
-   *     It is using position and limit. Limit is set according to value size.
-   *     Supports direct buffer only.
-   * @return The size of the actual value. If the return value is greater than the
-   *     length of {@code value}, then it indicates that the size of the
-   *     input buffer {@code value} is insufficient and partial result will
-   *     be returned.
-   */
-  public int value(final ByteBuffer value) {
-    assert isOwningHandle();
-    final int result;
-    if (value.isDirect()) {
-      result = valueDirect0(nativeHandle_, value, value.position(), value.remaining());
-    } else {
-      assert value.hasArray();
-      result = valueByteArray0(
-          nativeHandle_, value.array(), value.arrayOffset() + value.position(), value.remaining());
-    }
-    value.limit(Math.min(value.position() + result, value.limit()));
-    return result;
-  }
-
-  @Override protected final native void disposeInternal(final long handle);
-  @Override final native boolean isValid0(long handle);
-  @Override final native void seekToFirst0(long handle);
-  @Override final native void seekToLast0(long handle);
-  @Override final native void next0(long handle);
-  @Override final native void prev0(long handle);
-  @Override final native void refresh0(long handle);
-  @Override final native void seek0(long handle, byte[] target, int targetLen);
-  @Override final native void seekForPrev0(long handle, byte[] target, int targetLen);
-  @Override
-  final native void seekDirect0(long handle, ByteBuffer target, int targetOffset, int targetLen);
-  @Override
-  final native void seekByteArray0(long handle, byte[] target, int targetOffset, int targetLen);
-  @Override
-  final native void seekForPrevDirect0(
-      long handle, ByteBuffer target, int targetOffset, int targetLen);
-  @Override
-  final native void seekForPrevByteArray0(
-      long handle, byte[] target, int targetOffset, int targetLen);
-  @Override final native void status0(long handle) throws RocksDBException;
-
-  private native byte[] key0(long handle);
-  private native byte[] value0(long handle);
-  private native int keyDirect0(long handle, ByteBuffer buffer, int bufferOffset, int bufferLen);
-  private native int keyByteArray0(long handle, byte[] array, int arrayOffset, int arrayLen);
-  private native int valueDirect0(long handle, ByteBuffer buffer, int bufferOffset, int bufferLen);
-  private native int valueByteArray0(long handle, byte[] array, int arrayOffset, int arrayLen);
-}

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

@@ -1,127 +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.nio.ByteBuffer;
-
-/**
- * <p>Defines the interface for an Iterator which provides
- * access to data one entry at a time. Multiple implementations
- * are provided by this library.  In particular, iterators are provided
- * to access the contents of a DB and Write Batch.</p>
- *
- * <p>Multiple threads can invoke const methods on an RocksIterator without
- * external synchronization, but if any of the threads may call a
- * non-const method, all threads accessing the same RocksIterator must use
- * external synchronization.</p>
- *
- * @see org.rocksdb.RocksObject
- */
-public interface RocksIteratorInterface {
-
-  /**
-   * <p>An iterator is either positioned at an entry, or
-   * not valid.  This method returns true if the iterator is valid.</p>
-   *
-   * @return true if iterator is valid.
-   */
-  boolean isValid();
-
-  /**
-   * <p>Position at the first entry in the source.  The iterator is Valid()
-   * after this call if the source is not empty.</p>
-   */
-  void seekToFirst();
-
-  /**
-   * <p>Position at the last entry in the source.  The iterator is
-   * valid after this call if the source is not empty.</p>
-   */
-  void seekToLast();
-
-  /**
-   * <p>Position at the first entry in the source whose key is at or
-   * past target.</p>
-   *
-   * <p>The iterator is valid after this call if the source contains
-   * a key that comes at or past target.</p>
-   *
-   * @param target byte array describing a key or a
-   *               key prefix to seek for.
-   */
-  void seek(byte[] target);
-
-  /**
-   * <p>Position at the first entry in the source whose key is that or
-   * before target.</p>
-   *
-   * <p>The iterator is valid after this call if the source contains
-   * a key that comes at or before target.</p>
-   *
-   * @param target byte array describing a key or a
-   *               key prefix to seek for.
-   */
-  void seekForPrev(byte[] target);
-
-  /**
-   * <p>Position at the first entry in the source whose key is that or
-   * past target.</p>
-   *
-   * <p>The iterator is valid after this call if the source contains
-   * a key that comes at or past target.</p>
-   *
-   * @param target byte array describing a key or a
-   *               key prefix to seek for. Supports direct buffer only.
-   */
-  void seek(ByteBuffer target);
-
-  /**
-   * <p>Position at the last key that is less than or equal to the target key.</p>
-   *
-   * <p>The iterator is valid after this call if the source contains
-   * a key that comes at or past target.</p>
-   *
-   * @param target byte array describing a key or a
-   *               key prefix to seek for. Supports direct buffer only.
-   */
-  void seekForPrev(ByteBuffer target);
-
-  /**
-   * <p>Moves to the next entry in the source.  After this call, Valid() is
-   * true if the iterator was not positioned at the last entry in the source.</p>
-   *
-   * <p>REQUIRES: {@link #isValid()}</p>
-   */
-  void next();
-
-  /**
-   * <p>Moves to the previous entry in the source.  After this call, Valid() is
-   * true if the iterator was not positioned at the first entry in source.</p>
-   *
-   * <p>REQUIRES: {@link #isValid()}</p>
-   */
-  void prev();
-
-  /**
-   * <p>If an error has occurred, return it.  Else return an ok status.
-   * If non-blocking IO is requested and this operation cannot be
-   * satisfied without doing some IO, then this returns Status::Incomplete().</p>
-   *
-   * @throws RocksDBException thrown if error happens in underlying
-   *                          native library.
-   */
-  void status() throws RocksDBException;
-
-  /**
-   * <p>If supported, renew the iterator to represent the latest state. The iterator will be
-   * invalidated after the call. Not supported if {@link ReadOptions#setSnapshot(Snapshot)} was
-   * specified when creating the iterator.</p>
-   *
-   * @throws RocksDBException thrown if the operation is not supported or an error happens in the
-   *     underlying native library
-   */
-  void refresh() throws RocksDBException;
-}

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

@@ -1,31 +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;
-
-/**
- * Memory environment.
- */
-//TODO(AR) rename to MemEnv
-public class RocksMemEnv extends Env {
-
-  /**
-   * <p>Creates a new environment that stores its data
-   * in memory and delegates all non-file-storage tasks to
-   * {@code baseEnv}.</p>
-   *
-   * <p>The caller must delete the result when it is
-   * no longer needed.</p>
-   *
-   * @param baseEnv the base environment,
-   *     must remain live while the result is in use.
-   */
-  public RocksMemEnv(final Env baseEnv) {
-    super(createMemEnv(baseEnv.nativeHandle_));
-  }
-
-  private static native long createMemEnv(final long baseEnvHandle);
-  @Override protected final native void disposeInternal(final long handle);
-}

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

@@ -1,87 +0,0 @@
-// Copyright (c) 2016, 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;
-
-/**
- * RocksMutableObject is an implementation of {@link AbstractNativeReference}
- * whose reference to the underlying native C++ object can change.
- *
- * <p>The use of {@code RocksMutableObject} should be kept to a minimum, as it
- * has synchronization overheads and introduces complexity. Instead it is
- * recommended to use {@link RocksObject} where possible.</p>
- */
-public abstract class RocksMutableObject extends AbstractNativeReference {
-
-  /**
-   * An mutable reference to the value of the C++ pointer pointing to some
-   * underlying native RocksDB C++ object.
-   */
-  private long nativeHandle_;
-  private boolean owningHandle_;
-
-  protected RocksMutableObject() {
-  }
-
-  protected RocksMutableObject(final long nativeHandle) {
-    this.nativeHandle_ = nativeHandle;
-    this.owningHandle_ = true;
-  }
-
-  /**
-   * Closes the existing handle, and changes the handle to the new handle
-   *
-   * @param newNativeHandle The C++ pointer to the new native object
-   * @param owningNativeHandle true if we own the new native object
-   */
-  public synchronized void resetNativeHandle(final long newNativeHandle,
-      final boolean owningNativeHandle) {
-    close();
-    setNativeHandle(newNativeHandle, owningNativeHandle);
-  }
-
-  /**
-   * Sets the handle (C++ pointer) of the underlying C++ native object
-   *
-   * @param nativeHandle The C++ pointer to the native object
-   * @param owningNativeHandle true if we own the native object
-   */
-  public synchronized void setNativeHandle(final long nativeHandle,
-      final boolean owningNativeHandle) {
-    this.nativeHandle_ = nativeHandle;
-    this.owningHandle_ = owningNativeHandle;
-  }
-
-  @Override
-  protected synchronized boolean isOwningHandle() {
-    return this.owningHandle_;
-  }
-
-  /**
-   * Gets the value of the C++ pointer pointing to the underlying
-   * native C++ object
-   *
-   * @return the pointer value for the native object
-   */
-  protected synchronized long getNativeHandle() {
-    assert (this.nativeHandle_ != 0);
-    return this.nativeHandle_;
-  }
-
-  @Override
-  public final synchronized void close() {
-    if (isOwningHandle()) {
-      disposeInternal();
-      this.owningHandle_ = false;
-      this.nativeHandle_ = 0;
-    }
-  }
-
-  protected void disposeInternal() {
-    disposeInternal(nativeHandle_);
-  }
-
-  protected abstract void disposeInternal(final long handle);
-}

package/vendor/rocksdb/java/src/main/java/org/rocksdb/RocksObject.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;
-
-/**
- * RocksObject is an implementation of {@link AbstractNativeReference} which
- * has an immutable and therefore thread-safe reference to the underlying
- * native C++ RocksDB object.
- * <p>
- * RocksObject is the base-class of almost all RocksDB classes that have a
- * pointer to some underlying native C++ {@code rocksdb} object.</p>
- * <p>
- * The use of {@code RocksObject} should always be preferred over
- * {@link RocksMutableObject}.</p>
- */
-public abstract class RocksObject extends AbstractImmutableNativeReference {
-
-  /**
-   * An immutable reference to the value of the C++ pointer pointing to some
-   * underlying native RocksDB C++ object.
-   */
-  protected final long nativeHandle_;
-
-  protected RocksObject(final long nativeHandle) {
-    super(true);
-    this.nativeHandle_ = nativeHandle;
-  }
-
-  /**
-   * Deletes underlying C++ object pointer.
-   */
-  @Override
-  protected void disposeInternal() {
-    disposeInternal(nativeHandle_);
-  }
-
-  protected abstract void disposeInternal(final long handle);
-
-  public long getNativeHandle() {
-    return nativeHandle_;
-  }
-}

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

@@ -1,47 +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 enum SanityLevel {
-  NONE((byte) 0x0),
-  LOOSELY_COMPATIBLE((byte) 0x1),
-  EXACT_MATCH((byte) 0xFF);
-
-  private final byte value;
-
-  SanityLevel(final byte value) {
-    this.value = value;
-  }
-
-  /**
-   * Get the internal representation value.
-   *
-   * @return the internal representation value.
-   */
-  byte getValue() {
-    return value;
-  }
-
-  /**
-   * Get the SanityLevel from the internal representation value.
-   *
-   * @param value the internal representation value.
-   *
-   * @return the SanityLevel
-   *
-   * @throws IllegalArgumentException if the value does not match a
-   *     SanityLevel
-   */
-  static SanityLevel fromValue(final byte value) throws IllegalArgumentException {
-    for (final SanityLevel level : SanityLevel.values()) {
-      if (level.value == value) {
-        return level;
-      }
-    }
-    throw new IllegalArgumentException("Unknown value for SanityLevel: " + value);
-  }
-}

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

@@ -1,31 +0,0 @@
-// Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
-package org.rocksdb;
-
-import java.util.List;
-
-/**
- * Flags for
- * {@link RocksDB#getApproximateSizes(ColumnFamilyHandle, List, SizeApproximationFlag...)}
- * that specify whether memtable stats should be included,
- * or file stats approximation or both.
- */
-public enum SizeApproximationFlag {
-  NONE((byte)0x0),
-  INCLUDE_MEMTABLES((byte)0x1),
-  INCLUDE_FILES((byte)0x2);
-
-  private final byte value;
-
-  SizeApproximationFlag(final byte value) {
-    this.value = value;
-  }
-
-  /**
-   * Get the internal byte representation.
-   *
-   * @return the internal representation.
-   */
-  byte getValue() {
-    return value;
-  }
-}

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

@@ -1,51 +0,0 @@
-// Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
-package org.rocksdb;
-
-/**
- * The config for skip-list memtable representation.
- */
-public class SkipListMemTableConfig extends MemTableConfig {
-
-  public static final long DEFAULT_LOOKAHEAD = 0;
-
-  /**
-   * SkipListMemTableConfig constructor
-   */
-  public SkipListMemTableConfig() {
-    lookahead_ = DEFAULT_LOOKAHEAD;
-  }
-
-  /**
-   * Sets lookahead for SkipList
-   *
-   * @param lookahead If non-zero, each iterator's seek operation
-   *     will start the search from the previously visited record
-   *     (doing at most 'lookahead' steps). This is an
-   *     optimization for the access pattern including many
-   *     seeks with consecutive keys.
-   * @return the current instance of SkipListMemTableConfig
-   */
-  public SkipListMemTableConfig setLookahead(final long lookahead) {
-    lookahead_ = lookahead;
-    return this;
-  }
-
-  /**
-   * Returns the currently set lookahead value.
-   *
-   * @return lookahead value
-   */
-  public long lookahead() {
-    return lookahead_;
-  }
-
-
-  @Override protected long newMemTableFactoryHandle() {
-    return newMemTableFactoryHandle0(lookahead_);
-  }
-
-  private native long newMemTableFactoryHandle0(long lookahead)
-      throws IllegalArgumentException;
-
-  private long lookahead_;
-}