Add RibbonFilter Java bindings

Author: mike-evolved

java/src/main/java/org/rocksdb/FilterPolicyType.java

@@ -28,6 +28,8 @@ public enum FilterPolicyType {
   public Filter createFilter(final long handle, final double param) {
     if (this == kBloomFilterPolicy) {
       return new BloomFilter(handle, param);
+    } else if (this == kRibbonFilterPolicy) {
+      return new RibbonFilter(handle, param);
     }
     return null;
   }

java/src/main/java/org/rocksdb/RibbonFilter.java

@@ -0,0 +1,82 @@
+package org.rocksdb;
+
+import java.util.Objects;
+
+public class RibbonFilter extends Filter {
+
+  private static final double DEFAULT_BITS_PER_KEY = 10.0;
+  private static final int DEFAULT_BLOOM_BEFORE_LEVEL = -1;
+
+  private final double bitsPerKey;
+  private final int bloomBeforeLevel;
+
+  /**
+   * Creates a new Ribbon filter with default bits per key (10.0).
+   */
+  public RibbonFilter() {
+    this(DEFAULT_BITS_PER_KEY);
+  }
+
+  /**
+   * Creates a new Ribbon filter with the specified bits per key.
+   * Higher bits per key = lower false positive rate but more memory usage.
+   *
+   * @param bitsPerKey the number of bits per key (typical: 8-12)
+   */
+  public RibbonFilter(final double bitsPerKey) {
+    this(createNewRibbonFilter(bitsPerKey, DEFAULT_BLOOM_BEFORE_LEVEL), bitsPerKey, DEFAULT_BLOOM_BEFORE_LEVEL);
+  }
+
+  /**
+   * Internal constructor for FilterPolicyType
+   *
+   * @param nativeHandle handle to existing ribbon filter at RocksDB C++ side
+   * @param bitsPerKey number of bits to use - recorded for comparison
+   */
+  RibbonFilter(final long nativeHandle, final double bitsPerKey) {
+    this(nativeHandle, bitsPerKey, DEFAULT_BLOOM_BEFORE_LEVEL);
+  }
+
+  /**
+   * Creates a new Ribbon filter with bits per key and bloom_before_level.
+   * This allows using Bloom filters for hot levels and Ribbon for cold levels.
+   *
+   * @param bitsPerKey the number of bits per key (typical: 8-12)
+   * @param bloomBeforeLevel use Bloom filters for levels below this, Ribbon for levels at or above
+   *                         (-1 means always use Ribbon, 0 means use Bloom for L0, 1 means Bloom for L0-L1, etc.)
+   */
+  public RibbonFilter(final double bitsPerKey, final int bloomBeforeLevel) {
+    this(createNewRibbonFilter(bitsPerKey, bloomBeforeLevel), bitsPerKey, bloomBeforeLevel);
+  }
+
+  /**
+   * Internal constructor
+   *
+   * @param nativeHandle handle to existing ribbon filter at RocksDB C++ side
+   * @param bitsPerKey number of bits to use - recorded for comparison
+   * @param bloomBeforeLevel bloom before level setting - recorded for comparison
+   */
+  private RibbonFilter(final long nativeHandle, final double bitsPerKey, final int bloomBeforeLevel) {
+    super(nativeHandle);
+    this.bitsPerKey = bitsPerKey;
+    this.bloomBeforeLevel = bloomBeforeLevel;
+  }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o)
+      return true;
+    if (o == null || getClass() != o.getClass())
+      return false;
+    RibbonFilter that = (RibbonFilter) o;
+    return Double.compare(that.bitsPerKey, bitsPerKey) == 0 &&
+           bloomBeforeLevel == that.bloomBeforeLevel;
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(bitsPerKey, bloomBeforeLevel);
+  }
+
+  private static native long createNewRibbonFilter(final double bitsPerKey, final int bloomBeforeLevel);
+}