ms/blueprintsprocessor/modules/inbounds/selfservice-api/src/main/kotlin/org/onap/ccsdk/cds/blueprintsprocessor/selfservice/api/ExecutionServiceController.kt

   1 /*
   2  * Copyright © 2017-2018 AT&T Intellectual Property.
   3  * Modifications Copyright © 2019 IBM, Bell Canada.
   4  *
   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
   8  *
   9  *     http://www.apache.org/licenses/LICENSE-2.0
  10  *
  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.
  16  */
  17
  18 package org.onap.ccsdk.cds.blueprintsprocessor.selfservice.api
  19
  20 import io.swagger.annotations.Api
  21 import io.swagger.annotations.ApiOperation
  22 import io.swagger.annotations.ApiParam
  23 import kotlinx.coroutines.Dispatchers
  24 import org.onap.ccsdk.cds.blueprintsprocessor.core.api.data.ACTION_MODE_ASYNC
  25 import org.onap.ccsdk.cds.blueprintsprocessor.core.api.data.ExecutionServiceInput
  26 import org.onap.ccsdk.cds.blueprintsprocessor.core.api.data.ExecutionServiceOutput
  27 import org.onap.ccsdk.cds.blueprintsprocessor.rest.service.monoMdc
  28 import org.onap.ccsdk.cds.blueprintsprocessor.selfservice.api.utils.determineHttpStatusCode
  29 import org.onap.ccsdk.cds.controllerblueprints.core.asJsonPrimitive
  30 import org.onap.ccsdk.cds.controllerblueprints.core.logger
  31 import org.springframework.beans.factory.annotation.Autowired
  32 import org.springframework.http.MediaType
  33 import org.springframework.http.ResponseEntity
  34 import org.springframework.security.access.prepost.PreAuthorize
  35 import org.springframework.web.bind.annotation.RequestBody
  36 import org.springframework.web.bind.annotation.RequestMapping
  37 import org.springframework.web.bind.annotation.RequestMethod
  38 import org.springframework.web.bind.annotation.ResponseBody
  39 import org.springframework.web.bind.annotation.RestController
  40 import reactor.core.publisher.Mono
  41 import java.util.concurrent.Phaser
  42 import javax.annotation.PreDestroy
  43
  44 @RestController
  45 @RequestMapping("/api/v1/execution-service")
  46 @Api(
  47     value = "/api/v1/execution-service",
  48     description = "Interaction with CBA."
  49 )
  50 open class ExecutionServiceController {
  51
  52     val log = logger(ExecutionServiceController::class)
  53
  54     private val ph = Phaser(1)
  55
  56     @Autowired
  57     lateinit var executionServiceHandler: ExecutionServiceHandler
  58
  59     @RequestMapping(
  60         path = ["/health-check"],
  61         method = [RequestMethod.GET],
  62         produces = [MediaType.APPLICATION_JSON_VALUE]
  63     )
  64     @ResponseBody
  65     @ApiOperation(value = "Health Check", hidden = true)
  66     fun executionServiceControllerHealthCheck() = monoMdc(Dispatchers.IO) {
  67         "Success".asJsonPrimitive()
  68     }
  69
  70     @RequestMapping(path = ["/process"], method = [RequestMethod.POST], produces = [MediaType.APPLICATION_JSON_VALUE])
  71     @ApiOperation(
  72         value = "Execute a CBA workflow (action)",
  73         notes = "Execute the appropriate CBA's action based on the ExecutionServiceInput object passed as input.",
  74         produces = MediaType.APPLICATION_JSON_VALUE,
  75         response = ExecutionServiceOutput::class
  76     )
  77     @ResponseBody
  78     @PreAuthorize("hasRole('USER')")
  79     fun process(
  80         @ApiParam(value = "ExecutionServiceInput payload.", required = true)
  81         @RequestBody executionServiceInput: ExecutionServiceInput
  82     ):
  83             Mono<ResponseEntity<ExecutionServiceOutput>> = monoMdc(Dispatchers.IO) {
  84
  85         if (executionServiceInput.actionIdentifiers.mode == ACTION_MODE_ASYNC) {
  86             throw IllegalStateException("Can't process async request through the REST endpoint. Use gRPC for async processing.")
  87         }
  88
  89         ph.register()
  90         val processResult = executionServiceHandler.doProcess(executionServiceInput)
  91         ph.arriveAndDeregister()
  92         ResponseEntity(processResult, determineHttpStatusCode(processResult.status.code))
  93     }
  94
  95     @PreDestroy
  96     fun preDestroy() {
  97         val name = "ExecutionServiceController"
  98         log.info("Starting to shutdown $name waiting for in-flight requests to finish ...")
  99         ph.arriveAndAwaitAdvance()
 100         log.info("Done waiting in $name")
 101     }
 102 }