2 * ============LICENSE_START=======================================================
3 * Copyright (C) 2021-2022 Bell Canada
4 * Modifications Copyright (C) 2022-2025 OpenInfra Foundation Europe. All rights reserved.
5 * ================================================================================
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
18 * SPDX-License-Identifier: Apache-2.0
19 * ============LICENSE_END=========================================================
22 package org.onap.cps.ncmp.rest.controller;
24 import io.micrometer.core.annotation.Timed;
25 import jakarta.validation.Valid;
26 import java.util.Collection;
27 import java.util.List;
28 import java.util.stream.Collectors;
29 import lombok.RequiredArgsConstructor;
30 import org.onap.cps.ncmp.api.inventory.NetworkCmProxyInventoryFacade;
31 import org.onap.cps.ncmp.api.inventory.models.CmHandleQueryApiParameters;
32 import org.onap.cps.ncmp.api.inventory.models.CmHandleQueryServiceParameters;
33 import org.onap.cps.ncmp.api.inventory.models.CmHandleRegistrationResponse;
34 import org.onap.cps.ncmp.api.inventory.models.CmHandleRegistrationResponse.Status;
35 import org.onap.cps.ncmp.api.inventory.models.DmiPluginRegistrationResponse;
36 import org.onap.cps.ncmp.rest.api.NetworkCmProxyInventoryApi;
37 import org.onap.cps.ncmp.rest.model.CmHandleQueryParameters;
38 import org.onap.cps.ncmp.rest.model.CmHandlerRegistrationErrorResponse;
39 import org.onap.cps.ncmp.rest.model.DmiPluginRegistrationErrorResponse;
40 import org.onap.cps.ncmp.rest.model.RestDmiPluginRegistration;
41 import org.onap.cps.ncmp.rest.model.RestOutputCmHandle;
42 import org.onap.cps.ncmp.rest.util.CountCmHandleSearchExecution;
43 import org.onap.cps.ncmp.rest.util.DeprecationHelper;
44 import org.onap.cps.ncmp.rest.util.NcmpRestInputMapper;
45 import org.onap.cps.ncmp.rest.util.RestOutputCmHandleMapper;
46 import org.springframework.http.HttpStatus;
47 import org.springframework.http.ResponseEntity;
48 import org.springframework.web.bind.annotation.RequestMapping;
49 import org.springframework.web.bind.annotation.RestController;
52 @RequestMapping("${rest.api.ncmp-inventory-base-path}")
53 @RequiredArgsConstructor
54 public class NetworkCmProxyInventoryController implements NetworkCmProxyInventoryApi {
56 private final NetworkCmProxyInventoryFacade networkCmProxyInventoryFacade;
57 private final NcmpRestInputMapper ncmpRestInputMapper;
58 private final DeprecationHelper deprecationHelper;
59 private final RestOutputCmHandleMapper restOutputCmHandleMapper;
62 * Get all cm handle references under a registered DMI plugin.
64 * @param cmHandleQueryParameters DMI plugin identifier
65 * @param outputAlternateId Boolean for cm handle reference type either
66 * cm handle id (False) or alternate id (True)
67 * @return list of cm handle IDs
70 @CountCmHandleSearchExecution(methodName = "searchCmHandleIds", interfaceName = "CPS-NCMP-I-01",
71 description = "Search for cm handle ids within CPS-NCMP-I-01 interface")
72 public ResponseEntity<List<String>> searchCmHandleIds(final CmHandleQueryParameters cmHandleQueryParameters,
73 final Boolean outputAlternateId) {
74 final CmHandleQueryServiceParameters cmHandleQueryServiceParameters = ncmpRestInputMapper
75 .toCmHandleQueryServiceParameters(cmHandleQueryParameters);
77 final Collection<String> cmHandleIds = networkCmProxyInventoryFacade
78 .executeParameterizedCmHandleIdSearch(cmHandleQueryServiceParameters, outputAlternateId);
79 return ResponseEntity.ok(List.copyOf(cmHandleIds));
83 * Execute cm handle query search and return a list of cm handle details. Any number of conditions can be applied.
85 * @param cmHandleQueryParameters the cm handle query parameters
86 * @param includeAdditionalProperties boolean value to determine the inclusion of additional properties
87 * @return collection of cm handles
90 public ResponseEntity<List<RestOutputCmHandle>> searchCmHandles(
91 final CmHandleQueryParameters cmHandleQueryParameters,
92 final Boolean includeAdditionalProperties) {
93 final CmHandleQueryApiParameters cmHandleQueryApiParameters =
94 deprecationHelper.mapOldConditionProperties(cmHandleQueryParameters);
95 final boolean includeAdditionalPropertiesParameter = Boolean.TRUE.equals(includeAdditionalProperties);
96 final List<RestOutputCmHandle> restOutputCmHandles =
97 networkCmProxyInventoryFacade.executeCmHandleInventorySearch(cmHandleQueryApiParameters)
98 .map(handle -> restOutputCmHandleMapper
99 .toRestOutputCmHandle(handle, includeAdditionalPropertiesParameter))
100 .collectList().block();
101 return ResponseEntity.ok(restOutputCmHandles);
105 * Get all cm-handle IDs under a registered DMI plugin.
107 * @param dmiPluginIdentifier DMI plugin identifier
108 * @param outputAlternateId Boolean for cm handle reference type either
109 * cm handle id (False) or alternate id (True)
110 * @return list of cm handle IDs
113 public ResponseEntity<List<String>> getAllCmHandleReferencesForRegisteredDmi(final String dmiPluginIdentifier,
114 final Boolean outputAlternateId) {
116 final Collection<String> cmHandleIds =
117 networkCmProxyInventoryFacade.getAllCmHandleReferencesByDmiPluginIdentifier(dmiPluginIdentifier,
119 return ResponseEntity.ok(List.copyOf(cmHandleIds));
123 * Update DMI Plugin Registration (used for first registration also).
125 * @param restDmiPluginRegistration the registration data
128 @Timed(value = "cps.ncmp.inventory.controller.update",
129 description = "Time taken to handle registration request")
130 public ResponseEntity updateDmiPluginRegistration(
131 final @Valid RestDmiPluginRegistration restDmiPluginRegistration) {
132 final DmiPluginRegistrationResponse dmiPluginRegistrationResponse =
133 networkCmProxyInventoryFacade.updateDmiRegistration(
134 ncmpRestInputMapper.toDmiPluginRegistration(restDmiPluginRegistration));
135 final DmiPluginRegistrationErrorResponse failedRegistrationErrorResponse =
136 getFailureRegistrationResponse(dmiPluginRegistrationResponse);
137 return allRegistrationsSuccessful(failedRegistrationErrorResponse)
138 ? new ResponseEntity<>(HttpStatus.OK)
139 : new ResponseEntity<>(failedRegistrationErrorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
142 private boolean allRegistrationsSuccessful(
143 final DmiPluginRegistrationErrorResponse dmiPluginRegistrationErrorResponse) {
144 return dmiPluginRegistrationErrorResponse.getFailedCreatedCmHandles().isEmpty()
145 && dmiPluginRegistrationErrorResponse.getFailedUpdatedCmHandles().isEmpty()
146 && dmiPluginRegistrationErrorResponse.getFailedRemovedCmHandles().isEmpty()
147 && dmiPluginRegistrationErrorResponse.getFailedUpgradeCmHandles().isEmpty();
150 private DmiPluginRegistrationErrorResponse getFailureRegistrationResponse(
151 final DmiPluginRegistrationResponse dmiPluginRegistrationResponse) {
152 final DmiPluginRegistrationErrorResponse dmiPluginRegistrationErrorResponse =
153 new DmiPluginRegistrationErrorResponse();
154 dmiPluginRegistrationErrorResponse.setFailedCreatedCmHandles(
155 getFailedResponses(dmiPluginRegistrationResponse.getCreatedCmHandles()));
156 dmiPluginRegistrationErrorResponse.setFailedUpdatedCmHandles(
157 getFailedResponses(dmiPluginRegistrationResponse.getUpdatedCmHandles()));
158 dmiPluginRegistrationErrorResponse.setFailedRemovedCmHandles(
159 getFailedResponses(dmiPluginRegistrationResponse.getRemovedCmHandles()));
160 dmiPluginRegistrationErrorResponse.setFailedUpgradeCmHandles(
161 getFailedResponses(dmiPluginRegistrationResponse.getUpgradedCmHandles()));
162 return dmiPluginRegistrationErrorResponse;
165 private List<CmHandlerRegistrationErrorResponse> getFailedResponses(
166 final List<CmHandleRegistrationResponse> cmHandleRegistrationResponseList) {
167 return cmHandleRegistrationResponseList.stream()
168 .filter(cmHandleRegistrationResponse -> cmHandleRegistrationResponse.getStatus() == Status.FAILURE)
169 .map(this::toCmHandleRegistrationErrorResponse).collect(Collectors.toList());
172 private CmHandlerRegistrationErrorResponse toCmHandleRegistrationErrorResponse(
173 final CmHandleRegistrationResponse registrationResponse) {
174 return new CmHandlerRegistrationErrorResponse()
175 .cmHandle(registrationResponse.getCmHandle())
176 .errorCode(registrationResponse.getNcmpResponseStatus().getCode())
177 .errorText(registrationResponse.getErrorText());