public interface ExecutionEnvironmentConfiguration
Instances of this type collect information on the execution environment a project is targeted to.
Since there are multiple ways to configure the execution environment, and some of them are
project type specific, it is explicitly allowed to call the configuration setters of an instance
multiple times. In order to ensure that all configuration sources are taken into account,
IllegalStateException
s are thrown if the configuration setters are called too late, i.e.
after the effective configuration has been queried for the first time.
In case of an custom execution environment, the information required for the build can not be directly computed from the configuration. Therefore, this instance also has a callback to add the missing information as soon as it has been extracted from the target platform.
Modifier and Type | Method and Description |
---|---|
ExecutionEnvironment |
getFullSpecification()
Returns the execution environment specification with information needed for the build.
|
String |
getProfileName()
Returns the name of the configured profile.
|
boolean |
isCustomProfile()
Returns
true if the configured profile is not one of the known standard
execution environments. |
boolean |
isIgnoredByResolver() |
void |
overrideProfileConfiguration(String profileName,
String configurationOrigin)
Sets the effective profile configuration.
|
void |
setFullSpecificationForCustomProfile(List<SystemCapability> systemCapabilities)
Call-back for setting the actual specification for the configured custom profile.
|
void |
setProfileConfiguration(String profileName,
String configurationOrigin)
Sets the effective profile configuration, unless the method
overrideProfileConfiguration(String, String) has been called on this instance. |
void overrideProfileConfiguration(String profileName, String configurationOrigin) throws IllegalStateException
IllegalStateException
- if the configuration has been already frozen by calling any one of the getters
defined in ExecutionEnvironmentConfiguration
void setProfileConfiguration(String profileName, String configurationOrigin) throws IllegalStateException
overrideProfileConfiguration(String, String)
has been called on this instance.IllegalStateException
- if the configuration has been already frozen by calling any one of the getters
defined in ExecutionEnvironmentConfiguration
String getProfileName()
boolean isCustomProfile()
true
if the configured profile is not one of the known standard
execution environments.void setFullSpecificationForCustomProfile(List<SystemCapability> systemCapabilities) throws IllegalStateException
IllegalStateException
- if the configured execution environment profile is not a custom profileisCustomProfile()
ExecutionEnvironment getFullSpecification() throws IllegalStateException
IllegalStateException
- if a custom execution environment profile has been configure, and
setFullSpecificationForCustomProfile(List)
has not been called.ExecutionEnvironment
boolean isIgnoredByResolver()
Copyright © 2008–2020 Eclipse Foundation. All rights reserved.