blob: 54611e52c4049d5582b242aec037d78e662a444a (
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
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
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
|
/*******************************************************************************
* Copyright (c) 2007, 2008 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
* Genuitec, LLC - added license support
******************************************************************************/
package org.eclipse.equinox.internal.provisional.p2.metadata;
import java.util.Map;
import org.osgi.framework.Version;
public interface IInstallableUnit extends Comparable {
/**
* A capability namespace representing a particular profile flavor.
*/
public static final String NAMESPACE_FLAVOR = "org.eclipse.equinox.p2.flavor"; //$NON-NLS-1$
/**
* A capability namespace representing a particular InstallableUnit by id.
* Each InstallableUnit automatically provides a capability in this namespace representing
* itself, and other InstallableUnits can require such a capability to state that they
* require a particular InstallableUnit to be present.
*
* @see IInstallableUnit#getId()
*/
public static final String NAMESPACE_IU_ID = "org.eclipse.equinox.p2.iu"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.partial.iu"</code>) for a
* boolean property indicating the IU is generated from incomplete information and
* should be replaced by the complete IU if available.
*
* @see #getProperty(String)
*/
public static final String PROP_PARTIAL_IU = "org.eclipse.equinox.p2.partial.iu"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.type.profile"</code>) for a
* boolean property indicating that an installable unit is a profile.
*
* @see #getProperty(String)
*/
public static final String PROP_TYPE_PROFILE = "org.eclipse.equinox.p2.type.profile"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.type.category"</code>) for a
* boolean property indicating that an installable unit is a category.
*
* @see #getProperty(String)
*/
public static final String PROP_TYPE_CATEGORY = "org.eclipse.equinox.p2.type.category"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.type.fragment"</code>) for a
* boolean property indicating that an installable unit is a fragment.
*
* @see #getProperty(String)
*/
public static final String PROP_TYPE_FRAGMENT = "org.eclipse.equinox.p2.type.fragment"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.type.group"</code>) for a
* boolean property indicating that an installable unit is a group.
*
* @see #getProperty(String)
*/
public static final String PROP_TYPE_GROUP = "org.eclipse.equinox.p2.type.group"; //$NON-NLS-1$
//TODO Move to UI
public static final String PROP_PROFILE_ROOT_IU = "org.eclipse.equinox.p2.type.root"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.contact"</code>) for a
* String property containing a contact address where problems can be reported,
* such as an email address.
*
* @see #getProperty(String)
*/
public static final String PROP_CONTACT = "org.eclipse.equinox.p2.contact"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.description"</code>) for a
* String property containing a human-readable description of the installable unit.
*
* @see #getProperty(String)
*/
public static final String PROP_DESCRIPTION = "org.eclipse.equinox.p2.description"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.doc.url"</code>) for a
* String property containing a URL for documentation about the installable unit.
*
* @see #getProperty(String)
*/
public static final String PROP_DOC_URL = "org.eclipse.equinox.p2.doc.url"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.name"</code>) for a
* String property containing a human-readable name for the installable unit.
*
* @see #getProperty(String)
*/
public static final String PROP_NAME = "org.eclipse.equinox.p2.name"; //$NON-NLS-1$
/**
* A property key (value <code>"org.eclipse.equinox.p2.provider"</code>) for a
* String property containing information about the vendor or provider of the
* installable unit.
*
* @see #getProperty(String)
*/
public static final String PROP_PROVIDER = "org.eclipse.equinox.p2.provider"; //$NON-NLS-1$
public IArtifactKey[] getArtifacts();
/**
* Returns the filter on this installable unit. The filter is matched against
* the selection context of the profile the unit is installed into. An IU will not
* be installed if it has a filter condition that is not satisfied by the context.
*
* See Profile#getSelectionContext.
*/
public String getFilter();
/**
* Returns the fragments that have been bound to this installable unit, or
* <code>null</code> if this unit is not resolved.
*
* @see #isResolved()
* @return The fragments bound to this installable unit, or <code>null</code>
*/
public IInstallableUnitFragment[] getFragments();
public String getId();
/**
* Get an <i>unmodifiable copy</i> of the properties
* associated with the installable unit.
*
* @return an <i>unmodifiable copy</i> of the IU properties.
*/
public Map getProperties();
public String getProperty(String key);
public ProvidedCapability[] getProvidedCapabilities();
public RequiredCapability[] getRequiredCapabilities();
public TouchpointData[] getTouchpointData();
public TouchpointType getTouchpointType();
public Version getVersion();
public boolean isFragment();
/**
* Returns whether this installable unit has been resolved. A resolved
* installable unit represents the union of an installable unit and some
* fragments.
*
* @see #getFragments()
* @see #unresolved()
* @return <code>true</code> if this installable unit is resolved, and
* <code>false</code> otherwise.
*/
public boolean isResolved();
public boolean isSingleton();
/**
* Returns the unresolved equivalent of this installable unit. If this unit is
* already unresolved, this method returns the receiver. Otherwise, this
* method returns an installable unit with the same id and version, but without
* any fragments attached.
*
* @see #getFragments()
* @see #isResolved()
* @return The unresolved equivalent of this unit
*/
public IInstallableUnit unresolved();
/**
* Returns information about what this installable unit is an update of.
* @return The lineage information about the installable unit
*/
public IUpdateDescriptor getUpdateDescriptor();
/**
* Returns the license that applies to this installable unit.
* @return the license that applies to this installable unit or <code>null</code>
*/
public License getLicense();
/**
* Returns the copyright that applies to this installable unit.
* @return the copyright that applies to this installable unit or <code>null</code>
*/
public Copyright getCopyright();
}
|
