feat(core) Add update and delete command Java/Rest APIs

engine-rest/engine-rest-openapi/src/main/templates/paths/process-instance/{id}/comment/delete.ftl

@@ -0,0 +1,56 @@
+<#macro endpoint_macro docsUrl="">
+  {
+    <@lib.endpointInfo
+        id = "deleteProcessInstanceComments"
+        tag = "Process Instance Comment"
+        summary = "Delete ProcessInstance Comments"
+        desc = "Deletes all comments of a process instance by id." />
+
+  "parameters": [
+
+    <@lib.parameter
+        name = "id"
+        location = "path"
+        type = "string"
+        required = true
+        last = true
+        desc = "The id of the process instance for which all comments are to be deleted."/>
+
+  ],
+  "responses": {
+
+    <@lib.response
+        code = "204"
+        desc = "Request successful." />
+
+    <@lib.response
+        code = "400"
+        dto = "ExceptionDto"
+        last = true
+        desc = "Returned if a given process instance id is invalid.
+                See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling) for the error response format."/>
+
+    <@lib.response
+        code = "401"
+        dto = "ExceptionDto"
+        desc = "The authenticated user is unauthorized to delete this resource. See the
+                        [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                        for the error response format."/>
+
+    <@lib.response
+        code = "403"
+        dto = "AuthorizationExceptionDto"
+        desc = "The history of the engine is disabled. See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                        for the error response format." />
+
+    <@lib.response
+        code = "500"
+        dto = "ExceptionDto"
+        last = true
+        desc = "Comments of a process instance could not be deleted successfully.
+                            See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                            for the error response format." />
+
+   }
+  }
+</#macro>

engine-rest/engine-rest-openapi/src/main/templates/paths/process-instance/{id}/comment/get.ftl

@@ -3,7 +3,7 @@
 
   <@lib.endpointInfo
       id = "getProcessInstanceComments"
-      tag = "Process Instance"
+      tag = "Process Instance comment"
       summary = "Get Process Instance Comments"
       desc = "Gets the comments for a process instance by id." />
 

engine-rest/engine-rest-openapi/src/main/templates/paths/process-instance/{id}/comment/put.ftl

@@ -0,0 +1,71 @@
+<#macro endpoint_macro docsUrl="">
+  {
+
+    <@lib.endpointInfo
+        id = "updateProcessInstanceComment"
+        tag = "Process Instance Comment"
+        summary = "Update"
+        desc = "Updates a Comment." />
+
+  "parameters" : [
+
+    <@lib.parameter
+        name = "id"
+        location = "path"
+        type = "string"
+        required = true
+        last = true
+        desc = "The id associated of a process instance of a comment to be updated."/>
+
+  ],
+
+    <@lib.requestBody
+        mediaType = "application/json"
+        dto = "CommentDto"
+        requestDesc = "**Note:** Only the `id` and `message` properties will be used. Every other
+          property passed to this endpoint will be ignored."
+        examples = ['"example-1": {
+                             "summary": "PUT /process-instance/aProcessInstanceId/comment",
+                             "value": {
+                                "id": "75bc161a-12da-11e4-7d3a-f4ccdc10a445",
+                                "message": "a process instance comment"
+                             }
+                           }'] />
+
+  "responses" : {
+
+    <@lib.response
+        code = "204"
+        desc = "Request successful."  />
+
+    <@lib.response
+        code = "400"
+        dto = "ExceptionDto"
+        desc = "Returned if a given process instance id or comment id is invalid.
+                See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling) for the error response format."/>
+
+    <@lib.response
+        code = "401"
+        dto = "ExceptionDto"
+        desc = "The authenticated user is unauthorized to update this resource. See the
+                    [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                    for the error response format." />
+
+    <@lib.response
+        code = "403"
+        dto = "AuthorizationExceptionDto"
+        desc = "The history of the engine is disabled. See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                    for the error response format." />
+
+    <@lib.response
+        code = "500"
+        dto = "ExceptionDto"
+        last = true
+        desc = "The comment of a process instance could not be updated successfully.
+                    See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                    for the error response format." />
+
+   }
+  }
+
+</#macro>

engine-rest/engine-rest-openapi/src/main/templates/paths/process-instance/{id}/comment/{commentId}/delete.ftl

@@ -0,0 +1,66 @@
+<#macro endpoint_macro docsUrl="">
+  {
+
+    <@lib.endpointInfo
+        id = "deleteProcessInstanceComment"
+        tag = "Process Instance Comment"
+        summary = "Delete"
+        desc = "Removes a comment from a process instance by id." />
+
+  "parameters" : [
+
+    <@lib.parameter
+        name = "id"
+        location = "path"
+        type = "string"
+        required = true
+        desc = "The id of the process instance." />
+
+    <@lib.parameter
+        name = "commentId"
+        location = "path"
+        type = "string"
+        required = true
+        last = true
+        desc = "The id of the comment to be removed." />
+
+  ],
+
+  "responses" : {
+
+    <@lib.response
+        code = "204"
+        desc = "Request successful." />
+
+    <@lib.response
+        code = "400"
+        dto = "ExceptionDto"
+        last = true
+        desc = "Returned if a given process instance id or comment id is invalid.
+                See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling) for the error response format."/>
+
+    <@lib.response
+        code = "401"
+        dto = "ExceptionDto"
+        desc = "The authenticated user is unauthorized to delete this resource. See the
+                        [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                        for the error response format." />
+
+    <@lib.response
+        code = "403"
+        dto = "AuthorizationExceptionDto"
+        desc = "The history of the engine is disabled. See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                    for the error response format." />
+
+    <@lib.response
+        code = "500"
+        dto = "ExceptionDto"
+        last = true
+        desc = "The comment of a process instance could not be deleted successfully.
+                    See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                    for the error response format." />
+
+    }
+  }
+
+</#macro>

engine-rest/engine-rest-openapi/src/main/templates/paths/task/{id}/comment/delete.ftl

@@ -0,0 +1,56 @@
+<#macro endpoint_macro docsUrl="">
+  {
+    <@lib.endpointInfo
+        id = "deleteTaskComments"
+        tag = "Task Comment"
+        summary = "Delete Task Comments"
+        desc = "Deletes all comments of a task by task id." />
+
+  "parameters": [
+
+    <@lib.parameter
+        name = "id"
+        location = "path"
+        type = "string"
+        required = true
+        last = true
+        desc = "The id of the task for which all comments are to be deleted."/>
+
+  ],
+  "responses": {
+
+    <@lib.response
+        code = "204"
+        desc = "Request successful." />
+
+    <@lib.response
+        code = "400"
+        dto = "ExceptionDto"
+        last = true
+        desc = "Returned if a given task id is invalid.
+                See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling) for the error response format."/>
+
+    <@lib.response
+        code = "401"
+        dto = "ExceptionDto"
+        desc = "The authenticated user is unauthorized to delete this resource. See the
+                        [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                        for the error response format."
+    />
+
+    <@lib.response
+        code = "403"
+        dto = "AuthorizationExceptionDto"
+        desc = "The history of the engine is disabled. See the [Introduction](/reference/rest/overview/#error-handling)
+                        for the error response format." />
+
+    <@lib.response
+        code = "500"
+        dto = "ExceptionDto"
+        last = true
+        desc = "Comments of a task could not be deleted successfully.
+                                See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                                for the error response format." />
+    }
+  }
+</#macro>

engine-rest/engine-rest-openapi/src/main/templates/paths/task/{id}/comment/put.ftl

@@ -0,0 +1,71 @@
+<#macro endpoint_macro docsUrl="">
+  {
+
+    <@lib.endpointInfo
+        id = "updateTaskComment"
+        tag = "Task Comment"
+        summary = "Update"
+        desc = "Updates a Comment." />
+
+  "parameters" : [
+
+    <@lib.parameter
+        name = "id"
+        location = "path"
+        type = "string"
+        required = true
+        last = true
+        desc = "The id associated of a task of a comment to be updated."/>
+
+  ],
+
+    <@lib.requestBody
+        mediaType = "application/json"
+        dto = "CommentDto"
+        requestDesc = "**Note:** Only the `id` and `message` properties will be used. Every other
+          property passed to this endpoint will be ignored."
+        examples = ['"example-1": {
+                             "summary": "PUT /task/aTaskId/comment",
+                             "value": {
+                                "id": "86cd272a-23ea-22e5-8e4a-e5bded20a556",
+                                "message": "a task comment"
+                             }
+                           }'] />
+
+  "responses" : {
+
+    <@lib.response
+        code = "204"
+        desc = "Request successful."  />
+
+    <@lib.response
+        code = "400"
+        dto = "ExceptionDto"
+        last = true
+        desc = "Returned if a given task id or comment id is invalid.
+                See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling) for the error response format."/>
+
+    <@lib.response
+        code = "401"
+        dto = "ExceptionDto"
+        desc = "The authenticated user is unauthorized to update this resource. See the
+                        [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                        for the error response format."/>
+
+    <@lib.response
+        code = "403"
+        dto = "AuthorizationExceptionDto"
+        desc = "The history of the engine is disabled. See the [Introduction](/reference/rest/overview/#error-handling)
+                        for the error response format." />
+
+    <@lib.response
+        code = "500"
+        dto = "ExceptionDto"
+        last = true
+        desc = "The comment of a task could not be updated successfully.
+                                See the [Introduction](${docsUrl}/reference/rest/overview/#error-handling)
+                                for the error response format." />
+   }
+  }
+
+</#macro>