org.eclipse.update.configuration
Interface IConfiguredSite
-
All Superinterfaces:
-
IAdaptable
Deprecated. The org.eclipse.update component has been replaced by Equinox p2. This
provisional API was never promoted to stable API, and may be removed from a future release of the platform.
-
public interface IConfiguredSite
- extends
IAdaptable
Configured Site.
Represents an installation site "filtered" by configuration information.
Configured site is the target of the feature update operations (install
feature, remove feature, configure feature, unconfigure feature).
Note: This class/interface is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
-
Since:
- 2.0
getSite
ISite getSite()
-
Deprecated.
- Returns the underlying "unfiltered" site.
-
-
-
Returns:
- the underlying site
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
verifyUpdatableStatus
IStatus verifyUpdatableStatus()
-
Deprecated.
- Indicates whether updates can be applied to the site.
IStatus.isOk()
return true
if
the site can be updated, false
otherwise.
If updates cannot be aplied, the status contains the error message, and
the possible exception.
-
-
-
Returns:
- an IStatus
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
-
See Also:
-
IStatus
isUpdatable
boolean isUpdatable()
-
Deprecated.
- Indicates whether updates can be applied to the site.
A configuration site is tagged a non-updatable by reading
the platform configuration for this site.
-
-
-
Returns:
-
true
if the site can be updated,
false
otherwise -
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
install
IFeatureReference install(
IFeature feature,
IVerificationListener verificationListener,
IProgressMonitor monitor)
throws
CoreException
-
Deprecated.
- Install the specified feature on this site.
-
-
-
Parameters:
-
feature
- feature to install -
verificationListener
- verification listener, or null
-
monitor
- progress monitor, or null
-
Throws:
-
CoreException
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
install
IFeatureReference install(
IFeature feature,
IFeatureReference[] optionalFeatures,
IVerificationListener verificationListener,
IProgressMonitor monitor)
throws
CoreException
-
Deprecated.
- Install the specified feature on this site.
Only the specified optional features will be installed
-
-
-
Parameters:
-
feature
- feature to install -
optionalFeatures
- optional features to install -
verificationListener
- verification listener, or null
-
monitor
- progress monitor, or null
-
Throws:
-
CoreException
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
remove
void remove(
IFeature feature,
IProgressMonitor monitor)
throws
CoreException
-
Deprecated.
- Remove (uninstall) the specified feature from this site
-
-
-
Parameters:
-
feature
- feature to remove -
monitor
- progress monitor, or null
-
Throws:
-
CoreException
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
getBrokenStatus
IStatus getBrokenStatus(
IFeature feature)
-
Deprecated.
- Indicates if the specified feature is "broken". A feature is considered
to be broken in the context of this site, if some of the plug-ins
referenced by the feature are not installed on this site.
The status code is
IStatus.ERROR
if the feature is considered
broken. The Status may contain the reason why the feature is broken.
The status code is IStatus.OK
if the feature is not considered
broken.
-
-
-
Parameters:
-
feature
- the feature
-
Returns:
- the status for this feature on this configured site
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
isConfigured
boolean isConfigured(
IFeature feature)
-
Deprecated.
- Indicates if the specified feature is configured on this site.
-
-
-
Parameters:
-
feature
- the feature
-
Returns:
-
true
if the feature is configured,
false
otherwise -
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
configure
void configure(
IFeature feature)
throws
CoreException
-
Deprecated.
- Configure the specified feature on this site. The configured
feature will be included on next startup.
-
-
-
Parameters:
-
feature
- the feature
-
Throws:
-
CoreException
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
unconfigure
boolean unconfigure(
IFeature feature)
throws
CoreException
-
Deprecated.
- Unconfigure the specified feature from this site. The unconfigured
feature will be omitted on the next startup.
-
-
-
Parameters:
-
feature
- the feature
-
Throws:
-
CoreException
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
getConfiguredFeatures
IFeatureReference[] getConfiguredFeatures()
-
Deprecated.
- Return references to features configured on this site.
-
-
-
Returns:
- an array of feature references, or an empty array.
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
getFeatureReferences
IFeatureReference[] getFeatureReferences()
-
Deprecated.
- Return all features installed on this site (configured as well
as unconfigured). Note, that if the site requires reconciliation,
the result may not match the result of the corresponding method
on the underlying site.
-
-
-
Returns:
- an array of site feature references, or an empty array.
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
-
See Also:
-
ISite.getFeatureReferences()
getInstallConfiguration
IInstallConfiguration getInstallConfiguration()
-
Deprecated.
- Returns the install configuration object this site is part of.
-
-
-
Returns:
- install configuration object
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
addConfiguredSiteChangedListener
void addConfiguredSiteChangedListener(
IConfiguredSiteChangedListener listener)
-
Deprecated.
- Adds a change listener to the configured site.
-
-
-
Parameters:
-
listener
- the listener to add -
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
removeConfiguredSiteChangedListener
void removeConfiguredSiteChangedListener(
IConfiguredSiteChangedListener listener)
-
Deprecated.
- Removes a change listener from the configured site.
-
-
-
Parameters:
-
listener
- the listener to remove -
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
isExtensionSite
boolean isExtensionSite()
-
Deprecated.
- Indicates if the site is an extension site.
-
-
-
Returns:
-
true
if the site is an extension site,
false
otherwise -
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
isProductSite
boolean isProductSite()
-
Deprecated.
- Indicates if the site is a product site.
-
-
-
Returns:
-
true
if the site is a product site,
false
otherwise -
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
isPrivateSite
boolean isPrivateSite()
-
Deprecated. private site are considered the same as extension site (3.0)
- Indicates if the site is a private site.
This does not check if this private site belongs to the
product that is running.
-
-
-
Returns:
-
true
if the site is a private site,
false
otherwise -
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
isNativelyLinked
boolean isNativelyLinked()
throws
CoreException
-
Deprecated.
- Indicates if the site has been linked by a native
installer.
-
-
-
Returns:
-
true
if the site is a natively linked site,
false
otherwise
-
Throws:
-
CoreException
-
Since:
- 2.0
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
setEnabled
void setEnabled(boolean value)
-
Deprecated.
- Sets if the site is enabled
-
-
-
Parameters:
-
value
- true
if the site is enable, false
otherwise -
Since:
- 2.1
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
isEnabled
boolean isEnabled()
-
Deprecated.
- Indicates if the site is enabled.
If a site is not enable, all teh features are considered disabled.
-
-
-
Returns:
-
true
if the site is enable, false
otherwise -
Since:
- 2.1
Note: This method is part of an interim API that is still under development and expected to
change significantly before reaching stability. It is being made available at this early stage to solicit feedback
from pioneering adopters on the understanding that any code that uses this API will almost certainly be broken
(repeatedly) as the API evolves.
Guidelines for using Eclipse APIs.
Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.