Add metadata overloads + cover them with tests

Author: pomadchin

src/main/java/io/tiledb/java/api/Array.java

@@ -615,6 +615,24 @@ public HashMap<String, Pair<Long, Long>> maxBufferElements(NativeArray subarray)
     return ret;
   }
 
+  /**
+   * Get a metadata key-value HashMap from an open array. The array must be opened in READ mode,
+   * otherwise the function will error out.
+   *
+   * @return HashMap<String, NativeArray> which contains all the metadata
+   * @throws TileDBError A TileDB exception
+   */
+  public HashMap<String, NativeArray> getMetadataMap() throws TileDBError {
+    HashMap<String, NativeArray> ret = new HashMap<String, NativeArray>();
+
+    for (long i = 0; i < getMetadataNum().longValue(); i++) {
+      Pair<String, NativeArray> p = getMetadataFromIndex(i);
+      ret.put(p.getFirst(), p.getSecond());
+    }
+
+    return ret;
+  }
+
   /**
    * Get a metadata key-value item from an open array. The array must be opened in READ mode,
    * otherwise the function will error out.
@@ -767,6 +785,19 @@ public Boolean hasMetadataKey(String key) throws TileDBError {
     return result;
   }
 
+  /**
+   * Puts a metadata key-value item to an open array. The array must be opened in WRITE mode,
+   * otherwise the function will error out.
+   *
+   * @param key a key to assign to the input value
+   * @param buffer the metadata to put into the Array metadata
+   * @param javaType javaType of the metadata
+   * @throws TileDBError A TileDB exception
+   */
+  public void putMetadata(String key, Object buffer, Class javaType) throws TileDBError {
+    putMetadata(key, new NativeArray(ctx, buffer, javaType));
+  }
+
   /**
    * Puts a metadata key-value item to an open array. The array must be opened in WRITE mode,
    * otherwise the function will error out.

src/test/java/io/tiledb/java/api/ArrayTest.java

@@ -9,6 +9,8 @@
 import java.nio.charset.StandardCharsets;
 import java.sql.Timestamp;
 import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
 import org.junit.*;
 import org.junit.rules.TemporaryFolder;
 
@@ -393,6 +395,26 @@ public void testArrayMetadata() throws Exception {
       Assert.assertArrayEquals(getArray(expectedArrays[i]), getArray(a.toJavaArray()));
     }
 
+    // getMetadataMap test
+    HashMap<String, Object> expectedArraysMap =
+        new HashMap<String, Object>() {
+          {
+            put(byteKey, metadataByte.toJavaArray());
+            put(doubleKey, metadataDouble.toJavaArray());
+            put(floatKey, metadataFloat.toJavaArray());
+            put(intKey, metadataInt.toJavaArray());
+            put(shortKey, metadataShort.toJavaArray());
+          }
+        };
+
+    HashMap<String, NativeArray> actualMetadataMap = arrayn.getMetadataMap();
+
+    for (Map.Entry<String, NativeArray> entry : actualMetadataMap.entrySet()) {
+      String key = entry.getKey();
+      Object value = entry.getValue().toJavaArray();
+      Assert.assertArrayEquals(getArray(expectedArraysMap.get(key)), getArray(value));
+    }
+
     arrayn.close();
 
     // open a new write session
@@ -415,4 +437,34 @@ public void testArrayMetadata() throws Exception {
 
     arraydn.close();
   }
+
+  @Test
+  public void testArrayPutMetadataOverload() throws Exception {
+    Array.create(arrayURI, schemaCreate());
+
+    long[] array_a = new long[] {1, 2, 3, 6};
+    insertArbitraryValues(new NativeArray(ctx, array_a, Long.class));
+
+    Array arrayw = new Array(ctx, arrayURI, TILEDB_WRITE);
+
+    String floatKey = "md-float";
+    float[] metadataFloat =
+        new float[] {
+          0.1f, 0.2f, 1.1f, 1.2f, 2.1f, 2.2f, 3.1f, 3.2f,
+          4.1f, 4.2f, 5.1f, 5.2f, 6.1f, 6.2f, 7.1f, 7.2f,
+          8.1f, 8.2f, 9.1f, 9.2f, 10.1f, 10.2f, 11.1f, 11.2f,
+          12.1f, 12.2f, 13.1f, 13.2f, 14.1f, 14.2f, 15.1f, 15.2f
+        };
+
+    arrayw.putMetadata(floatKey, metadataFloat, Float.class);
+    arrayw.close();
+
+    Array array = new Array(ctx, arrayURI, TILEDB_READ);
+
+    float[] metadataFloatActual = (float[]) array.getMetadata(floatKey).toJavaArray();
+
+    Assert.assertArrayEquals(metadataFloat, metadataFloatActual, 1e-10f);
+
+    array.close();
+  }
 }