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
|
/*******************************************************************************
* Copyright (c) 2007 IBM Corporation and others. 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: IBM Corporation - initial API and implementation
******************************************************************************/
package org.eclipse.equinox.prov.metadata;
import org.eclipse.core.runtime.Assert;
import org.eclipse.osgi.service.resolver.VersionRange;
/**
* A required capability represents some external constraint on an {@link InstallableUnit}.
* Each capability represents something an {@link InstallableUnit} needs that
* it expects to be provided by another {@link InstallableUnit}. Capabilities are
* entirely generic, and are intended to be capable of representing anything that
* an {@link InstallableUnit} may need either at install time, or at runtime.
* <p>
* Capabilities are segmented into namespaces. Anyone can introduce new
* capability namespaces. Some well-known namespaces are introduced directly
* by the provisioning framework.
*
* @see InstallableUnit#IU_KIND_NAMESPACE
* @see InstallableUnit#IU_NAMESPACE
*/
public class RequiredCapability {
private String filter;
private boolean multiple;
private String name;
private String namespace;
boolean optional;
private String range;
private String[] selectors;
private transient VersionRange rangeObject;
/**
* Returns a {@link RequiredCapability} on the installable unit with the given name
* and version range.
*/
public static RequiredCapability createRequiredCapabilityForName(String name, VersionRange versionRange, boolean optional) {
return new RequiredCapability(IInstallableUnit.IU_NAMESPACE, name, versionRange, null, optional, false);
}
public RequiredCapability(String namespace, String name, VersionRange range) {
this(namespace, name, range, null, false, false);
}
public RequiredCapability(String namespace, String name, VersionRange range, String filter, boolean optional, boolean multiple) {
this(namespace, name, range, null, filter, optional, multiple);
}
public RequiredCapability(String namespace, String name, VersionRange range, String[] selectors, String filter, boolean optional, boolean multiple) {
Assert.isNotNull(namespace);
Assert.isNotNull(name);
this.namespace = namespace;
this.name = name;
this.rangeObject = range;
this.range = rangeObject == null ? null : rangeObject.toString();
this.selectors = selectors == null ? new String[0] : selectors;
this.optional = optional;
this.filter = filter;
this.multiple = multiple;
}
public void accept(IMetadataVisitor visitor) {
visitor.visitRequiredCapability(this);
}
public String getFilter() {
return filter;
}
public String getName() {
return name;
}
public String getNamespace() {
return namespace;
}
public VersionRange getRange() {
if (rangeObject == null)
rangeObject = range == null ? VersionRange.emptyRange : new VersionRange(range);
return rangeObject;
}
public boolean isMultiple() {
return multiple;
}
public boolean isOptional() {
return optional;
}
public String toString() {
return "requiredCapability: " + namespace + '/' + name + '/' + range;
}
public int hashCode() {
final int prime = 31;
int result = 1;
result = prime * result + ((filter == null) ? 0 : filter.hashCode());
result = prime * result + (multiple ? 1231 : 1237);
result = prime * result + ((name == null) ? 0 : name.hashCode());
result = prime * result + ((namespace == null) ? 0 : namespace.hashCode());
result = prime * result + (optional ? 1231 : 1237);
result = prime * result + ((rangeObject == null) ? 0 : rangeObject.hashCode());
return result;
}
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (getClass() != obj.getClass())
return false;
final RequiredCapability other = (RequiredCapability) obj;
if (filter == null) {
if (other.filter != null)
return false;
} else if (!filter.equals(other.filter))
return false;
if (multiple != other.multiple)
return false;
if (name == null) {
if (other.name != null)
return false;
} else if (!name.equals(other.name))
return false;
if (namespace == null) {
if (other.namespace != null)
return false;
} else if (!namespace.equals(other.namespace))
return false;
if (optional != other.optional)
return false;
if (rangeObject == null) {
if (other.rangeObject != null)
return false;
} else if (!rangeObject.equals(other.rangeObject))
return false;
return true;
}
/**
* Returns the properties to use for evaluating required capability filters
* downstream from this capability. For example, if the selector "doc"
* is provided, then a downstream InstallableUnit with a required capability
* filtered with "doc=true" will be included.
*/
public String[] getSelectors() {
return selectors;
}
}
|
