Add exception to throw when meta tag is not a Map

src/main/java/com/github/jasminb/jsonapi/ResourceConverter.java

@@ -13,6 +13,7 @@
 import com.github.jasminb.jsonapi.annotations.Relationship;
 import com.github.jasminb.jsonapi.annotations.Type;
 import com.github.jasminb.jsonapi.exceptions.DocumentSerializationException;
+import com.github.jasminb.jsonapi.exceptions.InvalidMetaDataTypeException;
 import com.github.jasminb.jsonapi.exceptions.UnregisteredTypeException;
 import com.github.jasminb.jsonapi.models.errors.Error;
 
@@ -1026,10 +1027,9 @@ private Map<String, Link> mapLinks(JsonNode linksObject) {
 		try {
 			return objectMapper.readValue(p, mapType);
 		} catch (IOException e) {
-			// TODO: log? No recovery.
+			e.printStackTrace();
+			throw new InvalidMetaDataTypeException();
 		}
-
-		return null;
 	}
 
 	private ObjectNode addIncludedSection(ObjectNode rootNode, Map<String, ObjectNode> includedDataMap) {

src/main/java/com/github/jasminb/jsonapi/exceptions/InvalidMetaDataTypeException.java

@@ -0,0 +1,20 @@
+package com.github.jasminb.jsonapi.exceptions;
+
+/**
+ * InvalidMetaDataTypeException implementation. <br/>
+ * This exception is thrown when a <a href="http://jsonapi.org/format/#document-meta">JSON-API meta object</a>
+ * that is provided is not a {@code Map}. It may be an array instead of a type that can be de-serialized
+ * to a {@code Map}.
+ *
+ * @author ianrumac.
+ */
+
+public class InvalidMetaDataTypeException extends RuntimeException {
+
+    /**
+     * Creates a new InvalidMetaDataTypeException.
+     */
+    public InvalidMetaDataTypeException() {
+        super("Failed to parse JSON-API meta object to a Map type.");
+    }
+}

src/test/java/com/github/jasminb/jsonapi/ResourceConverterTest.java

@@ -6,6 +6,7 @@
 import com.fasterxml.jackson.databind.PropertyNamingStrategy;
 import com.github.jasminb.jsonapi.exceptions.DocumentSerializationException;
 import com.github.jasminb.jsonapi.exceptions.InvalidJsonApiResourceException;
+import com.github.jasminb.jsonapi.exceptions.InvalidMetaDataTypeException;
 import com.github.jasminb.jsonapi.exceptions.UnregisteredTypeException;
 import com.github.jasminb.jsonapi.models.Article;
 import com.github.jasminb.jsonapi.models.Author;
@@ -678,6 +679,12 @@ public void testReadMetaOnly() {
 		Assert.assertNotNull(status.getMeta());
 	}
 
+	@Test(expected = InvalidMetaDataTypeException.class)
+	public void testInvalidMetaData() throws IOException {
+		InputStream apiResponse = IOUtils.getResource("users-outside-meta-invalid.json");
+		converter.readDocumentCollection(apiResponse, User.class);
+	}
+
 	@Test
 	public void testUnregisteredType() throws IOException {
 		InputStream apiResponse = IOUtils.getResource("un-registered-type.json");

src/test/resources/users-outside-meta-invalid.json

@@ -0,0 +1,19 @@
+{
+  "meta":[],
+  "data": [
+    {
+      "type": "users",
+      "id": "1",
+      "attributes": {
+        "name": "liz"
+      }
+    },
+    {
+      "type": "users",
+      "id": "2",
+      "attributes": {
+        "name": "john"
+      }
+    }
+  ]
+}