a3b40864f5f404aa8088f23b82d63cfcf79326f0
[cps.git] /
1 /*
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
9  *
10  *        http://www.apache.org/licenses/LICENSE-2.0
11  *
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.
17  *
18  *  SPDX-License-Identifier: Apache-2.0
19  *  ============LICENSE_END=========================================================
20  */
21
22 package org.onap.cps.ncmp.rest.controller;
23
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;
50
51 @RestController
52 @RequestMapping("${rest.api.ncmp-inventory-base-path}")
53 @RequiredArgsConstructor
54 public class NetworkCmProxyInventoryController implements NetworkCmProxyInventoryApi {
55
56     private final NetworkCmProxyInventoryFacade networkCmProxyInventoryFacade;
57     private final NcmpRestInputMapper ncmpRestInputMapper;
58     private final DeprecationHelper deprecationHelper;
59     private final RestOutputCmHandleMapper restOutputCmHandleMapper;
60
61     /**
62      * Get all cm handle references under a registered DMI plugin.
63      *
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
68      */
69     @Override
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);
76
77         final Collection<String> cmHandleIds = networkCmProxyInventoryFacade
78                 .executeParameterizedCmHandleIdSearch(cmHandleQueryServiceParameters, outputAlternateId);
79         return ResponseEntity.ok(List.copyOf(cmHandleIds));
80     }
81
82     /**
83      * Execute cm handle query search and return a list of cm handle details. Any number of conditions can be applied.
84      *
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
88      */
89     @Override
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);
102     }
103
104     /**
105      * Get all cm-handle IDs under a registered DMI plugin.
106      *
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
111      */
112     @Override
113     public ResponseEntity<List<String>> getAllCmHandleReferencesForRegisteredDmi(final String dmiPluginIdentifier,
114                                                                                  final Boolean outputAlternateId) {
115
116         final Collection<String> cmHandleIds =
117             networkCmProxyInventoryFacade.getAllCmHandleReferencesByDmiPluginIdentifier(dmiPluginIdentifier,
118                 outputAlternateId);
119         return ResponseEntity.ok(List.copyOf(cmHandleIds));
120     }
121
122     /**
123      * Update DMI Plugin Registration (used for first registration also).
124      *
125      * @param restDmiPluginRegistration the registration data
126      */
127     @Override
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);
140     }
141
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();
148     }
149
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;
163     }
164
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());
170     }
171
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());
178     }
179
180 }