Add annotations for use in algorithm development to deal with unparsed JSON

Author: pmcq

src/main/java/com/algorithmia/algo/AcceptsJson.java

@@ -0,0 +1,16 @@
+package com.algorithmia.algo;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * For algorithm development, labels an apply method indicating it
+ * should be passed in the raw/unparsed JSON input from the user.  If the user did not call
+ * the algorithm with a JSON content-type, this apply method will not be called.
+ * <b>Note: You can only have a single apply method if you use @AcceptsJson</b>
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface AcceptsJson {}

src/main/java/com/algorithmia/algo/ReturnsJson.java

@@ -0,0 +1,15 @@
+package com.algorithmia.algo;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * For algorithm development, indicates that a java method is returning a JSON-serialized String.
+ * This will result in the API server returning a Content-Type of JSON.  If the String returned is
+ * not valid JSON, then the call will result in a JSON parsing exception.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.METHOD)
+public @interface ReturnsJson {}