rocksdb-native 0.0.0 → 0.0.2

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

@@ -1,124 +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;
-
-/**
- * Comparators are used by RocksDB to determine
- * the ordering of keys.
- *
- * Implementations of Comparators in Java should extend this class.
- */
-public abstract class AbstractComparator
-    extends RocksCallbackObject {
-
-  AbstractComparator() {
-    super();
-  }
-
-  protected AbstractComparator(final ComparatorOptions comparatorOptions) {
-    super(comparatorOptions.nativeHandle_);
-  }
-
-  @Override
-  protected long initializeNative(final long... nativeParameterHandles) {
-      return createNewComparator(nativeParameterHandles[0]);
-  }
-
-  /**
-   * Get the type of this comparator.
-   * <p>
-   * Used for determining the correct C++ cast in native code.
-   *
-   * @return The type of the comparator.
-   */
-  ComparatorType getComparatorType() {
-    return ComparatorType.JAVA_COMPARATOR;
-  }
-
-  /**
-   * The name of the comparator.  Used to check for comparator
-   * mismatches (i.e., a DB created with one comparator is
-   * accessed using a different comparator).
-   * <p>
-   * A new name should be used whenever
-   * the comparator implementation changes in a way that will cause
-   * the relative ordering of any two keys to change.
-   * <p>
-   * Names starting with "rocksdb." are reserved and should not be used.
-   *
-   * @return The name of this comparator implementation
-   */
-  public abstract String name();
-
-  /**
-   * Three-way key comparison. Implementations should provide a
-   * <a href="https://en.wikipedia.org/wiki/Total_order">total order</a>
-   * on keys that might be passed to it.
-   *
-   * The implementation may modify the {@code ByteBuffer}s passed in, though
-   * it would be unconventional to modify the "limit" or any of the
-   * underlying bytes. As a callback, RocksJava will ensure that {@code a}
-   * is a different instance from {@code b}.
-   *
-   * @param a buffer containing the first key in its "remaining" elements
-   * @param b buffer containing the second key in its "remaining" elements
-   *
-   * @return Should return either:
-   *    1) &lt; 0 if "a" &lt; "b"
-   *    2) == 0 if "a" == "b"
-   *    3) &gt; 0 if "a" &gt; "b"
-   */
-  public abstract int compare(final ByteBuffer a, final ByteBuffer b);
-
-  /**
-   * <p>Used to reduce the space requirements
-   * for internal data structures like index blocks.</p>
-   *
-   * <p>If start &lt; limit, you may modify start which is a
-   * shorter string in [start, limit).</p>
-   *
-   * If you modify start, it is expected that you set the byte buffer so that
-   * a subsequent read of start.remaining() bytes from start.position()
-   * to start.limit() will obtain the new start value.
-   *
-   * <p>Simple comparator implementations may return with start unchanged.
-   * i.e., an implementation of this method that does nothing is correct.</p>
-   *
-   * @param start the start
-   * @param limit the limit
-   */
-  public void findShortestSeparator(final ByteBuffer start,
-      final ByteBuffer limit) {
-    // no-op
-  }
-
-  /**
-   * <p>Used to reduce the space requirements
-   * for internal data structures like index blocks.</p>
-   *
-   * <p>You may change key to a shorter key (key1) where
-   * key1 &ge; key.</p>
-   *
-   * <p>Simple comparator implementations may return the key unchanged.
-   * i.e., an implementation of
-   * this method that does nothing is correct.</p>
-   *
-   * @param key the key
-   */
-  public void findShortSuccessor(final ByteBuffer key) {
-    // no-op
-  }
-
-  public final boolean usingDirectBuffers() {
-    return usingDirectBuffers(nativeHandle_);
-  }
-
-  private native boolean usingDirectBuffers(final long nativeHandle);
-
-  private native long createNewComparator(final long comparatorOptionsHandle);
-}

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

@@ -1,119 +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;
-
-/**
- * This class is intentionally private,
- * it holds methods which are called
- * from C++ to interact with a Comparator
- * written in Java.
- *
- * Placing these bridge methods in this
- * class keeps the API of the
- * {@link org.rocksdb.AbstractComparator} clean.
- */
-class AbstractComparatorJniBridge {
-  /**
-   * Only called from JNI.
-   * <p>
-   * Simply a bridge to calling
-   * {@link AbstractComparator#compare(ByteBuffer, ByteBuffer)},
-   * which ensures that the byte buffer lengths are correct
-   * before and after the call.
-   *
-   * @param comparator the comparator object on which to
-   *     call {@link AbstractComparator#compare(ByteBuffer, ByteBuffer)}
-   * @param a buffer access to first key
-   * @param aLen the length of the a key,
-   *     may be smaller than the buffer {@code a}
-   * @param b buffer access to second key
-   * @param bLen the length of the b key,
-   *     may be smaller than the buffer {@code b}
-   *
-   * @return the result of the comparison
-   */
-  private static int compareInternal(final AbstractComparator comparator, final ByteBuffer a,
-      final int aLen, final ByteBuffer b, final int bLen) {
-    if (aLen != -1) {
-      a.mark();
-      a.limit(aLen);
-    }
-    if (bLen != -1) {
-      b.mark();
-      b.limit(bLen);
-    }
-
-    final int c = comparator.compare(a, b);
-
-    if (aLen != -1) {
-      a.reset();
-    }
-    if (bLen != -1) {
-      b.reset();
-    }
-
-    return c;
-  }
-
-  /**
-   * Only called from JNI.
-   * <p>
-   * Simply a bridge to calling
-   * {@link AbstractComparator#findShortestSeparator(ByteBuffer, ByteBuffer)},
-   * which ensures that the byte buffer lengths are correct
-   * before the call.
-   *
-   * @param comparator the comparator object on which to
-   *     call {@link AbstractComparator#findShortestSeparator(ByteBuffer, ByteBuffer)}
-   * @param start buffer access to the start key
-   * @param startLen the length of the start key,
-   *     may be smaller than the buffer {@code start}
-   * @param limit buffer access to the limit key
-   * @param limitLen the length of the limit key,
-   *     may be smaller than the buffer {@code limit}
-   *
-   * @return either {@code startLen} if the start key is unchanged, otherwise
-   *     the new length of the start key
-   */
-  private static int findShortestSeparatorInternal(final AbstractComparator comparator,
-      final ByteBuffer start, final int startLen, final ByteBuffer limit, final int limitLen) {
-    if (startLen != -1) {
-      start.limit(startLen);
-    }
-    if (limitLen != -1) {
-      limit.limit(limitLen);
-    }
-    comparator.findShortestSeparator(start, limit);
-    return start.remaining();
-  }
-
-  /**
-   * Only called from JNI.
-   * <p>
-   * Simply a bridge to calling
-   * {@link AbstractComparator#findShortestSeparator(ByteBuffer, ByteBuffer)},
-   * which ensures that the byte buffer length is correct
-   * before the call.
-   *
-   * @param comparator the comparator object on which to
-   *     call {@link AbstractComparator#findShortSuccessor(ByteBuffer)}
-   * @param key buffer access to the key
-   * @param keyLen the length of the key,
-   *     may be smaller than the buffer {@code key}
-   *
-   * @return either keyLen if the key is unchanged, otherwise the new length of the key
-   */
-  private static int findShortSuccessorInternal(
-      final AbstractComparator comparator, final ByteBuffer key, final int keyLen) {
-    if (keyLen != -1) {
-      key.limit(keyLen);
-    }
-    comparator.findShortSuccessor(key);
-    return key.remaining();
-  }
-}

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

@@ -1,334 +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 static org.rocksdb.AbstractEventListener.EnabledEventCallback.*;
-
-/**
- * Base class for Event Listeners.
- */
-public abstract class AbstractEventListener extends RocksCallbackObject implements EventListener {
-  public enum EnabledEventCallback {
-    ON_FLUSH_COMPLETED((byte) 0x0),
-    ON_FLUSH_BEGIN((byte) 0x1),
-    ON_TABLE_FILE_DELETED((byte) 0x2),
-    ON_COMPACTION_BEGIN((byte) 0x3),
-    ON_COMPACTION_COMPLETED((byte) 0x4),
-    ON_TABLE_FILE_CREATED((byte) 0x5),
-    ON_TABLE_FILE_CREATION_STARTED((byte) 0x6),
-    ON_MEMTABLE_SEALED((byte) 0x7),
-    ON_COLUMN_FAMILY_HANDLE_DELETION_STARTED((byte) 0x8),
-    ON_EXTERNAL_FILE_INGESTED((byte) 0x9),
-    ON_BACKGROUND_ERROR((byte) 0xA),
-    ON_STALL_CONDITIONS_CHANGED((byte) 0xB),
-    ON_FILE_READ_FINISH((byte) 0xC),
-    ON_FILE_WRITE_FINISH((byte) 0xD),
-    ON_FILE_FLUSH_FINISH((byte) 0xE),
-    ON_FILE_SYNC_FINISH((byte) 0xF),
-    ON_FILE_RANGE_SYNC_FINISH((byte) 0x10),
-    ON_FILE_TRUNCATE_FINISH((byte) 0x11),
-    ON_FILE_CLOSE_FINISH((byte) 0x12),
-    SHOULD_BE_NOTIFIED_ON_FILE_IO((byte) 0x13),
-    ON_ERROR_RECOVERY_BEGIN((byte) 0x14),
-    ON_ERROR_RECOVERY_COMPLETED((byte) 0x15);
-
-    private final byte value;
-
-    EnabledEventCallback(final byte value) {
-      this.value = value;
-    }
-
-    /**
-     * Get the internal representation value.
-     *
-     * @return the internal representation value
-     */
-    byte getValue() {
-      return value;
-    }
-
-    /**
-     * Get the EnabledEventCallbacks from the internal representation value.
-     *
-     * @return the enabled event callback.
-     *
-     * @throws IllegalArgumentException if the value is unknown.
-     */
-    static EnabledEventCallback fromValue(final byte value) {
-      for (final EnabledEventCallback enabledEventCallback : EnabledEventCallback.values()) {
-        if (enabledEventCallback.value == value) {
-          return enabledEventCallback;
-        }
-      }
-
-      throw new IllegalArgumentException(
-          "Illegal value provided for EnabledEventCallback: " + value);
-    }
-  }
-
-  /**
-   * Creates an Event Listener that will
-   * receive all callbacks from C++.
-   * <p>
-   * If you don't need all callbacks, it is much more efficient to
-   * just register for the ones you need by calling
-   * {@link #AbstractEventListener(EnabledEventCallback...)} instead.
-   */
-  protected AbstractEventListener() {
-    this(ON_FLUSH_COMPLETED, ON_FLUSH_BEGIN, ON_TABLE_FILE_DELETED, ON_COMPACTION_BEGIN,
-        ON_COMPACTION_COMPLETED, ON_TABLE_FILE_CREATED, ON_TABLE_FILE_CREATION_STARTED,
-        ON_MEMTABLE_SEALED, ON_COLUMN_FAMILY_HANDLE_DELETION_STARTED, ON_EXTERNAL_FILE_INGESTED,
-        ON_BACKGROUND_ERROR, ON_STALL_CONDITIONS_CHANGED, ON_FILE_READ_FINISH, ON_FILE_WRITE_FINISH,
-        ON_FILE_FLUSH_FINISH, ON_FILE_SYNC_FINISH, ON_FILE_RANGE_SYNC_FINISH,
-        ON_FILE_TRUNCATE_FINISH, ON_FILE_CLOSE_FINISH, SHOULD_BE_NOTIFIED_ON_FILE_IO,
-        ON_ERROR_RECOVERY_BEGIN, ON_ERROR_RECOVERY_COMPLETED);
-  }
-
-  /**
-   * Creates an Event Listener that will
-   * receive only certain callbacks from C++.
-   *
-   * @param enabledEventCallbacks callbacks to enable in Java.
-   */
-  protected AbstractEventListener(final EnabledEventCallback... enabledEventCallbacks) {
-    super(packToLong(enabledEventCallbacks));
-  }
-
-  /**
-   * Pack EnabledEventCallbacks to a long.
-   *
-   * @param enabledEventCallbacks the flags
-   *
-   * @return a long
-   */
-  private static long packToLong(final EnabledEventCallback... enabledEventCallbacks) {
-    long l = 0;
-    for (final EnabledEventCallback enabledEventCallback : enabledEventCallbacks) {
-      l |= 1L << enabledEventCallback.getValue();
-    }
-    return l;
-  }
-
-  @Override
-  public void onFlushCompleted(final RocksDB db, final FlushJobInfo flushJobInfo) {
-    // no-op
-  }
-
-  /**
-   * Called from JNI, proxy for
-   *     {@link #onFlushCompleted(RocksDB, FlushJobInfo)}.
-   *
-   * @param dbHandle native handle of the database
-   * @param flushJobInfo the flush job info
-   */
-  private void onFlushCompletedProxy(final long dbHandle, final FlushJobInfo flushJobInfo) {
-    final RocksDB db = new RocksDB(dbHandle);
-    db.disOwnNativeHandle(); // we don't own this!
-    onFlushCompleted(db, flushJobInfo);
-  }
-
-  @Override
-  public void onFlushBegin(final RocksDB db, final FlushJobInfo flushJobInfo) {
-    // no-op
-  }
-
-  /**
-   * Called from JNI, proxy for
-   *     {@link #onFlushBegin(RocksDB, FlushJobInfo)}.
-   *
-   * @param dbHandle native handle of the database
-   * @param flushJobInfo the flush job info
-   */
-  private void onFlushBeginProxy(final long dbHandle, final FlushJobInfo flushJobInfo) {
-    final RocksDB db = new RocksDB(dbHandle);
-    db.disOwnNativeHandle(); // we don't own this!
-    onFlushBegin(db, flushJobInfo);
-  }
-
-  @Override
-  public void onTableFileDeleted(final TableFileDeletionInfo tableFileDeletionInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onCompactionBegin(final RocksDB db, final CompactionJobInfo compactionJobInfo) {
-    // no-op
-  }
-
-  /**
-   * Called from JNI, proxy for
-   *     {@link #onCompactionBegin(RocksDB, CompactionJobInfo)}.
-   *
-   * @param dbHandle native handle of the database
-   * @param compactionJobInfo the flush job info
-   */
-  private void onCompactionBeginProxy(
-      final long dbHandle, final CompactionJobInfo compactionJobInfo) {
-    final RocksDB db = new RocksDB(dbHandle);
-    db.disOwnNativeHandle(); // we don't own this!
-    onCompactionBegin(db, compactionJobInfo);
-  }
-
-  @Override
-  public void onCompactionCompleted(final RocksDB db, final CompactionJobInfo compactionJobInfo) {
-    // no-op
-  }
-
-  /**
-   * Called from JNI, proxy for
-   *     {@link #onCompactionCompleted(RocksDB, CompactionJobInfo)}.
-   *
-   * @param dbHandle native handle of the database
-   * @param compactionJobInfo the flush job info
-   */
-  private void onCompactionCompletedProxy(
-      final long dbHandle, final CompactionJobInfo compactionJobInfo) {
-    final RocksDB db = new RocksDB(dbHandle);
-    db.disOwnNativeHandle(); // we don't own this!
-    onCompactionCompleted(db, compactionJobInfo);
-  }
-
-  @Override
-  public void onTableFileCreated(final TableFileCreationInfo tableFileCreationInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onTableFileCreationStarted(
-      final TableFileCreationBriefInfo tableFileCreationBriefInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onMemTableSealed(final MemTableInfo memTableInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onColumnFamilyHandleDeletionStarted(final ColumnFamilyHandle columnFamilyHandle) {
-    // no-op
-  }
-
-  @Override
-  public void onExternalFileIngested(
-      final RocksDB db, final ExternalFileIngestionInfo externalFileIngestionInfo) {
-    // no-op
-  }
-
-  /**
-   * Called from JNI, proxy for
-   *     {@link #onExternalFileIngested(RocksDB, ExternalFileIngestionInfo)}.
-   *
-   * @param dbHandle native handle of the database
-   * @param externalFileIngestionInfo the flush job info
-   */
-  private void onExternalFileIngestedProxy(
-      final long dbHandle, final ExternalFileIngestionInfo externalFileIngestionInfo) {
-    final RocksDB db = new RocksDB(dbHandle);
-    db.disOwnNativeHandle(); // we don't own this!
-    onExternalFileIngested(db, externalFileIngestionInfo);
-  }
-
-  @Override
-  public void onBackgroundError(
-      final BackgroundErrorReason backgroundErrorReason, final Status backgroundError) {
-    // no-op
-  }
-
-  /**
-   * Called from JNI, proxy for
-   *     {@link #onBackgroundError(BackgroundErrorReason, Status)}.
-   *
-   * @param reasonByte byte value representing error reason
-   * @param backgroundError status with error code
-   */
-  private void onBackgroundErrorProxy(final byte reasonByte, final Status backgroundError) {
-    onBackgroundError(BackgroundErrorReason.fromValue(reasonByte), backgroundError);
-  }
-
-  @Override
-  public void onStallConditionsChanged(final WriteStallInfo writeStallInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onFileReadFinish(final FileOperationInfo fileOperationInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onFileWriteFinish(final FileOperationInfo fileOperationInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onFileFlushFinish(final FileOperationInfo fileOperationInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onFileSyncFinish(final FileOperationInfo fileOperationInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onFileRangeSyncFinish(final FileOperationInfo fileOperationInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onFileTruncateFinish(final FileOperationInfo fileOperationInfo) {
-    // no-op
-  }
-
-  @Override
-  public void onFileCloseFinish(final FileOperationInfo fileOperationInfo) {
-    // no-op
-  }
-
-  @Override
-  public boolean shouldBeNotifiedOnFileIO() {
-    return false;
-  }
-
-  @Override
-  public boolean onErrorRecoveryBegin(
-      final BackgroundErrorReason backgroundErrorReason, final Status backgroundError) {
-    return true;
-  }
-
-  /**
-   * Called from JNI, proxy for
-   *     {@link #onErrorRecoveryBegin(BackgroundErrorReason, Status)}.
-   *
-   * @param reasonByte byte value representing error reason
-   * @param backgroundError status with error code
-   */
-  private boolean onErrorRecoveryBeginProxy(final byte reasonByte, final Status backgroundError) {
-    return onErrorRecoveryBegin(BackgroundErrorReason.fromValue(reasonByte), backgroundError);
-  }
-
-  @Override
-  public void onErrorRecoveryCompleted(final Status oldBackgroundError) {
-    // no-op
-  }
-
-  @Override
-  protected long initializeNative(final long... nativeParameterHandles) {
-    return createNewEventListener(nativeParameterHandles[0]);
-  }
-
-  /**
-   * Deletes underlying C++ native callback object pointer
-   */
-  @Override
-  protected void disposeInternal() {
-    disposeInternal(nativeHandle_);
-  }
-
-  private native long createNewEventListener(final long enabledEventCallbackValues);
-  private native void disposeInternal(final long handle);
-}

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

@@ -1,65 +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;
-
-import java.util.concurrent.atomic.AtomicBoolean;
-
-/**
- * Offers functionality for implementations of
- * {@link AbstractNativeReference} which have an immutable reference to the
- * underlying native C++ object
- */
-//@ThreadSafe
-public abstract class AbstractImmutableNativeReference
-    extends AbstractNativeReference {
-
-  /**
-   * A flag indicating whether the current {@code AbstractNativeReference} is
-   * responsible to free the underlying C++ object
-   */
-  protected final AtomicBoolean owningHandle_;
-
-  protected AbstractImmutableNativeReference(final boolean owningHandle) {
-    this.owningHandle_ = new AtomicBoolean(owningHandle);
-  }
-
-  @Override
-  public boolean isOwningHandle() {
-    return owningHandle_.get();
-  }
-
-  /**
-   * Releases this {@code AbstractNativeReference} from  the responsibility of
-   * freeing the underlying native C++ object
-   * <p>
-   * This will prevent the object from attempting to delete the underlying
-   * native object in {@code close()}. This must be used when another object
-   * takes over ownership of the native object or both will attempt to delete
-   * the underlying object when closed.
-   * <p>
-   * When {@code disOwnNativeHandle()} is called, {@code close()} will
-   * subsequently take no action. As a result, incorrect use of this function
-   * may cause a memory leak.
-   * </p>
-   */
-  protected final void disOwnNativeHandle() {
-    owningHandle_.set(false);
-  }
-
-  @Override
-  public void close() {
-    if (owningHandle_.compareAndSet(true, false)) {
-      disposeInternal();
-    }
-  }
-
-  /**
-   * The helper function of {@link AbstractImmutableNativeReference#close()}
-   * which all subclasses of {@code AbstractImmutableNativeReference} must
-   * implement to release their underlying native C++ objects.
-   */
-  protected abstract void disposeInternal();
-}