2 * ============LICENSE_START=======================================================
3 * Copyright (C) 2023-2024 Nordix Foundation
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
9 * http://www.apache.org/licenses/LICENSE-2.0
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.
17 * SPDX-License-Identifier: Apache-2.0
18 * ============LICENSE_END=========================================================
21 package org.onap.cps.ncmp.api.impl.utils.data.operation;
23 import static org.onap.cps.ncmp.api.NcmpResponseStatus.CM_HANDLES_NOT_FOUND;
24 import static org.onap.cps.ncmp.api.NcmpResponseStatus.CM_HANDLES_NOT_READY;
26 import io.cloudevents.CloudEvent;
27 import java.util.ArrayList;
28 import java.util.Collection;
29 import java.util.Collections;
30 import java.util.HashMap;
31 import java.util.List;
34 import java.util.stream.Collectors;
35 import lombok.AccessLevel;
36 import lombok.NoArgsConstructor;
37 import lombok.extern.slf4j.Slf4j;
38 import org.onap.cps.events.EventsPublisher;
39 import org.onap.cps.ncmp.api.NcmpResponseStatus;
40 import org.onap.cps.ncmp.api.impl.operations.DmiDataOperation;
41 import org.onap.cps.ncmp.api.impl.operations.DmiOperationCmHandle;
42 import org.onap.cps.ncmp.api.impl.utils.DmiServiceNameOrganizer;
43 import org.onap.cps.ncmp.api.impl.utils.context.CpsApplicationContext;
44 import org.onap.cps.ncmp.api.models.DataOperationDefinition;
45 import org.onap.cps.ncmp.api.models.DataOperationRequest;
46 import org.onap.cps.ncmp.impl.inventory.models.CmHandleState;
47 import org.onap.cps.ncmp.impl.inventory.models.YangModelCmHandle;
48 import org.springframework.util.LinkedMultiValueMap;
49 import org.springframework.util.MultiValueMap;
51 @NoArgsConstructor(access = AccessLevel.PRIVATE)
53 public class ResourceDataOperationRequestUtils {
55 private static final String UNKNOWN_SERVICE_NAME = null;
58 * Create a list of DMI data operation per DMI service (name).
60 * @param topicParamInQuery client given topic
61 * @param requestId unique identifier per request
62 * @param dataOperationRequestIn incoming data operation request details
63 * @param yangModelCmHandles involved cm handles represented as YangModelCmHandle (incl. metadata)
64 * @return {@code Map<String, List<DmiBatchOperation>>} Create a list of DMI batch operation per DMI service (name).
66 public static Map<String, List<DmiDataOperation>> processPerDefinitionInDataOperationsRequest(
67 final String topicParamInQuery,
68 final String requestId,
69 final DataOperationRequest dataOperationRequestIn,
70 final Collection<YangModelCmHandle> yangModelCmHandles) {
72 final Map<String, List<DmiDataOperation>> dmiDataOperationsOutPerDmiServiceName = new HashMap<>();
73 final MultiValueMap<DmiDataOperation, Map<NcmpResponseStatus,
74 List<String>>> cmHandleIdsPerResponseCodesPerOperation = new LinkedMultiValueMap<>();
75 final Set<String> nonReadyCmHandleIdsLookup = filterAndGetNonReadyCmHandleIds(yangModelCmHandles);
77 final Map<String, Map<String, Map<String, String>>> dmiPropertiesPerCmHandleIdPerServiceName =
78 DmiServiceNameOrganizer.getDmiPropertiesPerCmHandleIdPerServiceName(yangModelCmHandles);
80 final Map<String, String> dmiServiceNamesPerCmHandleId =
81 getDmiServiceNamesPerCmHandleId(dmiPropertiesPerCmHandleIdPerServiceName);
83 final Map<String, String> moduleSetTagPerCmHandle = getModuleSetTagPerCmHandleId(yangModelCmHandles);
85 for (final DataOperationDefinition dataOperationDefinitionIn :
86 dataOperationRequestIn.getDataOperationDefinitions()) {
87 final List<String> nonExistingCmHandleIds = new ArrayList<>();
88 final List<String> nonReadyCmHandleIds = new ArrayList<>();
89 for (final String cmHandleId : dataOperationDefinitionIn.getCmHandleIds()) {
90 if (nonReadyCmHandleIdsLookup.contains(cmHandleId)) {
91 nonReadyCmHandleIds.add(cmHandleId);
93 final String dmiServiceName = dmiServiceNamesPerCmHandleId.get(cmHandleId);
94 final Map<String, String> cmHandleIdProperties
95 = dmiPropertiesPerCmHandleIdPerServiceName.get(dmiServiceName).get(cmHandleId);
96 if (cmHandleIdProperties == null) {
97 nonExistingCmHandleIds.add(cmHandleId);
99 final DmiDataOperation dmiBatchOperationOut = getOrAddDmiBatchOperation(dmiServiceName,
100 dataOperationDefinitionIn, dmiDataOperationsOutPerDmiServiceName);
101 final DmiOperationCmHandle dmiOperationCmHandle = DmiOperationCmHandle
102 .buildDmiOperationCmHandle(cmHandleId, cmHandleIdProperties,
103 moduleSetTagPerCmHandle.get(cmHandleId));
104 dmiBatchOperationOut.getCmHandles().add(dmiOperationCmHandle);
108 populateCmHandleIdsPerOperationIdPerResponseCode(cmHandleIdsPerResponseCodesPerOperation,
109 DmiDataOperation.buildDmiDataOperationRequestBodyWithoutCmHandles(dataOperationDefinitionIn),
110 CM_HANDLES_NOT_FOUND, nonExistingCmHandleIds);
111 populateCmHandleIdsPerOperationIdPerResponseCode(cmHandleIdsPerResponseCodesPerOperation,
112 DmiDataOperation.buildDmiDataOperationRequestBodyWithoutCmHandles(dataOperationDefinitionIn),
113 CM_HANDLES_NOT_READY, nonReadyCmHandleIds);
115 publishErrorMessageToClientTopic(topicParamInQuery, requestId, cmHandleIdsPerResponseCodesPerOperation);
116 return dmiDataOperationsOutPerDmiServiceName;
119 private static Map<String, String> getModuleSetTagPerCmHandleId(
120 final Collection<YangModelCmHandle> yangModelCmHandles) {
121 final Map<String, String> moduleSetTagPerCmHandle = new HashMap<>(yangModelCmHandles.size());
122 yangModelCmHandles.forEach(yangModelCmHandle ->
123 moduleSetTagPerCmHandle.put(yangModelCmHandle.getId(), yangModelCmHandle.getModuleSetTag()));
124 return moduleSetTagPerCmHandle;
128 * Creates data operation cloud event and publish it to client topic.
130 * @param clientTopic client given topic
131 * @param requestId unique identifier per request
132 * @param cmHandleIdsPerResponseCodesPerOperation list of cm handle ids per operation with response code
134 public static void publishErrorMessageToClientTopic(final String clientTopic,
135 final String requestId,
136 final MultiValueMap<DmiDataOperation,
137 Map<NcmpResponseStatus, List<String>>>
138 cmHandleIdsPerResponseCodesPerOperation) {
139 if (!cmHandleIdsPerResponseCodesPerOperation.isEmpty()) {
140 final CloudEvent dataOperationCloudEvent = DataOperationEventCreator.createDataOperationEvent(clientTopic,
141 requestId, cmHandleIdsPerResponseCodesPerOperation);
142 final EventsPublisher<CloudEvent> eventsPublisher = CpsApplicationContext.getCpsBean(EventsPublisher.class);
143 log.warn("publishing error message to client topic: {} ,requestId: {}, data operation cloud event id: {}",
144 clientTopic, requestId, dataOperationCloudEvent.getId());
145 eventsPublisher.publishCloudEvent(clientTopic, requestId, dataOperationCloudEvent);
149 private static Map<String, String> getDmiServiceNamesPerCmHandleId(
150 final Map<String, Map<String, Map<String, String>>> dmiDmiPropertiesPerCmHandleIdPerServiceName) {
151 final Map<String, String> dmiServiceNamesPerCmHandleId = new HashMap<>();
152 for (final Map.Entry<String, Map<String, Map<String, String>>> dmiDmiPropertiesEntry
153 : dmiDmiPropertiesPerCmHandleIdPerServiceName.entrySet()) {
154 final String dmiServiceName = dmiDmiPropertiesEntry.getKey();
155 final Set<String> cmHandleIds = dmiDmiPropertiesPerCmHandleIdPerServiceName.get(dmiServiceName).keySet();
156 for (final String cmHandleId : cmHandleIds) {
157 dmiServiceNamesPerCmHandleId.put(cmHandleId, dmiServiceName);
160 dmiDmiPropertiesPerCmHandleIdPerServiceName.put(UNKNOWN_SERVICE_NAME, Collections.emptyMap());
161 return dmiServiceNamesPerCmHandleId;
164 private static DmiDataOperation getOrAddDmiBatchOperation(final String dmiServiceName,
165 final DataOperationDefinition
166 dataOperationDefinitionIn,
167 final Map<String, List<DmiDataOperation>>
168 dmiBatchOperationsOutPerDmiServiceName) {
169 dmiBatchOperationsOutPerDmiServiceName
170 .computeIfAbsent(dmiServiceName, dmiServiceNameAsKey -> new ArrayList<>());
171 final List<DmiDataOperation> dmiBatchOperationsOut
172 = dmiBatchOperationsOutPerDmiServiceName.get(dmiServiceName);
173 final boolean isNewOperation = dmiBatchOperationsOut.isEmpty()
174 || !dmiBatchOperationsOut.get(dmiBatchOperationsOut.size() - 1).getOperationId()
175 .equals(dataOperationDefinitionIn.getOperationId());
176 if (isNewOperation) {
177 final DmiDataOperation newDmiBatchOperationOut =
178 DmiDataOperation.buildDmiDataOperationRequestBodyWithoutCmHandles(dataOperationDefinitionIn);
179 dmiBatchOperationsOut.add(newDmiBatchOperationOut);
180 return newDmiBatchOperationOut;
182 return dmiBatchOperationsOut.get(dmiBatchOperationsOut.size() - 1);
185 private static Set<String> filterAndGetNonReadyCmHandleIds(final Collection<YangModelCmHandle> yangModelCmHandles) {
186 return yangModelCmHandles.stream()
187 .filter(yangModelCmHandle -> yangModelCmHandle.getCompositeState().getCmHandleState()
188 != CmHandleState.READY).map(YangModelCmHandle::getId).collect(Collectors.toSet());
191 private static void populateCmHandleIdsPerOperationIdPerResponseCode(final MultiValueMap<DmiDataOperation,
192 Map<NcmpResponseStatus, List<String>>> cmHandleIdsPerResponseCodesPerOperation,
193 final DmiDataOperation dmiDataOperation,
194 final NcmpResponseStatus
196 final List<String> cmHandleIds) {
197 if (!cmHandleIds.isEmpty()) {
198 cmHandleIdsPerResponseCodesPerOperation.add(dmiDataOperation, Map.of(ncmpResponseStatus, cmHandleIds));