a7216ed7f09cca2eaf245ff586062fa942d4b411
[policy/clamp.git] /
1 /*-
2  * ============LICENSE_START=======================================================
3  * Copyright (C) 2021 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
8  *
9  *      http://www.apache.org/licenses/LICENSE-2.0
10  *
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.
16  *
17  * SPDX-License-Identifier: Apache-2.0
18  * ============LICENSE_END=========================================================
19  */
20
21 package org.onap.policy.clamp.controlloop.models.controlloop.persistence.provider;
22
23 import java.time.Instant;
24 import java.util.ArrayList;
25 import java.util.List;
26 import java.util.Map;
27 import java.util.stream.Collectors;
28 import lombok.NonNull;
29 import org.onap.policy.clamp.controlloop.models.controlloop.concepts.ParticipantStatistics;
30 import org.onap.policy.clamp.controlloop.models.controlloop.persistence.concepts.JpaParticipantStatistics;
31 import org.onap.policy.models.base.PfModelException;
32 import org.onap.policy.models.base.PfTimestampKey;
33 import org.onap.policy.models.dao.PfFilterParameters;
34 import org.onap.policy.models.provider.PolicyModelsProviderParameters;
35 import org.onap.policy.models.provider.impl.AbstractModelsProvider;
36
37 /**
38  * This class provides the provision of information on participant statistics in the database to callers.
39  */
40 public class ParticipantStatisticsProvider extends AbstractModelsProvider {
41
42     /**
43      * Create a provider for control loops statistics.
44      *
45      * @param parameters the parameters for database access
46      * @throws PfModelException on initiation errors
47      */
48     public ParticipantStatisticsProvider(@NonNull PolicyModelsProviderParameters parameters) throws PfModelException {
49         super(parameters);
50         this.init();
51     }
52
53     /**
54      * Get Participant statistics.
55      *
56      * @param name the name of the participant statistics to get, null to get all stats
57      * @param version the version of the participant statistics to get, null to get all stats for a name
58      * @param timestamp the time stamp for the stats to get
59      * @return the participant statistics found
60      * @throws PfModelException on errors getting participant statistics
61      */
62     public List<ParticipantStatistics> getParticipantStatistics(final String name, final String version,
63             final Instant timestamp) throws PfModelException {
64
65         if (name != null && version != null && timestamp != null) {
66             List<ParticipantStatistics> participantStatistics = new ArrayList<>(1);
67             participantStatistics.add(getPfDao()
68                     .get(JpaParticipantStatistics.class, new PfTimestampKey(name, version, timestamp)).toAuthorative());
69             return participantStatistics;
70         } else if (name != null) {
71             return getFilteredParticipantStatistics(name, version, timestamp, null, null, "DESC", 0);
72         } else {
73             return asParticipantStatisticsList(getPfDao().getAll(JpaParticipantStatistics.class));
74         }
75     }
76
77
78     /**
79      * Get filtered participant statistics.
80      *
81      * @param name the participant name for the statistics to get
82      * @param version the participant version for the statistics to get
83      * @param startTimeStamp startTimeStamp to filter statistics
84      * @param endTimeStamp endTimeStamp to filter statistics
85      * @param sortOrder sortOrder to query database
86      * @param getRecordNum Total query count from database
87      * @param filterMap the filters to apply to the get operation
88      * @return the participant statistics found
89      * @throws PfModelException on errors getting policies
90      */
91     public List<ParticipantStatistics> getFilteredParticipantStatistics(final String name, final String version,
92             final Instant startTimeStamp, final Instant endTimeStamp, Map<String, Object> filterMap,
93             final String sortOrder, final int getRecordNum) {
94
95         // @formatter:off
96         PfFilterParameters filterParams = PfFilterParameters
97                 .builder()
98                 .name(name)
99                 .version(version)
100                 .startTime(startTimeStamp)
101                 .endTime(endTimeStamp)
102                 .filterMap(filterMap)
103                 .sortOrder(sortOrder)
104                 .recordNum(getRecordNum)
105                 .build();
106         // @formatter:on
107
108         return asParticipantStatisticsList(getPfDao().getFiltered(JpaParticipantStatistics.class, filterParams));
109     }
110
111
112     /**
113      * Creates Participant statistics.
114      *
115      * @param participantStatisticsList a specification of the CL statistics to create
116      * @return the participant statistics created
117      * @throws PfModelException on errors creating participant statistics
118      */
119     public List<ParticipantStatistics> createParticipantStatistics(
120             @NonNull final List<ParticipantStatistics> participantStatisticsList) throws PfModelException {
121
122         List<JpaParticipantStatistics> jpaParticipantStatisticsList = ProviderUtils
123                 .getJpaAndValidate(participantStatisticsList, JpaParticipantStatistics::new, "Participant Statistics");
124
125         jpaParticipantStatisticsList.forEach(jpaParticipantStatistics -> getPfDao().update(jpaParticipantStatistics));
126
127         // Return the created participant statistics
128         List<ParticipantStatistics> participantStatistics = new ArrayList<>(participantStatisticsList.size());
129
130         for (ParticipantStatistics participantStatisticsItem : participantStatisticsList) {
131             var jpaParticipantStatistics = getPfDao().get(JpaParticipantStatistics.class,
132                     new PfTimestampKey(participantStatisticsItem.getParticipantId().getName(),
133                             participantStatisticsItem.getParticipantId().getVersion(),
134                             participantStatisticsItem.getTimeStamp()));
135             participantStatistics.add(jpaParticipantStatistics.toAuthorative());
136         }
137
138         return participantStatistics;
139     }
140
141
142
143     /**
144      * Convert JPA participant statistics list to participant statistics list.
145      *
146      * @param jpaParticipantStatisticsList the list to convert
147      * @return the participant statistics list
148      */
149     private List<ParticipantStatistics> asParticipantStatisticsList(
150             List<JpaParticipantStatistics> jpaParticipantStatisticsList) {
151
152         return jpaParticipantStatisticsList.stream().map(JpaParticipantStatistics::toAuthorative)
153                 .collect(Collectors.toList());
154     }
155 }