improved javadoc, overridden default execute in MessageSendTask

Added throws ErrorBoundaryEvent to default execute method of
MessageSendTask to document that custom error handling flows can be
implemented in BPMN by throwing ErrorBoundaryEvent

Author: hhund

dsf-bpe/dsf-bpe-process-api-v2/src/main/java/dev/dsf/bpe/v2/activity/MessageSendTask.java

@@ -1,10 +1,43 @@
 package dev.dsf.bpe.v2.activity;
 
+import org.hl7.fhir.r4.model.Task;
+
+import dev.dsf.bpe.v2.ProcessPluginApi;
+import dev.dsf.bpe.v2.activity.task.BusinessKeyStrategy;
+import dev.dsf.bpe.v2.activity.task.TaskSender;
+import dev.dsf.bpe.v2.activity.values.SendTaskValues;
+import dev.dsf.bpe.v2.error.ErrorBoundaryEvent;
 import dev.dsf.bpe.v2.error.MessageSendTaskErrorHandler;
 import dev.dsf.bpe.v2.error.impl.DefaultMessageSendTaskErrorHandler;
+import dev.dsf.bpe.v2.variables.Variables;
 
 public interface MessageSendTask extends MessageActivity
 {
+	/**
+	 * Default implementation uses a {@link TaskSender} from
+	 * {@link #getTaskSender(ProcessPluginApi, Variables, SendTaskValues)} to send {@link Task} resources with the
+	 * {@link BusinessKeyStrategy} from {@link #getBusinessKeyStrategy()}. No {@link ErrorBoundaryEvent} are thrown by
+	 * the default implementation.
+	 *
+	 * @param api
+	 *            not <code>null</code>
+	 * @param variables
+	 *            not <code>null</code>
+	 * @param sendTaskValues
+	 *            not <code>null</code>
+	 * @throws ErrorBoundaryEvent
+	 *             to trigger custom error handling flow in BPMN, when using {@link DefaultMessageSendTaskErrorHandler}
+	 * @throws Exception
+	 *             to fail the FHIR {@link Task} and stop the process instance, when using
+	 *             {@link DefaultMessageSendTaskErrorHandler}
+	 */
+	@Override
+	default void execute(ProcessPluginApi api, Variables variables, SendTaskValues sendTaskValues)
+			throws ErrorBoundaryEvent, Exception
+	{
+		getTaskSender(api, variables, sendTaskValues).send();
+	}
+
 	@Override
 	default MessageSendTaskErrorHandler getErrorHandler()
 	{

dsf-bpe/dsf-bpe-process-api-v2/src/main/java/dev/dsf/bpe/v2/activity/ServiceTask.java

@@ -1,5 +1,7 @@
 package dev.dsf.bpe.v2.activity;
 
+import org.hl7.fhir.r4.model.Task;
+
 import dev.dsf.bpe.v2.ProcessPluginApi;
 import dev.dsf.bpe.v2.error.ErrorBoundaryEvent;
 import dev.dsf.bpe.v2.error.ServiceTaskErrorHandler;
@@ -8,6 +10,17 @@
 
 public interface ServiceTask extends Activity
 {
+	/**
+	 * @param api
+	 *            not <code>null</code>
+	 * @param variables
+	 *            not <code>null</code>
+	 * @throws ErrorBoundaryEvent
+	 *             to trigger custom error handling flow in BPMN, when using {@link DefaultServiceTaskErrorHandler}
+	 * @throws Exception
+	 *             to fail the FHIR {@link Task} and stop the process instance, when using
+	 *             {@link DefaultServiceTaskErrorHandler}
+	 */
 	void execute(ProcessPluginApi api, Variables variables) throws ErrorBoundaryEvent, Exception;
 
 	@Override