Add BinaryValue constructor that takes a Base64-encoded string.

Author: gmfeinberg

CHANGELOG.md

@@ -20,6 +20,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/).
 - Cloud only: Added new SignatureProvider constructors to allow use of an instance
 principal with a delegation token for authorization and authentication:
  - SignatureProvider.createInstancePrincipalForDelegation()
+ - BinaryValue constructor to create BinaryValue from a Base64-encoded string
 
 ### Fixed
 - Ensure that TableLimits is always null in TableResult on-premise.

driver/src/main/java/oracle/nosql/driver/values/BinaryValue.java

@@ -38,6 +38,20 @@ public BinaryValue(byte[] value) {
         this.value = value;
     }
 
+    /**
+     * Creates a new instance from a Base64 encoded string.
+     *
+     * @param value the value to use
+     *
+     * @throws IllegalArgumentException if the value is not a valid Base64
+     * encoded value.
+     */
+    public BinaryValue(String value) {
+        super();
+        requireNonNull(value, "BinaryValue: value must be non-null");
+        this.value = decodeBase64(value);
+    }
+
     @Override
     public Type getType() {
         return Type.BINARY;
@@ -116,6 +130,9 @@ public static String encodeBase64(byte[] buffer) {
      * @param binString the encoded input string
      *
      * @return the decoded array
+     *
+     * @throws IllegalArgumentException if the value is not a valid Base64
+     * encoded value.
      */
     public static byte[] decodeBase64(String binString) {
         requireNonNull(binString,

driver/src/test/java/oracle/nosql/driver/ValueTest.java

@@ -932,6 +932,28 @@ public void testFieldCreator() throws Exception {
         }
     }
 
+    /*
+     * Test BinaryValue constructor that takes a Base64-encoded string
+     */
+    @Test
+    public void testBinary() throws Exception {
+        final String testString = "abcdefg";
+        final byte[] byteValue = testString.getBytes();
+        final String encodedString = BinaryValue.encodeBase64(byteValue);
+
+        BinaryValue value1 = new BinaryValue(byteValue);
+        BinaryValue value2 = new BinaryValue(encodedString);
+
+        assertEquals(value1, value2);
+
+        try {
+            value1 = new BinaryValue(testString);
+            fail("Cast to BinaryValue should have failed");
+        } catch (IllegalArgumentException e) {
+            // success
+        }
+    }
+
     private void assertSize(FieldValue val, int size) {
         /* Leave for future debugging:
          * System.out.println("assertSize: " + val + ", " +