Skip to main content
aboutsummaryrefslogtreecommitdiffstats
blob: 7840962f89fcf1078df6fdf89b000c7e4ea18849 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
/*******************************************************************************
 * Copyright (c) 2014 École Polytechnique de Montréal
 *
 * All rights reserved. This program and the accompanying materials are
 * made available under the terms of the Eclipse Public License v1.0 which
 * accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *   Guilliano Molaire - Initial API and implementation
 *   Mathieu Rail - Initial API and implementation
 *******************************************************************************/

package org.eclipse.tracecompass.tmf.core.analysis;

import java.util.HashSet;
import java.util.Set;

import org.eclipse.tracecompass.tmf.core.analysis.TmfAnalysisRequirement.ValuePriorityLevel;

import com.google.common.collect.HashMultimap;
import com.google.common.collect.SetMultimap;

/**
 * Helper class to simplify analysis requirement management.
 *
 * @author Guilliano Molaire
 * @since 3.0
 */
public final class TmfAnalysisRequirementHelper {

    /**
     * Private constructor. The class should not be instantiated.
     */
    private TmfAnalysisRequirementHelper() {
    }

    /**
     * Gets the requirement values of a given type from an analysis requirement
     * provider. Only values linked to the type will be returned.
     *
     * @param provider
     *            The analysis requirement provider
     * @param type
     *            The type of the requirement values we need
     * @return The list of values for the specified type
     */
    public static Set<String> getRequirementValues(IAnalysisRequirementProvider provider, String type) {
        Set<String> values = new HashSet<>();
        for (TmfAnalysisRequirement requirement : provider.getAnalysisRequirements()) {
            if (requirement.getType().equalsIgnoreCase(type)) {
                values.addAll(requirement.getValues());
            }
        }
        return values;
    }

    /**
     * Gets the requirement values of a given type from an analysis requirement
     * provider, with the specified level. Only values associated with that type
     * and level will be returned.
     *
     * @param provider
     *            The analysis requirement provider
     * @param type
     *            The type of the requirement values we need
     * @param level
     *            The priority level of the values to be returned
     * @return The list of values for the specified type
     */
    public static Set<String> getRequirementValues(IAnalysisRequirementProvider provider, String type, ValuePriorityLevel level) {
        Set<String> values = new HashSet<>();
        for (TmfAnalysisRequirement requirement : provider.getAnalysisRequirements()) {
            if (requirement.getType().equalsIgnoreCase(type)) {
                for (String value : requirement.getValues()) {
                    if (requirement.getValueLevel(value) == level) {
                        values.add(value);
                    }
                }
            }
        }
        return values;
    }

    /**
     * Gets a map in which the keys are the types of different requirements and
     * the values represent a set of requirement values linked to that type.
     *
     * @param providers
     *            The set of analysis requirement provider
     * @return A map with the values keyed by type
     */
    public static SetMultimap<String, String> getRequirementValuesMap(Iterable<IAnalysisRequirementProvider> providers) {
        SetMultimap<String, String> valuesByType = HashMultimap.create();
        for (IAnalysisRequirementProvider provider : providers) {
            for (TmfAnalysisRequirement requirement : provider.getAnalysisRequirements()) {
                valuesByType.putAll(requirement.getType(), requirement.getValues());
            }
        }
        return valuesByType;
    }

    /**
     * Gets a map in which the keys are the types of different requirements and
     * the values represents a list of requirement values linked to that type.
     * We only take values with the same priority level as the argument.
     *
     * @param providers
     *            The set of analysis requirement provider
     * @param level
     *            The priority level of the values to be returned
     * @return A map with the values keyed by type
     */
    public static SetMultimap<String, String> getRequirementValuesMap(Iterable<IAnalysisRequirementProvider> providers, ValuePriorityLevel level) {
        SetMultimap<String, String> valuesByType = HashMultimap.create();
        for (IAnalysisRequirementProvider provider : providers) {
            for (TmfAnalysisRequirement requirement : provider.getAnalysisRequirements()) {
                /* Since it's a set, there will be no duplicate */
                for (String value : requirement.getValues()) {
                    if (requirement.getValueLevel(value) == level) {
                        valuesByType.put(requirement.getType(), value);
                    }
                }
            }
        }
        return valuesByType;
    }
}

Back to the top