webapp-backend/src/main/java/org/oransc/ric/portal/dashboard/controller/CaasIngressController.java

   1 /*-
   2  * ========================LICENSE_START=================================
   3  * O-RAN-SC
   4  * %%
   5  * Copyright (C) 2019 AT&T Intellectual Property
   6  * %%
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  *      http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  * ========================LICENSE_END===================================
  19  */
  20 package org.oransc.ric.portal.dashboard.controller;
  21
  22 import java.lang.invoke.MethodHandles;
  23
  24 import javax.servlet.http.HttpServletResponse;
  25
  26 import org.oransc.ric.portal.dashboard.DashboardConstants;
  27 import org.oransc.ric.portal.dashboard.k8sapi.SimpleKubernetesClient;
  28 import org.slf4j.Logger;
  29 import org.slf4j.LoggerFactory;
  30 import org.springframework.beans.factory.annotation.Autowired;
  31 import org.springframework.context.annotation.Configuration;
  32 import org.springframework.http.HttpStatus;
  33 import org.springframework.http.MediaType;
  34 import org.springframework.security.access.annotation.Secured;
  35 import org.springframework.util.Assert;
  36 import org.springframework.web.bind.annotation.GetMapping;
  37 import org.springframework.web.bind.annotation.PathVariable;
  38 import org.springframework.web.bind.annotation.RequestMapping;
  39 import org.springframework.web.bind.annotation.RestController;
  40
  41 import io.swagger.annotations.ApiOperation;
  42
  43 /**
  44  * Proxies calls from the front end to a CAAS-Ingress API, which is a proxy for
  45  * a Kubernetes API.
  46  *
  47  * If a method throws RestClientResponseException, it is handled by
  48  * {@link CustomResponseEntityExceptionHandler#handleProxyMethodException(Exception, org.springframework.web.context.request.WebRequest)}
  49  * which returns status 502. All other exceptions are handled by Spring which
  50  * returns status 500.
  51  */
  52 @Configuration
  53 @RestController
  54 @RequestMapping(value = CaasIngressController.CONTROLLER_PATH, produces = MediaType.APPLICATION_JSON_VALUE)
  55 public class CaasIngressController {
  56
  57         private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
  58
  59         // Publish constants so tests are easy to write
  60         public static final String CONTROLLER_PATH = DashboardConstants.ENDPOINT_PREFIX + "/caas-ingress";
  61         // Endpoints
  62         public static final String PODS_METHOD = "/pods";
  63         // Path parameters
  64         public static final String PP_CLUSTER = "cluster";
  65         public static final String PP_NAMESPACE = "namespace";
  66         // Parameter values
  67         public static final String CLUSTER_PLT = "plt";
  68         public static final String CLUSTER_RIC = "ric"; // alternate for PLT
  69
  70         private final SimpleKubernetesClient ciPltClient;
  71
  72         @Autowired
  73         public CaasIngressController(final SimpleKubernetesClient ciPltApi) {
  74                 Assert.notNull(ciPltApi, "pltApi must not be null");
  75                 this.ciPltClient = ciPltApi;
  76                 if (logger.isDebugEnabled())
  77                         logger.debug("ctor: configured with plt api {}", ciPltClient.getClass().getName());
  78         }
  79
  80         /*
  81          * No need to parse the V1PodList, just pass thru as a string.
  82          */
  83         @ApiOperation(value = "Gets list of pods in the specified cluster for the specified namespace", response = String.class)
  84         @GetMapping(PODS_METHOD + "/" + PP_CLUSTER + "/{" + PP_CLUSTER + "}" + "/" + PP_NAMESPACE + "/{" + PP_NAMESPACE
  85                         + "}")
  86         @Secured({ DashboardConstants.ROLE_ADMIN, DashboardConstants.ROLE_STANDARD })
  87         public String listPods(@PathVariable(PP_CLUSTER) String cluster, @PathVariable(PP_NAMESPACE) String namespace,
  88                         HttpServletResponse response) {
  89                 logger.debug("listPods: cluster {}, namespace {}", cluster, namespace);
  90                 if (CLUSTER_PLT.equalsIgnoreCase(cluster) || CLUSTER_RIC.equalsIgnoreCase(cluster)) {
  91                         return ciPltClient.listPods(namespace);
  92                 } else {
  93                         logger.warn("listPods: unknown cluster {}", cluster);
  94                         response.setStatus(HttpStatus.BAD_REQUEST.value());
  95                         return null;
  96                 }
  97         }
  98
  99 }