new serializer API

Author: rashtao

src/main/java/com/arangodb/serde/ArangoSerde.java

@@ -0,0 +1,55 @@
+package com.arangodb.serde;
+
+import java.lang.reflect.Type;
+
+/**
+ * Contract for serialization/deserialization of user data.
+ * Implementations of this interface could be used for customizing serialization/deserialization of user related data
+ * using serialization/deserialization libraries other than Jackson Databind, like:
+ * - serialization libraries for specific JVM languages (e.g. Scala, Kotlin, ...)
+ * - serialization libraries already in use in frameworks (e.g. JSON-B, Micronaut Serialization, ...)
+ * - high performance serialization libraries (e.g. supporting compile-time databinding code generation)
+ * - lower level libraries without support to data binding
+ * <p>
+ * This interface should not be implemented as an adapter to Jackson Databind, since already existing implementations
+ * can be instantiated providing a custom configured Jackson ObjectMapper, see {@link JsonSerde#...} and {@link VPackSerde#...}.
+ */
+public interface ArangoSerde {
+
+    /**
+     * @return the data type supported by this implementation
+     */
+    DataType getDataType();
+
+    /**
+     * Serializes the object into the target data type. For data type {@link DataType#JSON}, the serialized JSON string
+     * must be encoded into a byte array using the UTF-8 charset.
+     *
+     * @param value object to serialize
+     * @return serialized byte array
+     */
+    byte[] serialize(Object value);
+
+    /**
+     * Deserializes the content and binds it to the target data type.
+     * For data type {@link DataType#JSON}, the byte array is the JSON string encoded using the UTF-8 charset.
+     *
+     * @param content byte array to deserialize
+     * @param clazz   class of target data type
+     * @return deserialized object
+     */
+    default <T> T deserialize(byte[] content, Class<T> clazz) {
+        return deserialize(content, (Type) clazz);
+    }
+
+    /**
+     * Deserializes the content and binds it to the target data type.
+     * For data type {@link DataType#JSON}, the byte array is the JSON string encoded using the UTF-8 charset.
+     *
+     * @param content byte array to deserialize
+     * @param type    target data type
+     * @return deserialized object
+     */
+    <T> T deserialize(byte[] content, Type type);
+
+}

src/main/java/com/arangodb/serde/DataType.java

@@ -0,0 +1,24 @@
+/*
+ * DISCLAIMER
+ *
+ * Copyright 2016 ArangoDB GmbH, Cologne, Germany
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * Copyright holder is ArangoDB GmbH, Cologne, Germany
+ */
+package com.arangodb.serde;
+
+public enum DataType {
+    JSON, VPACK
+}

src/main/java/com/arangodb/serde/InternalSerde.java

@@ -0,0 +1,50 @@
+package com.arangodb.serde;
+
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.lang.reflect.Type;
+
+/**
+ * Internal serializer/deserializer based on Jackson Databind.
+ */
+public interface InternalSerde extends ArangoSerde {
+
+    /**
+     * Used for logging and debugging.
+     *
+     * @param content byte array
+     * @return JSON string
+     */
+    String toJsonString(byte[] content);
+
+    /**
+     * Extract the nested content pointed by the json pointer.
+     * Used for extracting nested user data.
+     *
+     * @param content     byte array
+     * @param jsonPointer location of user data
+     * @return byte array
+     */
+    byte[] extract(byte[] content, String jsonPointer);
+
+    /**
+     * Deserializes the parsed json node and binds it to the target data type.
+     *
+     * @param node  parsed json node
+     * @param clazz class of target data type
+     * @return deserialized object
+     */
+    default <T> T deserialize(JsonNode node, Class<T> clazz) {
+        return deserialize(node, (Type) clazz);
+    }
+
+    /**
+     * Deserializes the parsed json node and binds it to the target data type.
+     *
+     * @param node parsed json node
+     * @param type target data type
+     * @return deserialized object
+     */
+    <T> T deserialize(JsonNode node, Type type);
+
+}