2 * ============LICENSE_START=======================================================
4 * ================================================================================
5 * Copyright (C) 2017 AT&T Intellectual Property. All rights reserved.
6 * Copyright (C) 2017 Huawei Technologies Co., Ltd. All rights reserved.
7 * ================================================================================
8 * Modifications Copyright (c) 2019 Samsung
9 * ================================================================================
10 * Modifications Copyright (c) 2020 Nokia
11 * ================================================================================
12 * Licensed under the Apache License, Version 2.0 (the "License");
13 * you may not use this file except in compliance with the License.
14 * You may obtain a copy of the License at
16 * http://www.apache.org/licenses/LICENSE-2.0
18 * Unless required by applicable law or agreed to in writing, software
19 * distributed under the License is distributed on an "AS IS" BASIS,
20 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 * See the License for the specific language governing permissions and
22 * limitations under the License.
23 * ============LICENSE_END=========================================================
26 package org.onap.so.apihandlerinfra;
28 import org.apache.http.HttpStatus;
29 import org.onap.so.apihandler.common.ErrorNumbers;
30 import org.onap.so.apihandler.common.RequestClientParameter;
31 import org.onap.so.apihandlerinfra.exceptions.ApiException;
32 import org.onap.so.apihandlerinfra.exceptions.RecipeNotFoundException;
33 import org.onap.so.apihandlerinfra.exceptions.RequestDbFailureException;
34 import org.onap.so.apihandlerinfra.exceptions.ValidateException;
35 import org.onap.so.apihandlerinfra.logging.ErrorLoggerInfo;
36 import org.onap.so.constants.Status;
37 import org.onap.so.db.catalog.beans.Workflow;
38 import org.onap.so.db.catalog.client.CatalogDbClient;
39 import org.onap.so.db.request.beans.InfraActiveRequests;
40 import org.onap.so.db.request.client.RequestsDbClient;
41 import org.onap.so.exceptions.ValidationException;
42 import org.onap.logging.filter.base.ErrorCode;
43 import org.onap.so.logger.MessageEnum;
44 import org.onap.so.serviceinstancebeans.ModelType;
45 import org.onap.so.serviceinstancebeans.RequestReferences;
46 import org.onap.so.serviceinstancebeans.ServiceInstancesRequest;
47 import org.onap.so.serviceinstancebeans.ServiceInstancesResponse;
48 import org.slf4j.Logger;
49 import org.slf4j.LoggerFactory;
50 import org.springframework.beans.factory.annotation.Autowired;
51 import org.springframework.stereotype.Component;
52 import javax.transaction.Transactional;
53 import javax.ws.rs.Consumes;
54 import javax.ws.rs.POST;
55 import javax.ws.rs.Path;
56 import javax.ws.rs.PathParam;
57 import javax.ws.rs.Produces;
58 import javax.ws.rs.container.ContainerRequestContext;
59 import javax.ws.rs.core.Context;
60 import javax.ws.rs.core.MediaType;
61 import javax.ws.rs.core.Response;
62 import java.io.IOException;
63 import java.util.HashMap;
64 import io.swagger.v3.oas.annotations.OpenAPIDefinition;
65 import io.swagger.v3.oas.annotations.Operation;
66 import io.swagger.v3.oas.annotations.info.Info;
67 import io.swagger.v3.oas.annotations.media.ArraySchema;
68 import io.swagger.v3.oas.annotations.media.Content;
69 import io.swagger.v3.oas.annotations.media.Schema;
70 import io.swagger.v3.oas.annotations.responses.ApiResponse;
73 @Path("/onap/so/infra/instanceManagement")
74 @OpenAPIDefinition(info = @Info(title = "/onap/so/infra/instanceManagement",
75 description = "Infrastructure API Requests for Instance Management"))
76 public class InstanceManagement {
78 private static Logger logger = LoggerFactory.getLogger(InstanceManagement.class);
79 private static String uriPrefix = "/instanceManagement/";
80 private static final String SAVE_TO_DB = "save instance to db";
83 private RequestsDbClient infraActiveRequestsClient;
86 private CatalogDbClient catalogDbClient;
89 private MsoRequest msoRequest;
92 private RequestHandlerUtils requestHandlerUtils;
95 @Path("/{version:[vV][1]}/serviceInstances/{serviceInstanceId}/vnfs/{vnfInstanceId}/workflows/{workflowUuid}")
96 @Consumes(MediaType.APPLICATION_JSON)
97 @Produces(MediaType.APPLICATION_JSON)
98 @Operation(description = "Execute custom VNF workflow", responses = @ApiResponse(
99 content = @Content(array = @ArraySchema(schema = @Schema(implementation = Response.class)))))
101 public Response executeVNFCustomWorkflow(String request, @PathParam("version") String version,
102 @PathParam("serviceInstanceId") String serviceInstanceId, @PathParam("vnfInstanceId") String vnfInstanceId,
103 @PathParam("workflowUuid") String workflowUuid, @Context ContainerRequestContext requestContext)
104 throws ApiException {
105 String requestId = requestHandlerUtils.getRequestId(requestContext);
106 HashMap<String, String> instanceIdMap = new HashMap<>();
107 instanceIdMap.put("serviceInstanceId", serviceInstanceId);
108 instanceIdMap.put("vnfInstanceId", vnfInstanceId);
109 instanceIdMap.put("workflowUuid", workflowUuid);
110 return processCustomWorkflowRequest(request, Action.inPlaceSoftwareUpdate, instanceIdMap, version, requestId,
115 @Path("/{version:[vV][1]}/serviceInstances/{serviceInstanceId}/pnfs/{pnfName}/workflows/{workflowUuid}")
116 @Consumes(MediaType.APPLICATION_JSON)
117 @Produces(MediaType.APPLICATION_JSON)
118 @Operation(description = "Execute custom PNF workflow", responses = @ApiResponse(
119 content = @Content(array = @ArraySchema(schema = @Schema(implementation = Response.class)))))
121 public Response executePNFCustomWorkflow(String request, @PathParam("version") String version,
122 @PathParam("serviceInstanceId") String serviceInstanceId, @PathParam("pnfName") String pnfName,
123 @PathParam("workflowUuid") String workflowUuid, @Context ContainerRequestContext requestContext)
124 throws ApiException {
125 String requestId = requestHandlerUtils.getRequestId(requestContext);
126 HashMap<String, String> instanceIdMap = new HashMap<>();
127 instanceIdMap.put("serviceInstanceId", serviceInstanceId);
128 instanceIdMap.put("pnfName", pnfName);
129 instanceIdMap.put("workflowUuid", workflowUuid);
130 return processPNFCustomWorkflowRequest(request, Action.forCustomWorkflow, instanceIdMap, version, requestId,
134 private Response processCustomWorkflowRequest(String requestJSON, Actions action,
135 HashMap<String, String> instanceIdMap, String version, String requestId,
136 ContainerRequestContext requestContext) throws ApiException {
137 String serviceInstanceId;
138 boolean aLaCarte = true;
139 ServiceInstancesRequest sir;
140 String apiVersion = version.substring(1);
142 String requestUri = requestHandlerUtils.getRequestUri(requestContext, uriPrefix);
144 sir = requestHandlerUtils.convertJsonToServiceInstanceRequest(requestJSON, action, requestId, requestUri);
145 String requestScope = requestHandlerUtils.deriveRequestScope(action, sir, requestUri);
146 InfraActiveRequests currentActiveReq =
147 msoRequest.createRequestObject(sir, action, requestId, Status.IN_PROGRESS, requestJSON, requestScope);
150 requestHandlerUtils.validateHeaders(requestContext);
151 } catch (ValidationException e) {
152 logger.error("Exception occurred", e);
153 ErrorLoggerInfo errorLoggerInfo =
154 new ErrorLoggerInfo.Builder(MessageEnum.APIH_VALIDATION_ERROR, ErrorCode.SchemaError)
155 .errorSource(Constants.MSO_PROP_APIHANDLER_INFRA).build();
156 ValidateException validateException =
157 new ValidateException.Builder(e.getMessage(), HttpStatus.SC_BAD_REQUEST,
158 ErrorNumbers.SVC_BAD_PARAMETER).cause(e).errorInfo(errorLoggerInfo).build();
159 requestHandlerUtils.updateStatus(currentActiveReq, Status.FAILED, validateException.getMessage());
160 throw validateException;
163 requestHandlerUtils.parseRequest(sir, instanceIdMap, action, version, requestJSON, aLaCarte, requestId,
165 requestHandlerUtils.setInstanceId(currentActiveReq, requestScope, null, instanceIdMap);
167 String vnfType = msoRequest.getVnfType(sir, requestScope);
169 if (requestScope.equalsIgnoreCase(ModelType.vnf.name()) && vnfType != null) {
170 currentActiveReq.setVnfType(vnfType);
173 checkDuplicateAndBuildError(action, instanceIdMap, requestScope, currentActiveReq);
175 ServiceInstancesResponse serviceResponse = new ServiceInstancesResponse();
177 RequestReferences referencesResponse = new RequestReferences();
179 referencesResponse.setRequestId(requestId);
181 serviceResponse.setRequestReferences(referencesResponse);
182 boolean isBaseVfModule = false;
184 String workflowUuid = null;
185 if (instanceIdMap != null) {
186 workflowUuid = instanceIdMap.get("workflowUuid");
189 RecipeLookupResult recipeLookupResult = getInstanceManagementWorkflowRecipe(currentActiveReq, workflowUuid);
191 String serviceInstanceType = requestHandlerUtils.getServiceType(requestScope, sir, true);
193 serviceInstanceId = requestHandlerUtils.setServiceInstanceId(requestScope, sir);
196 if (sir.getVnfInstanceId() != null) {
197 vnfId = sir.getVnfInstanceId();
200 saveCurrentActiveRequest(currentActiveReq);
202 RequestClientParameter requestClientParameter;
204 requestClientParameter = new RequestClientParameter.Builder().setRequestId(requestId)
205 .setBaseVfModule(isBaseVfModule).setRecipeTimeout(recipeLookupResult.getRecipeTimeout())
206 .setRequestAction(action.toString()).setServiceInstanceId(serviceInstanceId).setVnfId(vnfId)
207 .setServiceType(serviceInstanceType).setVnfType(vnfType)
208 .setRequestDetails(requestHandlerUtils.mapJSONtoMSOStyle(requestJSON, null, aLaCarte, action))
209 .setApiVersion(apiVersion).setALaCarte(aLaCarte).setRequestUri(requestUri).build();
210 } catch (IOException e) {
211 ErrorLoggerInfo errorLoggerInfo =
212 new ErrorLoggerInfo.Builder(MessageEnum.APIH_BPEL_RESPONSE_ERROR, ErrorCode.SchemaError)
213 .errorSource(Constants.MSO_PROP_APIHANDLER_INFRA).build();
214 throw new ValidateException.Builder("Unable to generate RequestClientParamter object" + e.getMessage(),
215 HttpStatus.SC_INTERNAL_SERVER_ERROR, ErrorNumbers.SVC_BAD_PARAMETER).errorInfo(errorLoggerInfo)
218 return requestHandlerUtils.postBPELRequest(currentActiveReq, requestClientParameter,
219 recipeLookupResult.getOrchestrationURI(), requestScope);
222 private void saveCurrentActiveRequest(InfraActiveRequests currentActiveReq) throws RequestDbFailureException {
224 infraActiveRequestsClient.save(currentActiveReq);
225 } catch (Exception e) {
226 ErrorLoggerInfo errorLoggerInfo =
227 new ErrorLoggerInfo.Builder(MessageEnum.APIH_DB_ACCESS_EXC, ErrorCode.DataError)
228 .errorSource(Constants.MSO_PROP_APIHANDLER_INFRA).build();
229 throw new RequestDbFailureException.Builder(SAVE_TO_DB, e.toString(), HttpStatus.SC_INTERNAL_SERVER_ERROR,
230 ErrorNumbers.SVC_DETAILED_SERVICE_ERROR).cause(e).errorInfo(errorLoggerInfo).build();
234 private void checkDuplicateAndBuildError(Actions action, HashMap<String, String> instanceIdMap, String requestScope,
235 InfraActiveRequests currentActiveReq) throws ApiException {
237 InfraActiveRequests dup =
238 requestHandlerUtils.duplicateCheck(action, instanceIdMap, null, requestScope, currentActiveReq);
243 boolean inProgress = requestHandlerUtils.camundaHistoryCheck(dup, currentActiveReq);
245 requestHandlerUtils.buildErrorOnDuplicateRecord(currentActiveReq, action, instanceIdMap, null, requestScope,
250 private Response processPNFCustomWorkflowRequest(String requestJSON, Actions action,
251 HashMap<String, String> instanceIdMap, String version, String requestId,
252 ContainerRequestContext requestContext) throws ApiException {
253 boolean aLaCarte = false;
254 ServiceInstancesRequest sir;
255 String apiVersion = version.substring(1);
257 String serviceInstanceId = "";
259 String workflowUuid = "";
260 if (instanceIdMap != null) {
261 serviceInstanceId = instanceIdMap.get("serviceInstanceId");
262 pnfName = instanceIdMap.get("pnfName");
263 workflowUuid = instanceIdMap.get("workflowUuid");
266 String requestUri = requestHandlerUtils.getRequestUri(requestContext, uriPrefix);
267 sir = requestHandlerUtils.convertJsonToServiceInstanceRequest(requestJSON, action, requestId, requestUri);
268 sir.setServiceInstanceId(serviceInstanceId);
269 sir.setPnfName(pnfName);
270 String requestScope = ModelType.pnf.name();
271 InfraActiveRequests currentActiveReq =
272 msoRequest.createRequestObject(sir, action, requestId, Status.IN_PROGRESS, requestJSON, requestScope);
275 requestHandlerUtils.validateHeaders(requestContext);
276 } catch (ValidationException e) {
277 logger.error("Exception occurred", e);
278 ErrorLoggerInfo errorLoggerInfo =
279 new ErrorLoggerInfo.Builder(MessageEnum.APIH_VALIDATION_ERROR, ErrorCode.SchemaError)
280 .errorSource(Constants.MSO_PROP_APIHANDLER_INFRA).build();
281 ValidateException validateException =
282 new ValidateException.Builder(e.getMessage(), HttpStatus.SC_BAD_REQUEST,
283 ErrorNumbers.SVC_BAD_PARAMETER).cause(e).errorInfo(errorLoggerInfo).build();
284 requestHandlerUtils.updateStatus(currentActiveReq, Status.FAILED, validateException.getMessage());
285 throw validateException;
288 requestHandlerUtils.parseRequest(sir, instanceIdMap, action, version, requestJSON, aLaCarte, requestId,
290 requestHandlerUtils.setInstanceId(currentActiveReq, requestScope, null, instanceIdMap);
292 checkDuplicateAndBuildError(action, instanceIdMap, requestScope, currentActiveReq);
294 RecipeLookupResult recipeLookupResult = getInstanceManagementWorkflowRecipe(currentActiveReq, workflowUuid);
296 saveCurrentActiveRequest(currentActiveReq);
298 RequestClientParameter requestClientParameter;
300 requestClientParameter = new RequestClientParameter.Builder().setRequestId(requestId)
301 .setRecipeTimeout(recipeLookupResult.getRecipeTimeout()).setRequestAction(action.toString())
302 .setServiceInstanceId(serviceInstanceId).setPnfCorrelationId(pnfName)
303 .setRequestDetails(requestHandlerUtils.mapJSONtoMSOStyle(requestJSON, null, aLaCarte, action))
304 .setApiVersion(apiVersion).setRequestUri(requestUri).build();
305 } catch (IOException e) {
306 ErrorLoggerInfo errorLoggerInfo =
307 new ErrorLoggerInfo.Builder(MessageEnum.APIH_BPEL_RESPONSE_ERROR, ErrorCode.SchemaError)
308 .errorSource(Constants.MSO_PROP_APIHANDLER_INFRA).build();
309 throw new ValidateException.Builder("Unable to generate RequestClientParamter object" + e.getMessage(),
310 HttpStatus.SC_INTERNAL_SERVER_ERROR, ErrorNumbers.SVC_BAD_PARAMETER).errorInfo(errorLoggerInfo)
313 return requestHandlerUtils.postBPELRequest(currentActiveReq, requestClientParameter,
314 recipeLookupResult.getOrchestrationURI(), requestScope);
317 private RecipeLookupResult getInstanceManagementWorkflowRecipe(InfraActiveRequests currentActiveReq,
318 String workflowUuid) throws ApiException {
319 RecipeLookupResult recipeLookupResult;
322 recipeLookupResult = getCustomWorkflowUri(workflowUuid);
323 } catch (Exception e) {
324 ErrorLoggerInfo errorLoggerInfo =
325 new ErrorLoggerInfo.Builder(MessageEnum.APIH_REQUEST_VALIDATION_ERROR, ErrorCode.SchemaError)
326 .errorSource(Constants.MSO_PROP_APIHANDLER_INFRA).build();
327 ValidateException validateException =
328 new ValidateException.Builder(e.getMessage(), HttpStatus.SC_BAD_REQUEST,
329 ErrorNumbers.SVC_BAD_PARAMETER).cause(e).errorInfo(errorLoggerInfo).build();
330 requestHandlerUtils.updateStatus(currentActiveReq, Status.FAILED, validateException.getMessage());
331 throw validateException;
334 if (recipeLookupResult == null) {
335 ErrorLoggerInfo errorLoggerInfo =
336 new ErrorLoggerInfo.Builder(MessageEnum.APIH_DB_ACCESS_EXC, ErrorCode.DataError)
337 .errorSource(Constants.MSO_PROP_APIHANDLER_INFRA).build();
338 RecipeNotFoundException recipeNotFoundExceptionException =
339 new RecipeNotFoundException.Builder("Recipe could not be retrieved from catalog DB.",
340 HttpStatus.SC_NOT_FOUND, ErrorNumbers.SVC_GENERAL_SERVICE_ERROR).errorInfo(errorLoggerInfo)
342 requestHandlerUtils.updateStatus(currentActiveReq, Status.FAILED,
343 recipeNotFoundExceptionException.getMessage());
344 throw recipeNotFoundExceptionException;
347 return recipeLookupResult;
350 private RecipeLookupResult getCustomWorkflowUri(String workflowUuid) {
352 Workflow workflow = catalogDbClient.findWorkflowByArtifactUUID(workflowUuid);
353 if (workflow != null) {
354 String workflowName = workflow.getName();
355 String recipeUri = "/mso/async/services/" + workflowName;
356 return new RecipeLookupResult(recipeUri, 180);