rocksdb-native 0.0.0 → 0.0.2

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

@@ -1,394 +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;
-
-/**
- * WriteBatch holds a collection of updates to apply atomically to a DB.
- * <p>
- * The updates are applied in the order in which they are added
- * to the WriteBatch.  For example, the value of "key" will be "v3"
- * after the following batch is written:
- * <p>
- *    batch.put("key", "v1");
- *    batch.remove("key");
- *    batch.put("key", "v2");
- *    batch.put("key", "v3");
- * <p>
- * Multiple threads can invoke const methods on a WriteBatch without
- * external synchronization, but if any of the threads may call a
- * non-const method, all threads accessing the same WriteBatch must use
- * external synchronization.
- */
-public class WriteBatch extends AbstractWriteBatch {
-  /**
-   * Constructs a WriteBatch instance.
-   */
-  public WriteBatch() {
-    this(0);
-  }
-
-  /**
-   * Constructs a WriteBatch instance with a given size.
-   *
-   * @param reserved_bytes reserved size for WriteBatch
-   */
-  public WriteBatch(final int reserved_bytes) {
-    super(newWriteBatch(reserved_bytes));
-  }
-
-  /**
-   * Constructs a WriteBatch instance from a serialized representation
-   * as returned by {@link #data()}.
-   *
-   * @param serialized the serialized representation.
-   */
-  public WriteBatch(final byte[] serialized) {
-    super(newWriteBatch(serialized, serialized.length));
-  }
-
-  /**
-   * Support for iterating over the contents of a batch.
-   *
-   * @param handler A handler that is called back for each
-   *                update present in the batch
-   *
-   * @throws RocksDBException If we cannot iterate over the batch
-   */
-  public void iterate(final Handler handler) throws RocksDBException {
-    iterate(nativeHandle_, handler.nativeHandle_);
-  }
-
-  /**
-   * Retrieve the serialized version of this batch.
-   *
-   * @return the serialized representation of this write batch.
-   *
-   * @throws RocksDBException if an error occurs whilst retrieving
-   *   the serialized batch data.
-   */
-  public byte[] data() throws RocksDBException {
-    return data(nativeHandle_);
-  }
-
-  /**
-   * Retrieve data size of the batch.
-   *
-   * @return the serialized data size of the batch.
-   */
-  public long getDataSize() {
-    return getDataSize(nativeHandle_);
-  }
-
-  /**
-   * Returns true if Put will be called during Iterate.
-   *
-   * @return true if Put will be called during Iterate.
-   */
-  public boolean hasPut() {
-    return hasPut(nativeHandle_);
-  }
-
-  /**
-   * Returns true if Delete will be called during Iterate.
-   *
-   * @return true if Delete will be called during Iterate.
-   */
-  public boolean hasDelete() {
-    return hasDelete(nativeHandle_);
-  }
-
-  /**
-   * Returns true if SingleDelete will be called during Iterate.
-   *
-   * @return true if SingleDelete will be called during Iterate.
-   */
-  public boolean hasSingleDelete() {
-    return hasSingleDelete(nativeHandle_);
-  }
-
-  /**
-   * Returns true if DeleteRange will be called during Iterate.
-   *
-   * @return true if DeleteRange will be called during Iterate.
-   */
-  public boolean hasDeleteRange() {
-    return hasDeleteRange(nativeHandle_);
-  }
-
-  /**
-   * Returns true if Merge will be called during Iterate.
-   *
-   * @return true if Merge will be called during Iterate.
-   */
-  public boolean hasMerge() {
-    return hasMerge(nativeHandle_);
-  }
-
-  /**
-   * Returns true if MarkBeginPrepare will be called during Iterate.
-   *
-   * @return true if MarkBeginPrepare will be called during Iterate.
-   */
-  public boolean hasBeginPrepare() {
-    return hasBeginPrepare(nativeHandle_);
-  }
-
-  /**
-   * Returns true if MarkEndPrepare will be called during Iterate.
-   *
-   * @return true if MarkEndPrepare will be called during Iterate.
-   */
-  public boolean hasEndPrepare() {
-    return hasEndPrepare(nativeHandle_);
-  }
-
-  /**
-   * Returns true if MarkCommit will be called during Iterate.
-   *
-   * @return true if MarkCommit will be called during Iterate.
-   */
-  public boolean hasCommit() {
-    return hasCommit(nativeHandle_);
-  }
-
-  /**
-   * Returns true if MarkRollback will be called during Iterate.
-   *
-   * @return true if MarkRollback will be called during Iterate.
-   */
-  public boolean hasRollback() {
-    return hasRollback(nativeHandle_);
-  }
-
-  @Override
-  public WriteBatch getWriteBatch() {
-    return this;
-  }
-
-  /**
-   * Marks this point in the WriteBatch as the last record to
-   * be inserted into the WAL, provided the WAL is enabled.
-   */
-  public void markWalTerminationPoint() {
-    markWalTerminationPoint(nativeHandle_);
-  }
-
-  /**
-   * Gets the WAL termination point.
-   * <p>
-   * See {@link #markWalTerminationPoint()}
-   *
-   * @return the WAL termination point
-   */
-  public SavePoint getWalTerminationPoint() {
-    return getWalTerminationPoint(nativeHandle_);
-  }
-
-  @Override
-  WriteBatch getWriteBatch(final long handle) {
-    return this;
-  }
-
-  /**
-   * <p>Private WriteBatch constructor which is used to construct
-   * WriteBatch instances from C++ side. As the reference to this
-   * object is also managed from C++ side the handle will be disowned.</p>
-   *
-   * @param nativeHandle address of native instance.
-   */
-  WriteBatch(final long nativeHandle) {
-    this(nativeHandle, false);
-  }
-
-  /**
-   * <p>Private WriteBatch constructor which is used to construct
-   * WriteBatch instances. </p>
-   *
-   * @param nativeHandle address of native instance.
-   * @param owningNativeHandle whether to own this reference from the C++ side or not
-   */
-  WriteBatch(final long nativeHandle, final boolean owningNativeHandle) {
-    super(nativeHandle);
-    if(!owningNativeHandle)
-      disOwnNativeHandle();
-  }
-
-  @Override protected final native void disposeInternal(final long handle);
-  @Override final native int count0(final long handle);
-  @Override final native void put(final long handle, final byte[] key,
-      final int keyLen, final byte[] value, final int valueLen);
-  @Override final native void put(final long handle, final byte[] key,
-      final int keyLen, final byte[] value, final int valueLen,
-      final long cfHandle);
-  @Override
-  final native void putDirect(final long handle, final ByteBuffer key, final int keyOffset,
-      final int keyLength, final ByteBuffer value, final int valueOffset, final int valueLength,
-      final long cfHandle);
-  @Override final native void merge(final long handle, final byte[] key,
-      final int keyLen, final byte[] value, final int valueLen);
-  @Override final native void merge(final long handle, final byte[] key,
-      final int keyLen, final byte[] value, final int valueLen,
-      final long cfHandle);
-  @Override final native void delete(final long handle, final byte[] key,
-      final int keyLen) throws RocksDBException;
-  @Override final native void delete(final long handle, final byte[] key,
-      final int keyLen, final long cfHandle) throws RocksDBException;
-  @Override final native void singleDelete(final long handle, final byte[] key,
-      final int keyLen) throws RocksDBException;
-  @Override final native void singleDelete(final long handle, final byte[] key,
-      final int keyLen, final long cfHandle) throws RocksDBException;
-  @Override
-  final native void deleteDirect(final long handle, final ByteBuffer key, final int keyOffset,
-      final int keyLength, final long cfHandle) throws RocksDBException;
-  @Override
-  final native void deleteRange(final long handle, final byte[] beginKey, final int beginKeyLen,
-      final byte[] endKey, final int endKeyLen);
-  @Override
-  final native void deleteRange(final long handle, final byte[] beginKey, final int beginKeyLen,
-      final byte[] endKey, final int endKeyLen, final long cfHandle);
-  @Override final native void putLogData(final long handle,
-      final byte[] blob, final int blobLen) throws RocksDBException;
-  @Override final native void clear0(final long handle);
-  @Override final native void setSavePoint0(final long handle);
-  @Override final native void rollbackToSavePoint0(final long handle);
-  @Override final native void popSavePoint(final long handle) throws RocksDBException;
-  @Override final native void setMaxBytes(final long nativeHandle,
-    final long maxBytes);
-
-  private static native long newWriteBatch(final int reserved_bytes);
-  private static native long newWriteBatch(final byte[] serialized, final int serializedLength);
-  private native void iterate(final long handle, final long handlerHandle)
-      throws RocksDBException;
-  private native byte[] data(final long nativeHandle) throws RocksDBException;
-  private native long getDataSize(final long nativeHandle);
-  private native boolean hasPut(final long nativeHandle);
-  private native boolean hasDelete(final long nativeHandle);
-  private native boolean hasSingleDelete(final long nativeHandle);
-  private native boolean hasDeleteRange(final long nativeHandle);
-  private native boolean hasMerge(final long nativeHandle);
-  private native boolean hasBeginPrepare(final long nativeHandle);
-  private native boolean hasEndPrepare(final long nativeHandle);
-  private native boolean hasCommit(final long nativeHandle);
-  private native boolean hasRollback(final long nativeHandle);
-  private native void markWalTerminationPoint(final long nativeHandle);
-  private native SavePoint getWalTerminationPoint(final long nativeHandle);
-
-  /**
-   * Handler callback for iterating over the contents of a batch.
-   */
-  public abstract static class Handler extends RocksCallbackObject {
-    public Handler() {
-      super(0L);
-    }
-
-    @Override
-    protected long initializeNative(final long... nativeParameterHandles) {
-      return createNewHandler0();
-    }
-
-    public abstract void put(final int columnFamilyId, final byte[] key,
-        final byte[] value) throws RocksDBException;
-    public abstract void put(final byte[] key, final byte[] value);
-    public abstract void merge(final int columnFamilyId, final byte[] key,
-        final byte[] value) throws RocksDBException;
-    public abstract void merge(final byte[] key, final byte[] value);
-    public abstract void delete(final int columnFamilyId, final byte[] key)
-        throws RocksDBException;
-    public abstract void delete(final byte[] key);
-    public abstract void singleDelete(final int columnFamilyId,
-        final byte[] key) throws RocksDBException;
-    public abstract void singleDelete(final byte[] key);
-    public abstract void deleteRange(final int columnFamilyId,
-        final byte[] beginKey, final byte[] endKey) throws RocksDBException;
-    public abstract void deleteRange(final byte[] beginKey,
-        final byte[] endKey);
-    public abstract void logData(final byte[] blob);
-    public abstract void putBlobIndex(final int columnFamilyId,
-        final byte[] key, final byte[] value) throws RocksDBException;
-    public abstract void markBeginPrepare() throws RocksDBException;
-    public abstract void markEndPrepare(final byte[] xid)
-        throws RocksDBException;
-    public abstract void markNoop(final boolean emptyBatch)
-        throws RocksDBException;
-    public abstract void markRollback(final byte[] xid)
-        throws RocksDBException;
-    public abstract void markCommit(final byte[] xid)
-        throws RocksDBException;
-    public abstract void markCommitWithTimestamp(final byte[] xid, final byte[] ts)
-        throws RocksDBException;
-
-    /**
-     * shouldContinue is called by the underlying iterator
-     * {@link WriteBatch#iterate(Handler)}. If it returns false,
-     * iteration is halted. Otherwise, it continues
-     * iterating. The default implementation always
-     * returns true.
-     *
-     * @return boolean value indicating if the
-     *     iteration is halted.
-     */
-    public boolean shouldContinue() {
-      return true;
-    }
-
-    private native long createNewHandler0();
-  }
-
-  /**
-   * A structure for describing the save point in the Write Batch.
-   */
-  public static class SavePoint {
-    private long size;
-    private long count;
-    private long contentFlags;
-
-    public SavePoint(final long size, final long count,
-        final long contentFlags) {
-      this.size = size;
-      this.count = count;
-      this.contentFlags = contentFlags;
-    }
-
-    public void clear() {
-      this.size = 0;
-      this.count = 0;
-      this.contentFlags = 0;
-    }
-
-    /**
-     * Get the size of the serialized representation.
-     *
-     * @return the size of the serialized representation.
-     */
-    public long getSize() {
-      return size;
-    }
-
-    /**
-     * Get the number of elements.
-     *
-     * @return the number of elements.
-     */
-    public long getCount() {
-      return count;
-    }
-
-    /**
-     * Get the content flags.
-     *
-     * @return the content flags.
-     */
-    public long getContentFlags() {
-      return contentFlags;
-    }
-
-    public boolean isCleared() {
-      return (size | count | contentFlags) == 0;
-    }
-  }
-}

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

@@ -1,283 +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 a Write Batch which
- * holds a collection of updates to apply atomically to a DB.</p>
- */
-public interface WriteBatchInterface {
-
-    /**
-     * Returns the number of updates in the batch.
-     *
-     * @return number of items in WriteBatch
-     */
-    int count();
-
-    /**
-     * <p>Store the mapping "key-&gt;value" in the database.</p>
-     *
-     * @param key the specified key to be inserted.
-     * @param value the value associated with the specified key.
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void put(byte[] key, byte[] value) throws RocksDBException;
-
-    /**
-     * <p>Store the mapping "key-&gt;value" within given column
-     * family.</p>
-     *
-     * @param columnFamilyHandle {@link org.rocksdb.ColumnFamilyHandle}
-     *     instance
-     * @param key the specified key to be inserted.
-     * @param value the value associated with the specified key.
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void put(ColumnFamilyHandle columnFamilyHandle, byte[] key, byte[] value)
-        throws RocksDBException;
-
-    /**
-     * <p>Store the mapping "key-&gt;value" within given column
-     * family.</p>
-     *
-     * @param key the specified key to be inserted. It is using position and limit.
-     *     Supports direct buffer only.
-     * @param value the value associated with the specified key. It is using position and limit.
-     *     Supports direct buffer only.
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void put(final ByteBuffer key, final ByteBuffer value) throws RocksDBException;
-
-    /**
-     * <p>Store the mapping "key-&gt;value" within given column
-     * family.</p>
-     *
-     * @param columnFamilyHandle {@link org.rocksdb.ColumnFamilyHandle}
-     *     instance
-     * @param key the specified key to be inserted. It is using position and limit.
-     *     Supports direct buffer only.
-     * @param value the value associated with the specified key. It is using position and limit.
-     *     Supports direct buffer only.
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void put(ColumnFamilyHandle columnFamilyHandle, final ByteBuffer key, final ByteBuffer value)
-        throws RocksDBException;
-
-    /**
-     * <p>Merge "value" with the existing value of "key" in the database.
-     * "key-&gt;merge(existing, value)"</p>
-     *
-     * @param key the specified key to be merged.
-     * @param value the value to be merged with the current value for
-     * the specified key.
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void merge(byte[] key, byte[] value) throws RocksDBException;
-
-    /**
-     * <p>Merge "value" with the existing value of "key" in given column family.
-     * "key-&gt;merge(existing, value)"</p>
-     *
-     * @param columnFamilyHandle {@link ColumnFamilyHandle} instance
-     * @param key the specified key to be merged.
-     * @param value the value to be merged with the current value for
-     * the specified key.
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void merge(ColumnFamilyHandle columnFamilyHandle, byte[] key, byte[] value)
-        throws RocksDBException;
-
-    /**
-     * <p>If the database contains a mapping for "key", erase it.  Else do nothing.</p>
-     *
-     * @param key Key to delete within database
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void delete(byte[] key) throws RocksDBException;
-
-    /**
-     * <p>If column family contains a mapping for "key", erase it.  Else do nothing.</p>
-     *
-     * @param columnFamilyHandle {@link ColumnFamilyHandle} instance
-     * @param key Key to delete within database
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void delete(ColumnFamilyHandle columnFamilyHandle, byte[] key) throws RocksDBException;
-
-    /**
-     * <p>If column family contains a mapping for "key", erase it.  Else do nothing.</p>
-     *
-     * @param key Key to delete within database. It is using position and limit.
-     *     Supports direct buffer only.
-     *
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void delete(final ByteBuffer key) throws RocksDBException;
-
-    /**
-     * <p>If column family contains a mapping for "key", erase it.  Else do nothing.</p>
-     *
-     * @param columnFamilyHandle {@link ColumnFamilyHandle} instance
-     * @param key Key to delete within database. It is using position and limit.
-     *     Supports direct buffer only.
-     *
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void delete(ColumnFamilyHandle columnFamilyHandle, final ByteBuffer key)
-        throws RocksDBException;
-
-    /**
-     * Remove the database entry for {@code key}. Requires that the key exists
-     * and was not overwritten. It is not an error if the key did not exist
-     * in the database.
-     * <p>
-     * If a key is overwritten (by calling {@link #put(byte[], byte[])} multiple
-     * times), then the result of calling SingleDelete() on this key is undefined.
-     * SingleDelete() only behaves correctly if there has been only one Put()
-     * for this key since the previous call to SingleDelete() for this key.
-     * <p>
-     * This feature is currently an experimental performance optimization
-     * for a very specific workload. It is up to the caller to ensure that
-     * SingleDelete is only used for a key that is not deleted using Delete() or
-     * written using Merge(). Mixing SingleDelete operations with Deletes and
-     * Merges can result in undefined behavior.
-     *
-     * @param key Key to delete within database
-     *
-     * @throws RocksDBException thrown if error happens in underlying
-     *     native library.
-     */
-    @Experimental("Performance optimization for a very specific workload")
-    void singleDelete(final byte[] key) throws RocksDBException;
-
-    /**
-     * Remove the database entry for {@code key}. Requires that the key exists
-     * and was not overwritten. It is not an error if the key did not exist
-     * in the database.
-     * <p>
-     * If a key is overwritten (by calling {@link #put(byte[], byte[])} multiple
-     * times), then the result of calling SingleDelete() on this key is undefined.
-     * SingleDelete() only behaves correctly if there has been only one Put()
-     * for this key since the previous call to SingleDelete() for this key.
-     * <p>
-     * This feature is currently an experimental performance optimization
-     * for a very specific workload. It is up to the caller to ensure that
-     * SingleDelete is only used for a key that is not deleted using Delete() or
-     * written using Merge(). Mixing SingleDelete operations with Deletes and
-     * Merges can result in undefined behavior.
-     *
-     * @param columnFamilyHandle The column family to delete the key from
-     * @param key Key to delete within database
-     *
-     * @throws RocksDBException thrown if error happens in underlying
-     *     native library.
-     */
-    @Experimental("Performance optimization for a very specific workload")
-    void singleDelete(final ColumnFamilyHandle columnFamilyHandle, final byte[] key)
-        throws RocksDBException;
-
-    /**
-     * Removes the database entries in the range ["beginKey", "endKey"), i.e.,
-     * including "beginKey" and excluding "endKey". a non-OK status on error. It
-     * is not an error if no keys exist in the range ["beginKey", "endKey").
-     * <p>
-     * Delete the database entry (if any) for "key". Returns OK on success, and a
-     * non-OK status on error. It is not an error if "key" did not exist in the
-     * database.
-     *
-     * @param beginKey
-     *          First key to delete within database (included)
-     * @param endKey
-     *          Last key to delete within database (excluded)
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void deleteRange(byte[] beginKey, byte[] endKey) throws RocksDBException;
-
-    /**
-     * Removes the database entries in the range ["beginKey", "endKey"), i.e.,
-     * including "beginKey" and excluding "endKey". a non-OK status on error. It
-     * is not an error if no keys exist in the range ["beginKey", "endKey").
-     * <p>
-     * Delete the database entry (if any) for "key". Returns OK on success, and a
-     * non-OK status on error. It is not an error if "key" did not exist in the
-     * database.
-     *
-     * @param columnFamilyHandle {@link ColumnFamilyHandle} instance
-     * @param beginKey
-     *          First key to delete within database (included)
-     * @param endKey
-     *          Last key to delete within database (excluded)
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void deleteRange(ColumnFamilyHandle columnFamilyHandle, byte[] beginKey, byte[] endKey)
-        throws RocksDBException;
-
-    /**
-     * Append a blob of arbitrary size to the records in this batch. The blob will
-     * be stored in the transaction log but not in any other file. In particular,
-     * it will not be persisted to the SST files. When iterating over this
-     * WriteBatch, WriteBatch::Handler::LogData will be called with the contents
-     * of the blob as it is encountered. Blobs, puts, deletes, and merges will be
-     * encountered in the same order in which they were inserted. The blob will
-     * NOT consume sequence number(s) and will NOT increase the count of the batch
-     * <p>
-     * Example application: add timestamps to the transaction log for use in
-     * replication.
-     *
-     * @param blob binary object to be inserted
-     * @throws RocksDBException thrown if error happens in underlying native library.
-     */
-    void putLogData(byte[] blob) throws RocksDBException;
-
-    /**
-     * Clear all updates buffered in this batch
-     */
-    void clear();
-
-    /**
-     * Records the state of the batch for future calls to RollbackToSavePoint().
-     * May be called multiple times to set multiple save points.
-     */
-    void setSavePoint();
-
-    /**
-     * Remove all entries in this batch (Put, Merge, Delete, PutLogData) since
-     * the most recent call to SetSavePoint() and removes the most recent save
-     * point.
-     *
-     * @throws RocksDBException if there is no previous call to SetSavePoint()
-     */
-    void rollbackToSavePoint() throws RocksDBException;
-
-    /**
-     * Pop the most recent save point.
-     * <p>
-     * That is to say that it removes the last save point,
-     * which was set by {@link #setSavePoint()}.
-     *
-     * @throws RocksDBException If there is no previous call to
-     *     {@link #setSavePoint()}, an exception with
-     *     {@link Status.Code#NotFound} will be thrown.
-     */
-    void popSavePoint() throws RocksDBException;
-
-    /**
-     * Set the maximum size of the write batch.
-     *
-     * @param maxBytes the maximum size in bytes.
-     */
-    void setMaxBytes(long maxBytes);
-
-    /**
-     * Get the underlying Write Batch.
-     *
-     * @return the underlying WriteBatch.
-     */
-    WriteBatch getWriteBatch();
-}