Merge "Javadoc and logging improvement"

diff --cc mso-api-handlers/mso-api-handler-infra/src/main/java/org/onap/so/apihandlerinfra/ServiceInstances.java
index b1d3898,bc9c603..9b72bdc
--- 1/mso-api-handlers/mso-api-handler-infra/src/main/java/org/onap/so/apihandlerinfra/ServiceInstances.java
--- 2/mso-api-handlers/mso-api-handler-infra/src/main/java/org/onap/so/apihandlerinfra/ServiceInstances.java
+++ b/mso-api-handlers/mso-api-handler-infra/src/main/java/org/onap/so/apihandlerinfra/ServiceInstances.java
@@@ -766,15 -760,29 +764,36 @@@ public class ServiceInstances extends A
                  requestHandlerUtils.getRequestUri(requestContext, uriPrefix));
      }
  
+     /**
+      * This method is used for POST a request to the BPEL client (BPMN).
+      *
+      * Convert the requestJson to ServiceInstanceRequest(sir), create the msoRequest object, check whether this request
+      * is already being processed in requestdb for duplicate check.
+      *
+      * Based on the alacarte flag, sir and msoRequest will do the recipe lookup from the service and servicerecipe table
+      * of catalogdb, and get the OrchestrationURI.
+      *
+      * If the present request is not the duplicate request then this request will be saved in the requestdb. and will
+      * POST a request to the BPMN engine at the OrchestrationURI fetched.
+      *
+      * @param requestJSON Json fetched as body in the API call
+      * @param action Type of action to be performed
+      * @param instanceIdMap Map of instance ids of service/vnf/vf/configuration etc..
+      * @param version Supported version of API
+      * @param requestId Unique id for the request
+      * @param requestUri
+      * @return response object
+      * @throws ApiException
+      */
      public Response serviceInstances(String requestJSON, Actions action, HashMap<String, String> instanceIdMap,
              String version, String requestId, String requestUri) throws ApiException {
 +        return serviceInstances(requestJSON, action, instanceIdMap, version, requestId, requestUri, null);
 +
 +    }
 +
 +    public Response serviceInstances(String requestJSON, Actions action, HashMap<String, String> instanceIdMap,
 +            String version, String requestId, String requestUri, HashMap<String, String> queryParams)
 +            throws ApiException {
          String serviceInstanceId;
          Boolean aLaCarte = null;
          ServiceInstancesRequest sir;