Add Temperature and CacheTier enums for Java bindings

Author: mike-evolved

java/src/main/java/org/rocksdb/CacheTier.java

@@ -0,0 +1,54 @@
+package org.rocksdb;
+
+/**
+ * The control option of how the cache tiers will be used.
+ * Currently RocksDB supports block cache (volatile tier) and
+ * secondary cache (non-volatile tier).
+ */
+public enum CacheTier {
+  /**
+   * Volatile tier only (traditional block cache)
+   */
+  VOLATILE_TIER((byte) 0x00),
+
+  /**
+   * Volatile compressed tier
+   */
+  VOLATILE_COMPRESSED_TIER((byte) 0x01),
+
+  /**
+   * Non-volatile block tier (secondary cache)
+   */
+  NON_VOLATILE_BLOCK_TIER((byte) 0x02);
+
+  private final byte value;
+
+  CacheTier(final byte value) {
+    this.value = value;
+  }
+
+  /**
+   * Get the internal byte value.
+   *
+   * @return the internal byte value
+   */
+  public byte getValue() {
+    return value;
+  }
+
+  /**
+   * Get CacheTier by byte value.
+   *
+   * @param value the byte value representing CacheTier
+   * @return {@link CacheTier} instance or null
+   * @throws IllegalArgumentException if an invalid value is provided
+   */
+  public static CacheTier getCacheTier(final byte value) {
+    for (final CacheTier cacheTier : CacheTier.values()) {
+      if (cacheTier.getValue() == value) {
+        return cacheTier;
+      }
+    }
+    throw new IllegalArgumentException("Illegal value provided for CacheTier: " + value);
+  }
+}

java/src/main/java/org/rocksdb/Temperature.java

@@ -0,0 +1,69 @@
+package org.rocksdb;
+
+/**
+ * Temperature of a file. Used to pass to FileSystem for a different
+ * placement and/or coding.
+ * Reserve some numbers in the middle for potential future use.
+ */
+public enum Temperature {
+  /**
+   * Unknown temperature, default value
+   */
+  UNKNOWN((byte) 0),
+
+  /**
+   * Hot data, accessed frequently
+   */
+  HOT((byte) 0x04),
+
+  /**
+   * Warm data, accessed occasionally  
+   */
+  WARM((byte) 0x08),
+
+  /**
+   * Cool data, less frequently accessed
+   */
+  COOL((byte) 0x0A),
+
+  /**
+   * Cold data, rarely accessed
+   */
+  COLD((byte) 0x0C),
+
+  /**
+   * Ice data, very rarely accessed (archive tier)
+   */
+  ICE((byte) 0x10);
+
+  private final byte value;
+
+  Temperature(final byte value) {
+    this.value = value;
+  }
+
+  /**
+   * Get the internal byte value.
+   *
+   * @return the internal byte value
+   */
+  public byte getValue() {
+    return value;
+  }
+
+  /**
+   * Get Temperature by byte value.
+   *
+   * @param value the byte value representing Temperature
+   * @return {@link Temperature} instance
+   * @throws IllegalArgumentException if an invalid value is provided
+   */
+  public static Temperature getTemperature(final byte value) {
+    for (final Temperature temperature : Temperature.values()) {
+      if (temperature.getValue() == value) {
+        return temperature;
+      }
+    }
+    throw new IllegalArgumentException("Illegal value provided for Temperature: " + value);
+  }
+}