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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
/*******************************************************************************
* Copyright (c) 2007, 2017 IBM Corporation and others.
*
* This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* IBM Corporation - initial API and implementation
* EclipseSource - ongoing development
*******************************************************************************/
package org.eclipse.equinox.internal.p2.metadata;
import org.eclipse.equinox.p2.metadata.IInstallableUnit;
import org.eclipse.equinox.p2.metadata.IProvidedCapability;
import org.eclipse.equinox.p2.metadata.IRequirement;
import org.eclipse.equinox.p2.metadata.MetadataFactory;
import org.eclipse.equinox.p2.metadata.VersionRange;
import org.eclipse.equinox.p2.metadata.expression.IMatchExpression;
import org.eclipse.equinox.p2.metadata.expression.IMemberProvider;
/**
* A requirement represents some external constraint on an {@link IInstallableUnit}.
* Each requirement represents something an {@link IInstallableUnit} needs that
* it expects to be provided by another {@link IInstallableUnit}. Requirements are
* entirely generic, and are intended to be capable of representing anything that
* an {@link IInstallableUnit} may need either at install time, or at runtime.
* <p>
* Instances of this class are handle objects and do not necessarily
* reflect entities that exist in any particular profile or repository. These handle
* objects can be created using {@link MetadataFactory}.
* </p>
*
* @noimplement This interface is not intended to be implemented by clients.
* @noextend This interface is not intended to be extended by clients.
* @since 2.0
* @see IProvidedCapability
* @see MetadataFactory#createRequirement(String, String, VersionRange, String, boolean, boolean, boolean)
*/
public class Requirement implements IRequirement, IMemberProvider {
public static final String MEMBER_FILTER = "filter"; //$NON-NLS-1$
public static final String MEMBER_MIN = "min"; //$NON-NLS-1$
public static final String MEMBER_MAX = "max"; //$NON-NLS-1$
public static final String MEMBER_GREEDY = "greedy"; //$NON-NLS-1$
public static final String MEMBER_MATCH = "match"; //$NON-NLS-1$
protected final IMatchExpression<IInstallableUnit> filter;
protected final IMatchExpression<IInstallableUnit> matchExpression;
protected final boolean greedy;
protected final int min;
protected final int max;
protected final String description;
public Requirement(IMatchExpression<IInstallableUnit> requirement, IMatchExpression<IInstallableUnit> filter, int min, int max, boolean greedy, String description) {
this.matchExpression = requirement;
this.filter = filter;
this.min = min;
this.max = max;
this.greedy = greedy;
this.description = description;
}
@Override
public String toString() {
StringBuilder result = new StringBuilder();
// Expression
result.append(matchExpression);
// Parameters
Object[] params = matchExpression.getParameters();
if (params.length > 0) {
result.append(" ("); //$NON-NLS-1$
for (int i = 0; i < params.length; i++) {
if (i > 0) {
result.append(", "); //$NON-NLS-1$
}
result.append(params[i]);
}
result.append(')');
}
return result.toString();
}
@Override
public int hashCode() {
final int prime = 31;
int result = 1;
result = prime * result + ((filter == null) ? 0 : filter.hashCode());
result = prime * result + matchExpression.hashCode();
return result;
}
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (!(obj instanceof IRequirement)) {
return false;
}
IRequirement other = (IRequirement) obj;
if (filter == null) {
if (other.getFilter() != null) {
return false;
}
} else if (!filter.equals(other.getFilter())) {
return false;
}
return min == other.getMin() && max == other.getMax() && greedy == other.isGreedy() && matchExpression.equals(other.getMatches());
}
@Override
public String getDescription() {
return description;
}
@Override
public int getMin() {
return min;
}
@Override
public int getMax() {
return max;
}
@Override
public boolean isGreedy() {
return greedy;
}
@Override
public IMatchExpression<IInstallableUnit> getFilter() {
return filter;
}
@Override
public IMatchExpression<IInstallableUnit> getMatches() {
return matchExpression;
}
@Override
public boolean isMatch(IInstallableUnit candidate) {
return matchExpression.isMatch(candidate);
}
@Override
public Object getMember(String memberName) {
switch (memberName) {
case MEMBER_FILTER :
return filter;
case MEMBER_MIN :
return min;
case MEMBER_MAX :
return max;
case MEMBER_GREEDY :
return greedy;
case MEMBER_MATCH :
return matchExpression;
default :
throw new IllegalArgumentException("No such member: " + memberName); //$NON-NLS-1$
}
}
}
|
