public interface IExecutionEnvironment
IVMInstall
).
An execution environment is contributed in plug-in XML via the
org.eclipse.jdt.launching.executionEnvironments
extension
point.
Clients contributing execution environments may provide and implement execution environment analyzer delegates.
IExecutionEnvironmentAnalyzerDelegate
Modifier and Type | Method and Description |
---|---|
IAccessRule[][] |
getAccessRules(IVMInstall vm,
LibraryLocation[] libraries,
IJavaProject project)
Returns a collection of access rules to be applied to the specified VM
libraries for this execution environment in the context of the given project.
|
IVMInstall[] |
getCompatibleVMs()
Returns a collection of VM installs compatible with this environment,
possibly empty.
|
Map<String,String> |
getComplianceOptions()
Returns a map of Eclipse Java compiler options specified as default settings to
use when building with this profile, or
null if unspecified. |
IVMInstall |
getDefaultVM()
Returns the VM that is used by default for this execution environment,
or
null if none. |
String |
getDescription()
Returns a brief human-readable description of this environment.
|
String |
getId()
Returns a unique identifier for this execution environment.
|
Properties |
getProfileProperties()
Returns the OSGi profile properties associated with this execution environment
or
null if none. |
IExecutionEnvironment[] |
getSubEnvironments()
Returns a collection of execution environments that are subsets of this environment.
|
boolean |
isStrictlyCompatible(IVMInstall vm)
Returns whether the specified VM install is strictly compatible with
this environment.
|
void |
setDefaultVM(IVMInstall vm)
Sets the VM to use by default for this execution environment.
|
String getId()
id
attribute in plug-in XML.String getDescription()
IVMInstall[] getCompatibleVMs()
boolean isStrictlyCompatible(IVMInstall vm)
true
to indicate the VM install
is strictly compatible with this environment and false
to indicate
the VM install represents a superset of this environment.vm
- VM installIVMInstall getDefaultVM()
null
if none.null
if nonevoid setDefaultVM(IVMInstall vm)
vm
- VM to use by default for this execution environment,
or null
to clear the default settingIllegalArgumentException
- if the given VM is not compatible with
this environmentIAccessRule[][] getAccessRules(IVMInstall vm, LibraryLocation[] libraries, IJavaProject project)
libraries
, possibly empty.
Access rules for an execution environment are defined by access rule participants
contributed in a org.eclipse.jdt.launching.executionEnvironments
extension.
vm
- the VM that access rules are requested forlibraries
- the libraries that access rules are requested forproject
- the project the access rules are requested for or null
if noneProperties getProfileProperties()
null
if none. Profile properties specify attributes such as
Constants.FRAMEWORK_SYSTEMPACKAGES
. Profile properties
can be optionally contributed with an execution environment extension.null
if noneIExecutionEnvironment[] getSubEnvironments()
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.