rocksdb-native 0.0.0 → 0.0.1

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

@@ -1,368 +0,0 @@
-// Copyright (c) Facebook, Inc. and its affiliates. All Rights Reserved.
-package org.rocksdb;
-
-import java.util.*;
-
-public abstract class AbstractMutableOptions {
-
-  protected static final String KEY_VALUE_PAIR_SEPARATOR = ";";
-  protected static final char KEY_VALUE_SEPARATOR = '=';
-  static final String INT_ARRAY_INT_SEPARATOR = ":";
-
-  protected final String[] keys;
-  private final String[] values;
-
-  /**
-   * User must use builder pattern, or parser.
-   *
-   * @param keys the keys
-   * @param values the values
-   */
-  protected AbstractMutableOptions(final String[] keys, final String[] values) {
-    this.keys = keys;
-    this.values = values;
-  }
-
-  String[] getKeys() {
-    return keys;
-  }
-
-  String[] getValues() {
-    return values;
-  }
-
-  /**
-   * Returns a string representation of MutableOptions which
-   * is suitable for consumption by {@code #parse(String)}.
-   *
-   * @return String representation of MutableOptions
-   */
-  @Override
-  public String toString() {
-    final StringBuilder buffer = new StringBuilder();
-    for(int i = 0; i < keys.length; i++) {
-      buffer
-          .append(keys[i])
-          .append(KEY_VALUE_SEPARATOR)
-          .append(values[i]);
-
-      if(i + 1 < keys.length) {
-        buffer.append(KEY_VALUE_PAIR_SEPARATOR);
-      }
-    }
-    return buffer.toString();
-  }
-
-  public abstract static class AbstractMutableOptionsBuilder<
-      T extends AbstractMutableOptions, U extends AbstractMutableOptionsBuilder<T, U, K>, K
-          extends MutableOptionKey> {
-    private final Map<K, MutableOptionValue<?>> options = new LinkedHashMap<>();
-    private final List<OptionString.Entry> unknown = new ArrayList<>();
-
-    protected abstract U self();
-
-    /**
-     * Get all the possible keys
-     *
-     * @return A map of all keys, indexed by name.
-     */
-    protected abstract Map<String, K> allKeys();
-
-    /**
-     * Construct a subclass instance of {@link AbstractMutableOptions}.
-     *
-     * @param keys the keys
-     * @param values the values
-     *
-     * @return an instance of the options.
-     */
-    protected abstract T build(final String[] keys, final String[] values);
-
-    public T build() {
-      final String[] keys = new String[options.size()];
-      final String[] values = new String[options.size()];
-
-      int i = 0;
-      for (final Map.Entry<K, MutableOptionValue<?>> option : options.entrySet()) {
-        keys[i] = option.getKey().name();
-        values[i] = option.getValue().asString();
-        i++;
-      }
-
-      return build(keys, values);
-    }
-
-    protected U setDouble(
-       final K key, final double value) {
-      if (key.getValueType() != MutableOptionKey.ValueType.DOUBLE) {
-        throw new IllegalArgumentException(
-            key + " does not accept a double value");
-      }
-      options.put(key, MutableOptionValue.fromDouble(value));
-      return self();
-    }
-
-    protected double getDouble(final K key)
-        throws NoSuchElementException, NumberFormatException {
-      final MutableOptionValue<?> value = options.get(key);
-      if(value == null) {
-        throw new NoSuchElementException(key.name() + " has not been set");
-      }
-      return value.asDouble();
-    }
-
-    protected U setLong(
-        final K key, final long value) {
-      if(key.getValueType() != MutableOptionKey.ValueType.LONG) {
-        throw new IllegalArgumentException(
-            key + " does not accept a long value");
-      }
-      options.put(key, MutableOptionValue.fromLong(value));
-      return self();
-    }
-
-    protected long getLong(final K key)
-        throws NoSuchElementException, NumberFormatException {
-      final MutableOptionValue<?> value = options.get(key);
-      if(value == null) {
-        throw new NoSuchElementException(key.name() + " has not been set");
-      }
-      return value.asLong();
-    }
-
-    protected U setInt(
-        final K key, final int value) {
-      if(key.getValueType() != MutableOptionKey.ValueType.INT) {
-        throw new IllegalArgumentException(
-            key + " does not accept an integer value");
-      }
-      options.put(key, MutableOptionValue.fromInt(value));
-      return self();
-    }
-
-    protected int getInt(final K key)
-        throws NoSuchElementException, NumberFormatException {
-      final MutableOptionValue<?> value = options.get(key);
-      if(value == null) {
-        throw new NoSuchElementException(key.name() + " has not been set");
-      }
-      return value.asInt();
-    }
-
-    protected U setBoolean(
-        final K key, final boolean value) {
-      if(key.getValueType() != MutableOptionKey.ValueType.BOOLEAN) {
-        throw new IllegalArgumentException(
-            key + " does not accept a boolean value");
-      }
-      options.put(key, MutableOptionValue.fromBoolean(value));
-      return self();
-    }
-
-    protected boolean getBoolean(final K key)
-        throws NoSuchElementException, NumberFormatException {
-      final MutableOptionValue<?> value = options.get(key);
-      if(value == null) {
-        throw new NoSuchElementException(key.name() + " has not been set");
-      }
-      return value.asBoolean();
-    }
-
-    protected U setIntArray(
-        final K key, final int[] value) {
-      if(key.getValueType() != MutableOptionKey.ValueType.INT_ARRAY) {
-        throw new IllegalArgumentException(
-            key + " does not accept an int array value");
-      }
-      options.put(key, MutableOptionValue.fromIntArray(value));
-      return self();
-    }
-
-    protected int[] getIntArray(final K key)
-        throws NoSuchElementException, NumberFormatException {
-      final MutableOptionValue<?> value = options.get(key);
-      if(value == null) {
-        throw new NoSuchElementException(key.name() + " has not been set");
-      }
-      return value.asIntArray();
-    }
-
-    protected <N extends Enum<N>> U setEnum(
-        final K key, final N value) {
-      if(key.getValueType() != MutableOptionKey.ValueType.ENUM) {
-        throw new IllegalArgumentException(
-            key + " does not accept a Enum value");
-      }
-      options.put(key, MutableOptionValue.fromEnum(value));
-      return self();
-    }
-
-    @SuppressWarnings("unchecked")
-    protected <N extends Enum<N>> N getEnum(final K key)
-        throws NoSuchElementException, NumberFormatException {
-      final MutableOptionValue<?> value = options.get(key);
-      if (value == null) {
-        throw new NoSuchElementException(key.name() + " has not been set");
-      }
-
-      if (!(value instanceof MutableOptionValue.MutableOptionEnumValue)) {
-        throw new NoSuchElementException(key.name() + " is not of Enum type");
-      }
-
-      return ((MutableOptionValue.MutableOptionEnumValue<N>) value).asObject();
-    }
-
-    /**
-     * Parse a string into a long value, accepting values expressed as a double (such as 9.00) which
-     * are meant to be a long, not a double
-     *
-     * @param value the string containing a value which represents a long
-     * @return the long value of the parsed string
-     */
-    private long parseAsLong(final String value) {
-      try {
-        return Long.parseLong(value);
-      } catch (final NumberFormatException nfe) {
-        final double doubleValue = Double.parseDouble(value);
-        if (doubleValue != Math.round(doubleValue))
-          throw new IllegalArgumentException("Unable to parse or round " + value + " to long");
-        return Math.round(doubleValue);
-      }
-    }
-
-    /**
-     * Parse a string into an int value, accepting values expressed as a double (such as 9.00) which
-     * are meant to be an int, not a double
-     *
-     * @param value the string containing a value which represents an int
-     * @return the int value of the parsed string
-     */
-    private int parseAsInt(final String value) {
-      try {
-        return Integer.parseInt(value);
-      } catch (final NumberFormatException nfe) {
-        final double doubleValue = Double.parseDouble(value);
-        if (doubleValue != Math.round(doubleValue))
-          throw new IllegalArgumentException("Unable to parse or round " + value + " to int");
-        return (int) Math.round(doubleValue);
-      }
-    }
-
-    /**
-     * Constructs a builder for mutable column family options from a hierarchical parsed options
-     * string representation. The {@link OptionString.Parser} class output has been used to create a
-     * (name,value)-list; each value may be either a simple string or a (name, value)-list in turn.
-     *
-     * @param options a list of parsed option string objects
-     * @param ignoreUnknown what to do if the key is not one of the keys we expect
-     *
-     * @return a builder with the values from the parsed input set
-     *
-     * @throws IllegalArgumentException if an option value is of the wrong type, or a key is empty
-     */
-    protected U fromParsed(final List<OptionString.Entry> options, final boolean ignoreUnknown) {
-      Objects.requireNonNull(options);
-
-      for (final OptionString.Entry option : options) {
-        try {
-          if (option.key.isEmpty()) {
-            throw new IllegalArgumentException("options string is invalid: " + option);
-          }
-          fromOptionString(option, ignoreUnknown);
-        } catch (final NumberFormatException nfe) {
-          throw new IllegalArgumentException(
-              "" + option.key + "=" + option.value + " - not a valid value for its type", nfe);
-        }
-      }
-
-      return self();
-    }
-
-    /**
-     * Set a value in the builder from the supplied option string
-     *
-     * @param option the option key/value to add to this builder
-     * @param ignoreUnknown if this is not set, throw an exception when a key is not in the known
-     *     set
-     * @return the same object, after adding options
-     * @throws IllegalArgumentException if the key is unknown, or a value has the wrong type/form
-     */
-    private U fromOptionString(final OptionString.Entry option, final boolean ignoreUnknown)
-        throws IllegalArgumentException {
-      Objects.requireNonNull(option.key);
-      Objects.requireNonNull(option.value);
-
-      final K key = allKeys().get(option.key);
-      if (key == null && ignoreUnknown) {
-        unknown.add(option);
-        return self();
-      } else if (key == null) {
-        throw new IllegalArgumentException("Key: " + null + " is not a known option key");
-      }
-
-      if (!option.value.isList()) {
-        throw new IllegalArgumentException(
-            "Option: " + key + " is not a simple value or list, don't know how to parse it");
-      }
-
-      // Check that simple values are the single item in the array
-      if (key.getValueType() != MutableOptionKey.ValueType.INT_ARRAY) {
-        {
-          if (option.value.list.size() != 1) {
-            throw new IllegalArgumentException(
-                "Simple value does not have exactly 1 item: " + option.value.list);
-          }
-        }
-      }
-
-      final List<String> valueStrs = option.value.list;
-      final String valueStr = valueStrs.get(0);
-
-      switch (key.getValueType()) {
-        case DOUBLE:
-          return setDouble(key, Double.parseDouble(valueStr));
-
-        case LONG:
-          return setLong(key, parseAsLong(valueStr));
-
-        case INT:
-          return setInt(key, parseAsInt(valueStr));
-
-        case BOOLEAN:
-          return setBoolean(key, Boolean.parseBoolean(valueStr));
-
-        case INT_ARRAY:
-          final int[] value = new int[valueStrs.size()];
-          for (int i = 0; i < valueStrs.size(); i++) {
-            value[i] = Integer.parseInt(valueStrs.get(i));
-          }
-          return setIntArray(key, value);
-
-        case ENUM:
-          final String optionName = key.name();
-          if (optionName.equals("prepopulate_blob_cache")) {
-            final PrepopulateBlobCache prepopulateBlobCache =
-                PrepopulateBlobCache.getFromInternal(valueStr);
-            return setEnum(key, prepopulateBlobCache);
-          } else if (optionName.equals("compression")
-              || optionName.equals("blob_compression_type")) {
-            final CompressionType compressionType = CompressionType.getFromInternal(valueStr);
-            return setEnum(key, compressionType);
-          } else {
-            throw new IllegalArgumentException("Unknown enum type: " + key.name());
-          }
-
-        default:
-          throw new IllegalStateException(key + " has unknown value type: " + key.getValueType());
-      }
-    }
-
-    /**
-     *
-     * @return the list of keys encountered which were not known to the type being generated
-     */
-    public List<OptionString.Entry> getUnknown() {
-      return new ArrayList<>(unknown);
-    }
-  }
-}

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

@@ -1,49 +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;
-
-/**
- * AbstractNativeReference is the base-class of all RocksDB classes that have
- * a pointer to a native C++ {@code rocksdb} object.
- * <p>
- * AbstractNativeReference has the {@link AbstractNativeReference#close()}
- * method, which frees its associated C++ object.</p>
- * <p>
- * This function should be called manually, or even better, called implicitly using a
- * <a
- * href="https://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html">try-with-resources</a>
- * statement, when you are finished with the object. It is no longer
- * called automatically during the regular Java GC process via finalization
- * {@link AbstractNativeReference#finalize()}.</p>
- * which is deprecated from Java 9.
- * <p>
- * Explanatory note - When or if the Garbage Collector calls {@link Object#finalize()}
- * depends on the JVM implementation and system conditions, which the programmer
- * cannot control. In addition, the GC cannot see through the native reference
- * long member variable (which is the C++ pointer value to the native object),
- * and cannot know what other resources depend on it.
- * </p>
- */
-public abstract class AbstractNativeReference implements AutoCloseable {
-  /**
-   * Returns true if we are responsible for freeing the underlying C++ object
-   *
-   * @return true if we are responsible to free the C++ object
-   */
-  protected abstract boolean isOwningHandle();
-
-  /**
-   * Frees the underlying C++ object
-   * <p>
-   * It is strong recommended that the developer calls this after they
-   * have finished using the object.</p>
-   * <p>
-   * Note, that once an instance of {@link AbstractNativeReference} has been
-   * closed, calling any of its functions will lead to undefined
-   * behavior.</p>
-   */
-  @Override public abstract void close();
-}

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

@@ -1,146 +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;
-
-/**
- * Base class implementation for Rocks Iterators
- * in the Java API
- *
- * <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>
- *
- * @param <P> The type of the Parent Object from which the Rocks Iterator was
- *          created. This is used by disposeInternal to avoid double-free
- *          issues with the underlying C++ object.
- * @see org.rocksdb.RocksObject
- */
-public abstract class AbstractRocksIterator<P extends RocksObject>
-    extends RocksObject implements RocksIteratorInterface {
-  final P parent_;
-
-  protected AbstractRocksIterator(final P parent,
-      final long nativeHandle) {
-    super(nativeHandle);
-    // parent must point to a valid RocksDB instance.
-    assert (parent != null);
-    // RocksIterator must hold a reference to the related parent instance
-    // to guarantee that while a GC cycle starts RocksIterator instances
-    // are freed prior to parent instances.
-    parent_ = parent;
-  }
-
-  @Override
-  public boolean isValid() {
-    assert (isOwningHandle());
-    return isValid0(nativeHandle_);
-  }
-
-  @Override
-  public void seekToFirst() {
-    assert (isOwningHandle());
-    seekToFirst0(nativeHandle_);
-  }
-
-  @Override
-  public void seekToLast() {
-    assert (isOwningHandle());
-    seekToLast0(nativeHandle_);
-  }
-
-  @Override
-  public void seek(final byte[] target) {
-    assert (isOwningHandle());
-    seek0(nativeHandle_, target, target.length);
-  }
-
-  @Override
-  public void seekForPrev(final byte[] target) {
-    assert (isOwningHandle());
-    seekForPrev0(nativeHandle_, target, target.length);
-  }
-
-  @Override
-  public void seek(final ByteBuffer target) {
-    assert (isOwningHandle());
-    if (target.isDirect()) {
-      seekDirect0(nativeHandle_, target, target.position(), target.remaining());
-    } else {
-      seekByteArray0(nativeHandle_, target.array(), target.arrayOffset() + target.position(),
-          target.remaining());
-    }
-    target.position(target.limit());
-  }
-
-  @Override
-  public void seekForPrev(final ByteBuffer target) {
-    assert (isOwningHandle());
-    if (target.isDirect()) {
-      seekForPrevDirect0(nativeHandle_, target, target.position(), target.remaining());
-    } else {
-      seekForPrevByteArray0(nativeHandle_, target.array(), target.arrayOffset() + target.position(),
-          target.remaining());
-    }
-    target.position(target.limit());
-  }
-
-  @Override
-  public void next() {
-    assert (isOwningHandle());
-    next0(nativeHandle_);
-  }
-
-  @Override
-  public void prev() {
-    assert (isOwningHandle());
-    prev0(nativeHandle_);
-  }
-
-  @Override
-  public void refresh() throws RocksDBException {
-    assert (isOwningHandle());
-    refresh0(nativeHandle_);
-  }
-
-  @Override
-  public void status() throws RocksDBException {
-    assert (isOwningHandle());
-    status0(nativeHandle_);
-  }
-
-  /**
-   * <p>Deletes underlying C++ iterator pointer.</p>
-   *
-   * <p>Note: the underlying handle can only be safely deleted if the parent
-   * instance related to a certain RocksIterator is still valid and initialized.
-   * Therefore {@code disposeInternal()} checks if the parent is initialized
-   * before freeing the native handle.</p>
-   */
-  @Override
-  protected void disposeInternal() {
-      if (parent_.isOwningHandle()) {
-        disposeInternal(nativeHandle_);
-      }
-  }
-
-  abstract boolean isValid0(long handle);
-  abstract void seekToFirst0(long handle);
-  abstract void seekToLast0(long handle);
-  abstract void next0(long handle);
-  abstract void prev0(long handle);
-  abstract void refresh0(long handle) throws RocksDBException;
-  abstract void seek0(long handle, byte[] target, int targetLen);
-  abstract void seekForPrev0(long handle, byte[] target, int targetLen);
-  abstract void seekDirect0(long handle, ByteBuffer target, int targetOffset, int targetLen);
-  abstract void seekForPrevDirect0(long handle, ByteBuffer target, int targetOffset, int targetLen);
-  abstract void seekByteArray0(long handle, byte[] target, int targetOffset, int targetLen);
-  abstract void seekForPrevByteArray0(long handle, byte[] target, int targetOffset, int targetLen);
-
-  abstract void status0(long handle) throws RocksDBException;
-}