gerrit.onap Code Review - cps.git/blob

   1 /*
   2  *  ============LICENSE_START=======================================================
   3  *  Copyright (C) 2022-2025 Nordix Foundation
   4  *  Modifications Copyright (C) 2023 TechMahindra Ltd.
   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.impl.inventory
  23
  24 import com.hazelcast.config.Config
  25 import com.hazelcast.core.Hazelcast
  26 import com.hazelcast.instance.impl.HazelcastInstanceFactory
  27 import org.onap.cps.api.CpsDataService
  28 import org.onap.cps.api.CpsQueryService
  29 import org.onap.cps.utils.CpsValidator
  30 import org.onap.cps.ncmp.api.inventory.DataStoreSyncState
  31 import org.onap.cps.ncmp.api.inventory.models.TrustLevel
  32 import org.onap.cps.ncmp.api.inventory.models.CmHandleState
  33 import org.onap.cps.api.model.DataNode
  34 import spock.lang.Specification
  35
  36 import static org.onap.cps.ncmp.impl.inventory.NcmpPersistence.NCMP_DATASPACE_NAME
  37 import static org.onap.cps.ncmp.impl.inventory.NcmpPersistence.NCMP_DMI_REGISTRY_ANCHOR
  38 import static org.onap.cps.ncmp.impl.inventory.NcmpPersistence.NCMP_DMI_REGISTRY_PARENT
  39 import static org.onap.cps.api.parameters.FetchDescendantsOption.INCLUDE_ALL_DESCENDANTS
  40 import static org.onap.cps.api.parameters.FetchDescendantsOption.OMIT_DESCENDANTS
  41
  42 class CmHandleQueryServiceImplSpec extends Specification {
  43
  44     def mockCpsQueryService = Mock(CpsQueryService)
  45     def mockCpsDataService = Mock(CpsDataService)
  46     def trustLevelPerDmiPlugin = HazelcastInstanceFactory.getOrCreateHazelcastInstance(new Config('hazelcastInstanceName')).getMap('trustLevelPerDmiPlugin')
  47     def trustLevelPerCmHandleId = HazelcastInstanceFactory.getOrCreateHazelcastInstance(new Config('hazelcastInstanceName')).getMap('trustLevelPerCmHandleId')
  48     def mockCpsValidator = Mock(CpsValidator)
  49
  50     def objectUnderTest = new CmHandleQueryServiceImpl(mockCpsDataService, mockCpsQueryService, trustLevelPerDmiPlugin, trustLevelPerCmHandleId, mockCpsValidator)
  51     def static sampleDataNodes = [new DataNode(xpath: "/dmi-registry/cm-handles[@id='ch-1']"),
  52                                   new DataNode(xpath: "/dmi-registry/cm-handles[@id='ch-2']")]
  53
  54     def dataNodeWithPrivateField = '//additional-properties[@name=\"Contact3\" and @value=\"newemailforstore3@bookstore.com\"]/ancestor::cm-handles'
  55
  56     def static pnfDemo = createDataNode('PNFDemo')
  57     def static pnfDemo2 = createDataNode('PNFDemo2')
  58     def static pnfDemo3 = createDataNode('PNFDemo3')
  59     def static pnfDemo4 = createDataNode('PNFDemo4')
  60     def static pnfDemo5 = createDataNode('PNFDemo5')
  61
  62     def setup() {
  63         trustLevelPerCmHandleId.put("PNFDemo", TrustLevel.COMPLETE)
  64         trustLevelPerCmHandleId.put("PNFDemo2", TrustLevel.NONE)
  65         trustLevelPerCmHandleId.put("PNFDemo4", TrustLevel.NONE)
  66     }
  67
  68     def cleanupSpec() {
  69         Hazelcast.getHazelcastInstanceByName('hazelcastInstanceName').shutdown()
  70     }
  71
  72     def 'Query CmHandles with public properties query pair.'() {
  73         given: 'the DataNodes queried for a given cpsPath are returned from the persistence service.'
  74             mockResponses()
  75         when: 'a query on cmhandle public properties is performed with a public property pair'
  76             def result = objectUnderTest.queryCmHandlePublicProperties(publicPropertyPairs, outputAlternateId)
  77         then: 'the correct cm handle data objects are returned'
  78             result.containsAll(expectedCmHandleReferences)
  79             result.size() == expectedCmHandleReferences.size()
  80         where: 'the following data is used'
  81             scenario                         | publicPropertyPairs                                                                      | outputAlternateId || expectedCmHandleReferences
  82             'single property matches'        | [Contact: 'newemailforstore@bookstore.com']                                              | false             || ['PNFDemo', 'PNFDemo2', 'PNFDemo4']
  83             'public property does not match' | [wont_match: 'wont_match']                                                               | false             || []
  84             '2 properties, only one match'   | [Contact: 'newemailforstore@bookstore.com', Contact2: 'newemailforstore2@bookstore.com'] | true              || ['alt-PNFDemo4']
  85             '2 properties, no matches'       | [Contact: 'newemailforstore@bookstore.com', Contact2: '']                                | false             || []
  86     }
  87
  88     def 'Query cm handles on trust level'() {
  89         given: 'query properties for #trustLevel'
  90             def trustLevelPropertyQueryPairs = ['trustLevel' : trustLevel.toString()]
  91         and: 'the dmi cache has been initialised and "knows" about my-dmi-plugin-identifier'
  92             trustLevelPerDmiPlugin.put('my-dmi-plugin-identifier', trustLevel)
  93         and: 'the DataNodes queried for a given cpsPath are returned from the persistence service'
  94             mockResponses()
  95         when: 'the query is run'
  96             def result = objectUnderTest.queryCmHandlesByTrustLevel(trustLevelPropertyQueryPairs, outputAlternateId)
  97         then: 'the result contain trusted cmHandle reference'
  98             assert result as Set == expectedCmHandleReference as Set
  99         where: 'the following data is used'
 100             senario                                     | outputAlternateId | expectedCmHandleReference                      | trustLevel           || resultSize
 101             'output cmHandleId for trustLevel Complete' |  false            | ['PNFDemo']                                    | TrustLevel.COMPLETE  || 1
 102             'output alternateId for trustLevel Complete'|  true             | ['alt-PNFDemo']                                | TrustLevel.COMPLETE  || 1
 103             'output alternateIds for trustLevel None'   |  true             | ['alt-PNFDemo2', 'alt-PNFDemo', 'alt-PNFDemo4']| TrustLevel.NONE      || 3
 104     }
 105
 106     def 'Query CmHandles using empty public properties query pair.'() {
 107         when: 'a query on CmHandle public properties is executed using an empty map'
 108             def result = objectUnderTest.queryCmHandlePublicProperties([:], false)
 109         then: 'no cm handles are returned'
 110             result.size() == 0
 111     }
 112
 113     def 'Query CmHandles using empty private properties query pair.'() {
 114         when: 'a query on CmHandle private properties is executed using an empty map'
 115             def result = objectUnderTest.queryCmHandleAdditionalProperties([:], false)
 116         then: 'no cm handles are returned'
 117             result.size() == 0
 118     }
 119
 120     def 'Query CmHandles by a private field\'s value.'() {
 121         given: 'a data node exists with a certain additional-property'
 122             mockCpsQueryService.queryDataNodes(_, _, dataNodeWithPrivateField, _) >> [pnfDemo5]
 123         when: 'a query on CmHandle private properties is executed using a map'
 124             def result = objectUnderTest.queryCmHandleAdditionalProperties(['Contact3': 'newemailforstore3@bookstore.com'], false)
 125         then: 'one cm handle is returned'
 126             result.size() == 1
 127     }
 128
 129     def 'Get Ids of CmHandles by state.'() {
 130         given: 'a cm handle state to query'
 131             def cmHandleState = CmHandleState.ADVISED
 132         and: 'the persistence service returns a list of data nodes'
 133             mockCpsQueryService.queryDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR,
 134                 "//state[@cm-handle-state='ADVISED']", OMIT_DESCENDANTS) >> sampleDataNodes
 135         when: 'cm handles are fetched by state'
 136             def result = objectUnderTest.queryCmHandleIdsByState(cmHandleState)
 137         then: 'the returned result matches the result from the persistence service'
 138             assert result.toSet() == ['ch-1', 'ch-2'].toSet()
 139     }
 140
 141     def 'Check the state of a cmHandle when #scenario.'() {
 142         given: 'a cm handle state to compare'
 143             def cmHandleState = state
 144         and: 'the persistence service returns a list of data nodes'
 145             mockCpsDataService.getDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR,
 146                 NCMP_DMI_REGISTRY_PARENT + '/cm-handles[@id=\'some-cm-handle\']/state',
 147                 OMIT_DESCENDANTS) >> [new DataNode(leaves: ['cm-handle-state': 'READY'])]
 148         when: 'cm handles are compared by state'
 149             def result = objectUnderTest.cmHandleHasState('some-cm-handle', cmHandleState)
 150         then: 'the returned result matches the expected result from the persistence service'
 151             result == expectedResult
 152         where:
 153             scenario                           | state                 || expectedResult
 154             'the provided state matches'       | CmHandleState.READY   || true
 155             'the provided state does not match'| CmHandleState.DELETED || false
 156     }
 157
 158     def 'Get Cm Handles state by Cm-Handle Id'() {
 159         given: 'a cm handle state to query'
 160             def cmHandleState = CmHandleState.READY
 161         and: 'cps data service returns a list of data nodes'
 162             mockCpsDataService.getDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR,
 163                 NCMP_DMI_REGISTRY_PARENT + '/cm-handles[@id=\'some-cm-handle\']/state',
 164                 OMIT_DESCENDANTS) >> [new DataNode(leaves: ['cm-handle-state': 'READY'])]
 165         when: 'cm handles are fetched by state and id'
 166             def result = objectUnderTest.getCmHandleState('some-cm-handle')
 167         then: 'the returned result is a list of data nodes returned by cps data service'
 168             assert result == new DataNode(leaves: ['cm-handle-state': 'READY'])
 169     }
 170
 171     def 'Retrieve Cm Handles By Operational Sync State : UNSYNCHRONIZED'() {
 172         given: 'a cm handle state to query'
 173             def cmHandleState = CmHandleState.READY
 174         and: 'cps data service returns a list of data nodes'
 175             mockCpsQueryService.queryDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR,
 176                 '//state/datastores/operational[@sync-state="'+'UNSYNCHRONIZED'+'"]/ancestor::cm-handles', OMIT_DESCENDANTS) >> sampleDataNodes
 177         when: 'cm handles are fetched by the UNSYNCHRONIZED operational sync state'
 178             def result = objectUnderTest.queryCmHandlesByOperationalSyncState(DataStoreSyncState.UNSYNCHRONIZED)
 179         then: 'the returned result is a list of data nodes returned by cps data service'
 180             assert result == sampleDataNodes
 181     }
 182
 183     def 'Retrieve cm handle by cps path '() {
 184         given: 'a cm handle state to query based on the cps path'
 185             def cmHandleDataNode = new DataNode(xpath: "/dmi-registry/cm-handles[@id='ch-1']", leaves: ['id': 'ch-1'])
 186             def cpsPath = "//state[@cm-handle-state='LOCKED']"
 187         and: 'cps data service returns a valid data node for cm handle ancestor'
 188             mockCpsQueryService.queryDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR,
 189                 cpsPath + '/ancestor::cm-handles', INCLUDE_ALL_DESCENDANTS)
 190                 >> Arrays.asList(cmHandleDataNode)
 191         when: 'get cm handles by cps path is invoked'
 192             def result = objectUnderTest.queryCmHandleAncestorsByCpsPath(cpsPath, INCLUDE_ALL_DESCENDANTS)
 193         then: 'the returned result is a list of data nodes returned by cps data service'
 194             assert result.contains(cmHandleDataNode)
 195     }
 196
 197     def 'Retrieve cm handle by cps path querying cm handle directly'() {
 198         given: 'a cm handle to query based on the cps path'
 199             def cmHandleDataNode = new DataNode(xpath: "/dmi-registry/cm-handles[@id='ch-2']", leaves: ['id': 'ch-2'])
 200             def cpsPath = "//cm-handles[@alternate-id='1']"
 201         and: 'cps data service returns a valid data node'
 202             mockCpsQueryService.queryDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR,
 203                 cpsPath, INCLUDE_ALL_DESCENDANTS)
 204                 >> Arrays.asList(cmHandleDataNode)
 205         when: 'get cm handles by cps path is invoked'
 206             def result = objectUnderTest.queryCmHandleAncestorsByCpsPath(cpsPath, INCLUDE_ALL_DESCENDANTS)
 207         then: 'the returned result is a list of data nodes returned by cps data service'
 208             assert result.contains(cmHandleDataNode)
 209     }
 210
 211     def 'Get all cm handles by dmi plugin identifier and alternate id output option where #scenario'() {
 212         given: 'the DataNodes queried for a given cpsPath are returned from the persistence service.'
 213             mockResponses()
 214         when: 'cm Handles are fetched for a given dmi plugin identifier and alternate id output option'
 215             def result = objectUnderTest.getCmHandleReferencesByDmiPluginIdentifier('my-dmi-plugin-identifier', outputAlternateId)
 216         then: 'result is the correct size'
 217             assert result.size() == 3
 218         and: 'result contains the correct cm handles'
 219             assert result.containsAll(expectedResult)
 220         where:
 221             scenario                        | outputAlternateId || expectedResult
 222             'output is for alternate ids'   | true              || ['alt-PNFDemo', 'alt-PNFDemo2', 'alt-PNFDemo4']
 223             'output is for cm handle ids'   | false             || ['PNFDemo', 'PNFDemo2', 'PNFDemo4']
 224     }
 225
 226     void mockResponses() {
 227
 228         mockCpsQueryService.queryDataNodes(_, _, '//public-properties[@name=\"Contact\" and @value=\"newemailforstore@bookstore.com\"]/ancestor::cm-handles', _) >> [pnfDemo, pnfDemo2, pnfDemo4]
 229         mockCpsQueryService.queryDataNodes(_, _, '//public-properties[@name=\"wont_match\" and @value=\"wont_match\"]/ancestor::cm-handles', _) >> []
 230         mockCpsQueryService.queryDataNodes(_, _, '//public-properties[@name=\"Contact2\" and @value=\"newemailforstore2@bookstore.com\"]/ancestor::cm-handles', _) >> [pnfDemo4]
 231         mockCpsQueryService.queryDataNodes(_, _, '//public-properties[@name=\"Contact2\" and @value=\"\"]/ancestor::cm-handles', _) >> []
 232         mockCpsQueryService.queryDataNodes(_, _, '//state[@cm-handle-state=\"READY\"]/ancestor::cm-handles', _) >> [pnfDemo, pnfDemo3]
 233         mockCpsQueryService.queryDataNodes(_, _, '//state[@cm-handle-state=\"LOCKED\"]/ancestor::cm-handles', _) >> [pnfDemo2, pnfDemo4]
 234         mockCpsQueryService.queryDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-service-name=\'my-dmi-plugin-identifier\']', OMIT_DESCENDANTS) >> [pnfDemo, pnfDemo2]
 235         mockCpsQueryService.queryDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-data-service-name=\'my-dmi-plugin-identifier\']', OMIT_DESCENDANTS) >> [pnfDemo, pnfDemo4]
 236         mockCpsQueryService.queryDataNodes(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-model-service-name=\'my-dmi-plugin-identifier\']', OMIT_DESCENDANTS) >> [pnfDemo2, pnfDemo4]
 237
 238         mockCpsQueryService.queryDataLeaf(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-service-name=\'my-dmi-plugin-identifier\']/@id', _) >> [pnfDemo.getLeaves().get('id'), pnfDemo2.getLeaves().get('id')]
 239         mockCpsQueryService.queryDataLeaf(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-data-service-name=\'my-dmi-plugin-identifier\']/@id', _) >> [pnfDemo.getLeaves().get('id'), pnfDemo4.getLeaves().get('id')]
 240         mockCpsQueryService.queryDataLeaf(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-model-service-name=\'my-dmi-plugin-identifier\']/@id', _) >> [pnfDemo2.getLeaves().get('id'), pnfDemo4.getLeaves().get('id')]
 241
 242         mockCpsQueryService.queryDataLeaf(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-service-name=\'my-dmi-plugin-identifier\']/@alternate-id', _) >> [pnfDemo.getLeaves().get('alternate-id'), pnfDemo2.getLeaves().get('alternate-id')]
 243         mockCpsQueryService.queryDataLeaf(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-data-service-name=\'my-dmi-plugin-identifier\']/@alternate-id', _) >> [pnfDemo.getLeaves().get('alternate-id'), pnfDemo4.getLeaves().get('alternate-id')]
 244         mockCpsQueryService.queryDataLeaf(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@dmi-model-service-name=\'my-dmi-plugin-identifier\']/@alternate-id', _) >> [pnfDemo2.getLeaves().get('alternate-id'), pnfDemo4.getLeaves().get('alternate-id')]
 245         mockCpsQueryService.queryDataLeaf(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@id=\'PNFDemo\']/@alternate-id', _) >> [pnfDemo.getLeaves().get('alternate-id')]
 246         mockCpsQueryService.queryDataLeaf(NCMP_DATASPACE_NAME, NCMP_DMI_REGISTRY_ANCHOR, '/dmi-registry/cm-handles[@id=\'PNFDemo2\' or @id=\'PNFDemo\' or @id=\'PNFDemo4\']/@alternate-id', _) >> [pnfDemo2.getLeaves().get('alternate-id'), pnfDemo.getLeaves().get('alternate-id'), pnfDemo4.getLeaves().get('alternate-id')]
 247     }
 248
 249     def static createDataNode(dataNodeId) {
 250         return new DataNode(xpath: '/dmi-registry/cm-handles[@id=\'' + dataNodeId + '\']', leaves: ['id':dataNodeId, 'alternate-id':'alt-' + dataNodeId])
 251     }
 252 }