|
Eclipse Platform Release 3.6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IInstallableUnit
An installable unit represents an atomic, indivisible unit of installable functionality in a provisioned system. Everything that can be installed or uninstalled in a system, including both concrete artifacts and instructions describing steps to be performed during install, must be expressed as one or more installable units. Thus the set of installable units present in a system, together with the existing environment (operating system, etc), completely describes the initial installed state of that system.
Installable units may have dependencies on functionality provided by other installable units, such that the unit cannot be installed unless some other installable unit is present in the installed system that provides a matching capability. Such dependencies are referred to as required capabilities. Conversely, installable units may declared provided capabilities, describing the capabilities that they make available to other units in the system. Note the weak coupling at work here: installable units never directly depend on each other, but instead depend on abstract capabilities that any other installable unit may provide.
Field Summary | |
---|---|
static String |
NAMESPACE_IU_ID
A capability namespace representing a particular InstallableUnit by id. |
static String |
PROP_BUNDLE_LOCALIZATION
A property key (value "org.eclipse.equinox.p2.bundle.localization" ) for a String
property containing the bundle localization property file name |
static String |
PROP_CONTACT
A property key (value "org.eclipse.equinox.p2.contact" ) for a
String property containing a contact address where problems can be reported,
such as an email address. |
static String |
PROP_DESCRIPTION
A property key (value "org.eclipse.equinox.p2.description" ) for a
String property containing a human-readable description of the installable unit. |
static String |
PROP_DESCRIPTION_URL
A property key (value "org.eclipse.equinox.p2.description.url" ) for a
String property containing a URL to the description of the installable unit. |
static String |
PROP_DOC_URL
A property key (value "org.eclipse.equinox.p2.doc.url" ) for a
String property containing a URL for documentation about the installable unit. |
static String |
PROP_ICON
A property key (value "org.eclipse.equinox.p2.icon" ) for a String
property containing a URI for an icon that should be shown when displaying this
installable unit in a user interface. |
static String |
PROP_NAME
A property key (value "org.eclipse.equinox.p2.name" ) for a
String property containing a human-readable name for the installable unit. |
static String |
PROP_PARTIAL_IU
A property key (value "org.eclipse.equinox.p2.partial.iu" ) for a
boolean property indicating the IU is generated from incomplete information and
should be replaced by the complete IU if available. |
static String |
PROP_PROVIDER
A property key (value "org.eclipse.equinox.p2.provider" ) for a
String property containing information about the vendor or provider of the
installable unit. |
Method Summary | |
---|---|
boolean |
equals(Object obj)
Returns whether this InstallableUnit is equal to the given object. |
Collection<IArtifactKey> |
getArtifacts()
Returns the collection of artifacts associated with this installable unit. |
ICopyright |
getCopyright()
Returns the untranslated copyright that applies to this installable unit. |
ICopyright |
getCopyright(String locale)
Returns the copyright that applies to this installable unit. |
IMatchExpression<IInstallableUnit> |
getFilter()
Returns the filter on this installable unit. |
Collection<IInstallableUnitFragment> |
getFragments()
Returns the fragments that have been bound to this installable unit, or null if this unit is not resolved. |
Collection<ILicense> |
getLicenses()
Returns the untranslated licenses that apply to this installable unit. |
Collection<ILicense> |
getLicenses(String locale)
Returns the licenses that apply to this installable unit. |
Collection<IRequirement> |
getMetaRequirements()
|
Map<String,String> |
getProperties()
Returns an unmodifiable copy of the properties associated with the installable unit. |
String |
getProperty(String key)
Returns the untranslated property of this installable unit associated with the given key. |
String |
getProperty(String key,
String locale)
Returns the property of this installable unit associated with the given key. |
Collection<IProvidedCapability> |
getProvidedCapabilities()
Returns the collection of capabilities provided by this installable unit. |
Collection<IRequirement> |
getRequirements()
|
Collection<ITouchpointData> |
getTouchpointData()
|
ITouchpointType |
getTouchpointType()
|
IUpdateDescriptor |
getUpdateDescriptor()
Returns information about what this installable unit is an update of. |
boolean |
isResolved()
Returns whether this installable unit has been resolved. |
boolean |
isSingleton()
Returns whether this installable unit is a singleton. |
boolean |
satisfies(IRequirement candidate)
Returns whether this unit has a provided capability that satisfies the given requirement. |
IInstallableUnit |
unresolved()
Returns the unresolved equivalent of this installable unit. |
Methods inherited from interface org.eclipse.equinox.p2.metadata.IVersionedId |
---|
getId, getVersion |
Methods inherited from interface java.lang.Comparable |
---|
compareTo |
Field Detail |
---|
static final String NAMESPACE_IU_ID
IVersionedId.getId()
,
Constant Field Valuesstatic final String PROP_PARTIAL_IU
"org.eclipse.equinox.p2.partial.iu"
) for a
boolean property indicating the IU is generated from incomplete information and
should be replaced by the complete IU if available.
getProperty(String)
,
Constant Field Valuesstatic final String PROP_CONTACT
"org.eclipse.equinox.p2.contact"
) for a
String property containing a contact address where problems can be reported,
such as an email address.
getProperty(String)
,
Constant Field Valuesstatic final String PROP_DESCRIPTION
"org.eclipse.equinox.p2.description"
) for a
String property containing a human-readable description of the installable unit.
getProperty(String)
,
Constant Field Valuesstatic final String PROP_DESCRIPTION_URL
"org.eclipse.equinox.p2.description.url"
) for a
String property containing a URL to the description of the installable unit.
getProperty(String)
,
Constant Field Valuesstatic final String PROP_DOC_URL
"org.eclipse.equinox.p2.doc.url"
) for a
String property containing a URL for documentation about the installable unit.
getProperty(String)
,
Constant Field Valuesstatic final String PROP_BUNDLE_LOCALIZATION
"org.eclipse.equinox.p2.bundle.localization"
) for a String
property containing the bundle localization property file name
static final String PROP_NAME
"org.eclipse.equinox.p2.name"
) for a
String property containing a human-readable name for the installable unit.
getProperty(String)
,
Constant Field Valuesstatic final String PROP_PROVIDER
"org.eclipse.equinox.p2.provider"
) for a
String property containing information about the vendor or provider of the
installable unit.
getProperty(String)
,
Constant Field Valuesstatic final String PROP_ICON
"org.eclipse.equinox.p2.icon"
) for a String
property containing a URI for an icon that should be shown when displaying this
installable unit in a user interface.
getProperty(String)
,
Constant Field ValuesMethod Detail |
---|
Collection<IArtifactKey> getArtifacts()
IMatchExpression<IInstallableUnit> getFilter()
null
Collection<IInstallableUnitFragment> getFragments()
null
if this unit is not resolved.
null
isResolved()
Map<String,String> getProperties()
String getProperty(String key)
null
if no such property is defined.
If the property value has been externalized, this method will return a string containing
the translation key rather than a human-readable string. For this reason, clients
wishing to obtain the value for a property that is typically translated should use
getProperty(String, String)
instead.
key
- The property key to retrieve a property value for
null
String getProperty(String key, String locale)
null
if no such property is defined or no applicable
translation is available.
key
- The property key to retrieve a property value forlocale
- The locale to translate the property for, or null to use the current locale.
null
Collection<IProvidedCapability> getProvidedCapabilities()
Collection<IRequirement> getRequirements()
Collection<IRequirement> getMetaRequirements()
Collection<ITouchpointData> getTouchpointData()
ITouchpointType getTouchpointType()
boolean isResolved()
true
if this installable unit is resolved, and
false
otherwise.getFragments()
,
unresolved()
boolean isSingleton()
true
if this unit is a singleton, and false
otherwiseboolean satisfies(IRequirement candidate)
true
if this unit satisfies the given requirement, and false
otherwise.IInstallableUnit unresolved()
getFragments()
,
isResolved()
IUpdateDescriptor getUpdateDescriptor()
Collection<ILicense> getLicenses()
If the license text has been externalized, this method will return strings containing
the translation keys rather than human-readable strings. For this reason, clients
wishing to obtain a license for display to an end user should use getLicenses(String)
instead.
Collection<ILicense> getLicenses(String locale)
locale
- The locale to translate the license for, or null to use the current locale.
ICopyright getCopyright()
If the copyright text has been externalized, this method will return strings containing
the translation keys rather than human-readable strings. For this reason, clients
wishing to obtain a copyright for display to an end user should use getCopyright(String)
instead.
null
ICopyright getCopyright(String locale)
null
if this
unit has no copyright, or if the copyright is externalized and no translations are
available for the given locale.
locale
- The locale to translate the copyright for, or null to use the current locale.
null
boolean equals(Object obj)
equals
in class Object
|
Eclipse Platform Release 3.6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) Eclipse contributors and others 2000, 2010. All rights reserved.