Merge branch 'master' of https://github.com/ProcessMaker/spark-docker-executor-java

Author: caleeli

README.md

@@ -0,0 +1,55 @@
+# spark-docker-executor-java
+Script Task Executor Engine with Java Runtime
+
+This docker image provides a sandboxed protected environment to run custom Java scripts that are written in ProcessMaker Spark.
+
+## How to use
+The execution requires a data.json, config.json and an output.json file be present on the host system. The data.json represents the 
+Request instance data.  The config.json represents configuration specific for this Script Task. And the output.json should be a blank 
+file that will be populated by the successful output of the script task. The script task is represented by a script.Java file.
+It is the responsibility of the caller to have these files prepared before executing the engine via command line (or docker API).
+
+
+### Example data.json
+```json
+{
+  "x": 100,
+  "y": 200
+}
+```
+
+### Example Script Task
+```Java
+import ProcessMaker_Client.ApiClient;
+import java.io.*;
+import java.util.Map;
+
+public class Script implements BaseScript {
+
+    /**
+    * This code receives a data.x and data.y and returns data.z = data.x + data.y
+    */
+    public void execute(Map<String, Object> data, Map<String, Object> config, Map<String, Object> output) {
+        //Map<String, Object> data = Spark.data();
+        Double x = (Double) data.get("x");
+        Double y = (Double) data.get("y");
+        Double z = x + y;
+        output.put("z", z);
+    }
+}
+```
+
+### Example output.json
+```json
+{"z":300.0}
+```
+
+## Command Line Usage
+```bash
+$ docker run -v <path to local data.json>:/opt/executor/data.json \
+  -v <path to local config.json>:/opt/executor/config.json \
+  -v <path to local script.Java>:/opt/executor/script.Java \
+  -v <path to local output.json>:/opt/executor/output.json \
+  processmaker/spark-docker-executor-java:dev-master \
+  /opt/executor/run.sh
+```