Added substantial functionality for the virtual lists, allowing database

operations to be executed against the database without going through
mapping to POJOs

Author: tim-aero

README.md

@@ -1602,6 +1602,9 @@ classes:
  - **setter**:
 
 
+## Virtual Lists
+
+When mapping a Java object to Aerospike the most common operations to do are to save the whole object and load the whole object. The AeroMapper is set up primarily for these use cases. However, there are cases where it makes sense to manipulate objects directly in the database, particularly when it comes to manipulating lists and maps. This functionality is provided via virtual lists.  
 
 ----
 
@@ -1610,7 +1613,7 @@ classes:
 - maps of embedded objects
 - lists of referenced objects
 - maps of referenced objects
-- Add in a method to add an entry to a collection, get a range from a collection, delete from a collection
+- Document virtual lists
 - Validate some of the limits, eg bin name length, set name length, etc.
 - Make all maps (esp Embedded ones) K_ORDERED
 - Add interface to adaptiveMap, including changing EmbedType

src/main/java/com/aerospike/mapper/tools/AeroMapper.java

@@ -5,4 +5,5 @@
 public interface DeferredOperation {
 	public Operation getOperation(OperationParameters operationParams);
 	public ResultsUnpacker[] getUnpackers(OperationParameters operationParams);
+	public boolean isGetOperation();
 }

src/main/java/com/aerospike/mapper/tools/DeferredOperation.java

@@ -2,7 +2,6 @@
 
 import javax.validation.constraints.NotNull;
 
-import com.aerospike.client.AerospikeException;
 import com.aerospike.client.Operation;
 
 public class Interactor {
@@ -23,9 +22,9 @@ public Interactor(@NotNull DeferredOperation deferredOperation) {
 		this.deferredParameters = new OperationParameters();
 	}
 
-	public void setNeedsResult(boolean needsResult) {
+	public void setNeedsResultOfType(ReturnType returnType) {
 		if (this.deferredParameters != null) {
-			this.deferredParameters.setNeedsResult(needsResult);
+			this.deferredParameters.setNeedsResultOfType(returnType);
 		}
 	}
 	public Operation getOperation() {
@@ -44,19 +43,24 @@ public Object getResult(Object rawResult) {
 		return result;
 	}
 	public boolean isWriteOperation() {
-		switch (operation.type) {
-		case ADD:
-		case APPEND:
-		case BIT_MODIFY:
-		case CDT_MODIFY:
-		case DELETE:
-		case MAP_MODIFY:
-		case PREPEND:
-		case TOUCH:
-		case WRITE:
-			return true;
-		default:
-			return false;
+		if (this.operation != null) {
+			switch (operation.type) {
+			case ADD:
+			case APPEND:
+			case BIT_MODIFY:
+			case CDT_MODIFY:
+			case DELETE:
+			case MAP_MODIFY:
+			case PREPEND:
+			case TOUCH:
+			case WRITE:
+				return true;
+			default:
+				return false;
+			}
+		}
+		else {
+			return !this.deferredOperation.isGetOperation();
 		}
 	}
 }

src/main/java/com/aerospike/mapper/tools/Interactor.java

@@ -1,18 +1,18 @@
 package com.aerospike.mapper.tools;
 
 public class OperationParameters {
-	private boolean needsResult;
+	private ReturnType needsResultOfType = ReturnType.NONE;
 
 	public OperationParameters() {
 	}
-	public OperationParameters(boolean needsResult) {
+	public OperationParameters(ReturnType needsResultOfType) {
 		super();
-		this.needsResult = needsResult;
+		this.needsResultOfType = needsResultOfType;
 	}
-	public boolean needsResult() {
-		return needsResult;
+	public ReturnType getNeedsResultOfType() {
+		return needsResultOfType;
 	}
-	public void setNeedsResult(boolean needsResult) {
-		this.needsResult = needsResult;
+	public void setNeedsResultOfType(ReturnType needsResultOfType) {
+		this.needsResultOfType = needsResultOfType;
 	}
 }

src/main/java/com/aerospike/mapper/tools/OperationParameters.java

@@ -0,0 +1,9 @@
+package com.aerospike.mapper.tools;
+
+public enum ReturnType {
+	DEFAULT,
+	COUNT,
+	INDEX,
+	ELEMENTS,
+	NONE
+}