2 * Copyright © 2017-2018 AT&T Intellectual Property.
3 * Modifications Copyright © 2019 IBM.
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
18 package org.onap.ccsdk.cds.blueprintsprocessor.services.execution
21 import com.fasterxml.jackson.databind.JsonNode
22 import kotlinx.coroutines.withTimeout
23 import org.onap.ccsdk.cds.blueprintsprocessor.core.api.data.ExecutionServiceInput
24 import org.onap.ccsdk.cds.blueprintsprocessor.core.api.data.ExecutionServiceOutput
25 import org.onap.ccsdk.cds.blueprintsprocessor.core.api.data.Status
26 import org.onap.ccsdk.cds.blueprintsprocessor.core.api.data.StepData
27 import org.onap.ccsdk.cds.controllerblueprints.common.api.EventType
28 import org.onap.ccsdk.cds.controllerblueprints.core.*
29 import org.onap.ccsdk.cds.controllerblueprints.core.interfaces.BlueprintFunctionNode
30 import org.onap.ccsdk.cds.controllerblueprints.core.service.BluePrintRuntimeService
31 import org.onap.ccsdk.cds.controllerblueprints.core.service.BluePrintVelocityTemplateService
32 import org.slf4j.LoggerFactory
35 * AbstractComponentFunction
36 * @author Brinda Santh
38 abstract class AbstractComponentFunction : BlueprintFunctionNode<ExecutionServiceInput, ExecutionServiceOutput> {
40 private val log = LoggerFactory.getLogger(AbstractComponentFunction::class.java)
42 lateinit var executionServiceInput: ExecutionServiceInput
43 var executionServiceOutput = ExecutionServiceOutput()
44 lateinit var bluePrintRuntimeService: BluePrintRuntimeService<*>
45 lateinit var processId: String
46 lateinit var workflowName: String
47 lateinit var stepName: String
48 lateinit var interfaceName: String
49 lateinit var operationName: String
50 lateinit var nodeTemplateName: String
51 var timeout: Int = 180
52 var operationInputs: MutableMap<String, JsonNode> = hashMapOf()
54 override fun getName(): String {
58 override suspend fun prepareRequestNB(executionRequest: ExecutionServiceInput): ExecutionServiceInput {
59 checkNotNull(bluePrintRuntimeService) { "failed to prepare blueprint runtime" }
60 checkNotNull(executionRequest.stepData) { "failed to get step info" }
62 // Get the Step Name and Step Inputs
63 this.stepName = executionRequest.stepData!!.name
64 this.operationInputs = executionRequest.stepData!!.properties
66 checkNotEmpty(stepName) { "failed to get step name from step data" }
68 this.executionServiceInput = executionRequest
70 processId = executionRequest.commonHeader.requestId
71 check(processId.isNotEmpty()) { "couldn't get process id for step($stepName)" }
73 workflowName = executionRequest.actionIdentifiers.actionName
74 check(workflowName.isNotEmpty()) { "couldn't get action name for step($stepName)" }
76 log.info("preparing request id($processId) for workflow($workflowName) step($stepName)")
78 nodeTemplateName = this.operationInputs.getAsString(BluePrintConstants.PROPERTY_CURRENT_NODE_TEMPLATE)
79 check(nodeTemplateName.isNotEmpty()) { "couldn't get NodeTemplate name for step($stepName)" }
81 interfaceName = this.operationInputs.getAsString(BluePrintConstants.PROPERTY_CURRENT_INTERFACE)
82 check(interfaceName.isNotEmpty()) { "couldn't get Interface name for step($stepName)" }
84 operationName = this.operationInputs.getAsString(BluePrintConstants.PROPERTY_CURRENT_OPERATION)
85 check(operationName.isNotEmpty()) { "couldn't get Operation name for step($stepName)" }
87 val operationResolvedProperties = bluePrintRuntimeService
88 .resolveNodeTemplateInterfaceOperationInputs(nodeTemplateName, interfaceName, operationName)
90 this.operationInputs.putAll(operationResolvedProperties)
92 val timeout = this.operationInputs.getOptionalAsInt(BluePrintConstants.PROPERTY_CURRENT_TIMEOUT)
93 timeout?.let { this.timeout = timeout }
94 log.debug("DEBUG::: AbstractComponentFunction prepareRequestNB.timeout ($timeout)")
96 return executionRequest
99 override suspend fun prepareResponseNB(): ExecutionServiceOutput {
100 log.info("Preparing Response...")
101 executionServiceOutput.commonHeader = executionServiceInput.commonHeader
102 executionServiceOutput.actionIdentifiers = executionServiceInput.actionIdentifiers
103 val status = Status()
105 // Resolve the Output Expression
106 val stepOutputs = bluePrintRuntimeService
107 .resolveNodeTemplateInterfaceOperationOutputs(nodeTemplateName, interfaceName, operationName)
109 val stepOutputData = StepData().apply {
111 properties = stepOutputs
113 executionServiceOutput.stepData = stepOutputData
114 // Set the Default Step Status
115 status.eventType = EventType.EVENT_COMPONENT_EXECUTED.name
116 } catch (e: Exception) {
117 status.message = BluePrintConstants.STATUS_FAILURE
118 status.eventType = EventType.EVENT_COMPONENT_FAILURE.name
120 executionServiceOutput.status = status
121 return this.executionServiceOutput
124 override suspend fun applyNB(executionServiceInput: ExecutionServiceInput): ExecutionServiceOutput {
126 prepareRequestNB(executionServiceInput)
127 withTimeout(timeout * 1000L) {
128 log.debug("DEBUG::: AbstractComponentFunction.withTimeout section $timeout seconds")
129 processNB(executionServiceInput)
131 } catch (runtimeException: RuntimeException) {
132 log.error("failed in ${getName()} : ${runtimeException.message}", runtimeException)
133 recoverNB(runtimeException, executionServiceInput)
135 return prepareResponseNB()
138 fun getOperationInput(key: String): JsonNode {
139 return operationInputs[key]
140 ?: throw BluePrintProcessorException("couldn't get the operation input($key) value.")
143 fun getOptionalOperationInput(key: String): JsonNode? {
144 return operationInputs[key]
147 fun setAttribute(key: String, value: JsonNode) {
148 bluePrintRuntimeService.setNodeTemplateAttributeValue(nodeTemplateName, key, value)
151 fun addError(type: String, name: String, error: String) {
152 bluePrintRuntimeService.getBluePrintError().addError(type, name, error)
155 fun addError(error: String) {
156 bluePrintRuntimeService.getBluePrintError().addError(error)
160 * Get Execution Input Payload data
162 fun requestPayload(): JsonNode? {
163 return executionServiceInput.payload
167 * Get Execution Input payload action property with [expression]
168 * ex: requestPayloadActionProperty("data") will look for path "payload/<action-name>-request/data"
170 fun requestPayloadActionProperty(expression: String?): JsonNode? {
171 val requestExpression = if (expression.isNullOrBlank()) {
172 "$operationName-request"
174 "$operationName-request.$expression"
176 return executionServiceInput.payload.jsonPathParse(".$requestExpression")
179 fun artifactContent(artifactName: String): String {
180 return bluePrintRuntimeService.resolveNodeTemplateArtifact(nodeTemplateName, artifactName)
183 suspend fun mashTemplateNData(artifactName: String, json: String): String {
184 val content = artifactContent(artifactName)
185 return BluePrintVelocityTemplateService.generateContent(content, json)
188 suspend fun readLinesFromArtifact(artifactName: String): List<String> {
189 val artifactDefinition = bluePrintRuntimeService.resolveNodeTemplateArtifactDefinition(nodeTemplateName, artifactName)
190 val file = normalizedFile(bluePrintRuntimeService.bluePrintContext().rootPath, artifactDefinition.file)
191 return file.readNBLines()