content: /*
   * Copyright 1999-2022 Alibaba Group Holding Ltd.
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  package com.alibaba.nacos.naming.controllers.v2;
  
  import com.alibaba.nacos.api.annotation.NacosApi;
  import com.alibaba.nacos.api.common.Constants;
  import com.alibaba.nacos.api.exception.api.NacosApiException;
  import com.alibaba.nacos.api.model.v2.ErrorCode;
  import com.alibaba.nacos.api.model.v2.Result;
  import com.alibaba.nacos.api.naming.pojo.maintainer.ClientSummaryInfo;
  import com.alibaba.nacos.auth.annotation.Secured;
  import com.alibaba.nacos.core.controller.compatibility.Compatibility;
  import com.alibaba.nacos.core.paramcheck.ExtractorManager;
  import com.alibaba.nacos.naming.core.ClientService;
  import com.alibaba.nacos.naming.core.v2.client.manager.ClientManager;
  import com.alibaba.nacos.naming.misc.UtilsAndCommons;
  import com.alibaba.nacos.naming.paramcheck.NamingDefaultHttpParamExtractor;
  import com.alibaba.nacos.plugin.auth.constant.ActionTypes;
  import com.alibaba.nacos.plugin.auth.constant.ApiType;
  import com.fasterxml.jackson.databind.node.ObjectNode;
  import org.springframework.http.HttpStatus;
  import org.springframework.web.bind.annotation.GetMapping;
  import org.springframework.web.bind.annotation.RequestMapping;
  import org.springframework.web.bind.annotation.RequestParam;
  import org.springframework.web.bind.annotation.RestController;
  
  import java.util.List;
  
  /**
   * ClientInfoControllerV2.
   *
   * @author dongyafei
   * @date 2022/9/20
   */
  @Deprecated
  @NacosApi
  @RestController
  @RequestMapping(UtilsAndCommons.DEFAULT_NACOS_NAMING_CONTEXT_V2 + UtilsAndCommons.NACOS_NAMING_CLIENT_CONTEXT)
  @ExtractorManager.Extractor(httpExtractor = NamingDefaultHttpParamExtractor.class)
  public class ClientInfoControllerV2 {
      
      private final ClientManager clientManager;
      
      private final ClientService clientServiceV2Impl;
      
      public ClientInfoControllerV2(ClientManager clientManager, ClientService clientServiceV2Impl) {
          this.clientManager = clientManager;
          this.clientServiceV2Impl = clientServiceV2Impl;
      }
      
      /**
       * Query all clients.
       */
      @GetMapping("/list")
      @Secured(action = ActionTypes.READ, resource = "nacos/admin")
      @Compatibility(apiType = ApiType.ADMIN_API, alternatives = "GET ${contextPath:nacos}/v3/admin/ns/client/list")
      public Result<List<String>> getClientList() {
          return Result.success(clientServiceV2Impl.getClientList());
      }
      
      /**
       * Query client by clientId.
       *
       * @param clientId clientId
       */
      @GetMapping()
      @Secured(action = ActionTypes.READ, resource = "nacos/admin")
      @Compatibility(apiType = ApiType.ADMIN_API, alternatives = "GET ${contextPath:nacos}/v3/admin/ns/client")
      public Result<ClientSummaryInfo> getClientDetail(@RequestParam("clientId") String clientId) throws NacosApiException {
          checkClientId(clientId);
          return Result.success(clientServiceV2Impl.getClientDetail(clientId));
      }
      
      /**
       * Query the services registered by the specified client.
       *
       * @param clientId clientId
       */
      @GetMapping("/publish/list")
      @Secured(action = ActionTypes.READ, resource = "nacos/admin")
      @Compatibility(apiType = ApiType.ADMIN_API, alternatives = "GET ${contextPath:nacos}/v3/admin/ns/client/publish/list")
      public Result<List<ObjectNode>> getPublishedServiceList(@RequestParam("clientId") String clientId)
              throws NacosApiException {
          checkClientId(clientId);
          
          return Result.success(clientServiceV2Impl.getPublishedServiceListAdapt(clientId));
      }
      
      /**
       * Query the services to which the specified client subscribes.
       *
       * @param clientId clientId.
       */
      @GetMapping("/subscribe/list")
      @Secured(action = ActionTypes.READ, resource = "nacos/admin")
      @Compatibility(apiType = ApiType.ADMIN_API, alternatives = "GET ${contextPath:nacos}/v3/admin/ns/client/subscribe/list")
      public Result<List<ObjectNode>> getSubscribeServiceList(@RequestParam("clientId") String clientId)
              throws NacosApiException {
          checkClientId(clientId);
          
          return Result.success(clientServiceV2Impl.getSubscribeServiceListAdapt(clientId));
      }
      
      /**
       * Query the clients that have registered the specified service.
       *
       * @param namespaceId namespaceId
       * @param groupName   groupName
       * @param ephemeral   ephemeral
       * @param serviceName serviceName
       * @param ip          ip
       * @param port        port
       * @return client info
       */
      @GetMapping("/service/publisher/list")
      @Secured(action = ActionTypes.READ, resource = "nacos/admin")
      @Compatibility(apiType = ApiType.ADMIN_API, alternatives = "GET ${contextPath:nacos}/v3/admin/ns/client/service/publisher/list")
      public Result<List<ObjectNode>> getPublishedClientList(
              @RequestParam(value = "namespaceId", required = false, defaultValue = Constants.DEFAULT_NAMESPACE_ID) String namespaceId,
              @RequestParam(value = "groupName", required = false, defaultValue = Constants.DEFAULT_GROUP) String groupName,
              @RequestParam(value = "ephemeral", required = false, defaultValue = "true") Boolean ephemeral,
              @RequestParam("serviceName") String serviceName, @RequestParam(value = "ip", required = false) String ip,
              @RequestParam(value = "port", required = false) Integer port) {
          return Result.success(clientServiceV2Impl.getPublishedClientList(namespaceId, groupName, serviceName, ephemeral, ip, port));
      }
      
      /**
       * Query the clients that are subscribed to the specified service.
       *
       * @param namespaceId namespaceId
       * @param groupName   groupName
       * @param ephemeral   ephemeral
       * @param serviceName serviceName
       * @param ip          ip
       * @param port        port
       * @return client info
       */
      @GetMapping("/service/subscriber/list")
      @Secured(action = ActionTypes.READ, resource = "nacos/admin")
      @Compatibility(apiType = ApiType.ADMIN_API, alternatives = "GET ${contextPath:nacos}/v3/admin/ns/client/service/subscriber/list")
      public Result<List<ObjectNode>> getSubscribeClientList(
              @RequestParam(value = "namespaceId", required = false, defaultValue = Constants.DEFAULT_NAMESPACE_ID) String namespaceId,
              @RequestParam(value = "groupName", required = false, defaultValue = Constants.DEFAULT_GROUP) String groupName,
              @RequestParam(value = "ephemeral", required = false, defaultValue = "true") Boolean ephemeral,
              @RequestParam("serviceName") String serviceName, @RequestParam(value = "ip", required = false) String ip,
              @RequestParam(value = "port", required = false) Integer port) {
          return Result.success(clientServiceV2Impl.getSubscribeClientList(namespaceId, groupName, serviceName, ephemeral, ip, port));
      }
      
      private void checkClientId(String clientId) throws NacosApiException {
          if (!clientManager.contains(clientId)) {
              throw new NacosApiException(HttpStatus.NOT_FOUND.value(), ErrorCode.RESOURCE_NOT_FOUND,
                      "clientId [ " + clientId + " ] not exist");
          }
      }
  }
  