added extension point for VelocyPack serialization

Author: mpv1989

ChangeLog

@@ -5,6 +5,7 @@ v4.1.11 (2017-03-xx)
 * fixed exception handling in Connection (issue #110)
 * added connection pooling (issue #103)
 * extracted VelocyPack implementation to https://github.com/arangodb/java-velocypack
+* added extension point for VelocyPack serialization (ArangoDBAsync.registerModule())
 * added dependency java-velocypack-module-jdk8
 * added support for replacing build-in VelocyPack serializer/deserializer
 * added ArangoDatabaseAsync.getVersion(), ArangoDatabaseAsync.getAccessibleDatabases()

README.md

@@ -48,6 +48,32 @@ If you want to test with a snapshot version (e.g. 4.0.0-SNAPSHOT), add the stagi
 mvn clean install -DskipTests=true -Dgpg.skip=true -Dmaven.javadoc.skip=true -B
 ```	
 
+## configure VelocyPack serialization
+
+Since version `4.1.11` you can extend the VelocyPack serialization by registering additional `VPackModule`s on `ArangoDB.Builder`.
+
+### Joda-Time
+
+Added support for:
+* org.joda.time.DateTime;
+* org.joda.time.Instant;
+* org.joda.time.LocalDate;
+* org.joda.time.LocalDateTime;
+
+```XML
+<dependencies>
+  <dependency>
+    <groupId>com.arangodb</groupId>
+    <artifactId>velocypack-module-joda</artifactId>
+    <version>1.0.0</version>
+  </dependency>
+</dependencies>
+```
+
+``` Java
+ArangoDBAsync arangoDB = new ArangoDBAsync.Builder().registerModule(new VPackJodaModule()).build();
+``` 
+
 # Learn more
 * [ArangoDB](https://www.arangodb.com/)
 * [Documentation](docs/documentation.md)

pom.xml

@@ -26,7 +26,7 @@
 		<hamcrest-all.version>1.3</hamcrest-all.version>
 		<junit.version>4.12</junit.version>
 		<arangodb-java-driver.version>${project.version}</arangodb-java-driver.version>
-		<arangodb.velocypack.module.jdk8.version>1.0.0</arangodb.velocypack.module.jdk8.version>
+		<arangodb.velocypack.module.jdk8.version>1.0.1</arangodb.velocypack.module.jdk8.version>
 	</properties>
 
 	<developers>

src/main/java/com/arangodb/ArangoDBAsync.java

@@ -68,6 +68,7 @@
 import com.arangodb.velocypack.VPackJsonSerializer;
 import com.arangodb.velocypack.VPackModule;
 import com.arangodb.velocypack.VPackParser;
+import com.arangodb.velocypack.VPackParserModule;
 import com.arangodb.velocypack.VPackSerializer;
 import com.arangodb.velocypack.ValueType;
 import com.arangodb.velocypack.module.jdk8.VPackJdk8Module;
@@ -284,11 +285,41 @@ public Builder registerModules(final VPackModule... modules) {
 			return this;
 		}
 
+		public Builder registerJsonModule(final VPackParserModule module) {
+			vpackParserBuilder.registerModule(module);
+			return this;
+		}
+
+		public Builder registerJsonModules(final VPackParserModule... module) {
+			vpackParserBuilder.registerModules(module);
+			return this;
+		}
+
+		/**
+		 * Replace the built-in serializer with the given serializer.
+		 * 
+		 * <br />
+		 * <b>ATTENTION!:</b> Use at your own risk
+		 * 
+		 * @param serializer
+		 *            custom serializer
+		 * @return builder
+		 */
 		public Builder setSerializer(final ArangoSerializer serializer) {
 			this.serializer = serializer;
 			return this;
 		}
 
+		/**
+		 * Replace the built-in deserializer with the given deserializer.
+		 * 
+		 * <br />
+		 * <b>ATTENTION!:</b> Use at your own risk
+		 * 
+		 * @param deserializer
+		 *            custom deserializer
+		 * @return builder
+		 */
 		public Builder setDeserializer(final ArangoDeserializer deserializer) {
 			this.deserializer = deserializer;
 			return this;