Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse JDT
Release 3.5

org.eclipse.jdt.launching.environments
Interface IExecutionEnvironment


public interface IExecutionEnvironment

An execution environment describes capabilities of a Java runtime environment (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.

Since:
3.2
See Also:
IExecutionEnvironmentAnalyzerDelegate
Restriction:
This interface is not intended to be implemented by clients.
Restriction:
This interface is not intended to be extended by clients.

Method Summary
  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 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.
 

Method Detail

getId

String getId()
Returns a unique identifier for this execution environment. Corresponds to the id attribute in plug-in XML.

Returns:
unique identifier of this execution environment

getDescription

String getDescription()
Returns a brief human-readable description of this environment.

Returns:
brief human-readable description of this environment.

getCompatibleVMs

IVMInstall[] getCompatibleVMs()
Returns a collection of vm installs compatible with this environment, possibly empty.

Returns:
a collection of vm installs compatible with this environment, possibly empty.

isStrictlyCompatible

boolean isStrictlyCompatible(
IVMInstall vm)
Returns whether the specified vm install is strictly compatible with this environment. Returns 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.

Parameters:
vm - vm install
Returns:
whether the vm install is strictly compatible with this environment

getDefaultVM

IVMInstall getDefaultVM()
Returns the vm that is used by default for this execution environment, or null if none.

Returns:
default vm for this environment or null if none

setDefaultVM

void setDefaultVM(
IVMInstall vm)
Sets the vm to use by default for this execution environment.

Parameters:
vm - vm to use by default for this execution environment, or null to clear the default setting
Throws:
IllegalArgumentException - if the given vm is not compatible with this environment

getAccessRules

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. An array of access rules is returned for each library specified by libraries, possibly empty.

Access rules for an execution environment are defined by access rule participants contributed in a org.eclipse.jdt.launching.executionEnvironments extension.

Parameters:
vm - the vm that access rules are requested for
libraries - the libraries that access rules are requested for
project - the project the access rules are requested for or null if none
Returns:
a collection of arrays of access rules - one array per library
Since:
3.3

getProfileProperties

Properties getProfileProperties()
Returns the OSGi profile properties associated with this execution environment or null if none. Profile properties specify attributes such as Constants.FRAMEWORK_SYSTEMPACKAGES . Profile properties can be optionally contributed with an execution environment extension.

Returns:
associated profile properties or null if none
Since:
3.5

getSubEnvironments

IExecutionEnvironment[] getSubEnvironments()
Returns a collection of execution environments that are subsets of this environment.

Returns:
a collection of execution environments that are subsets of this environment
Since:
3.5

getComplianceOptions

Map getComplianceOptions()
Returns a map of Eclipse Java compiler options specified as default settings to use when building with this profile, or null if unspecified.

Returns:
a map of Eclipse Java compiler options associated with this profile or null
Since:
3.5

Eclipse JDT
Release 3.5

Copyright (c) IBM Corp. and others 2000, 2008. All Rights Reserved.

 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire