|
Eclipse JDT 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.eclipse.jdt.launching.JavaRuntime
The central access point for launching support. This class manages
the registered VM types contributed through the
"org.eclipse.jdt.launching.vmType"
extension point.
As well, this class provides VM install change notification,
and computes classpaths and source lookup paths for launch
configurations.
This class provides static methods only; it is not intended to be instantiated or subclassed by clients.
Field Summary | |
static String |
ATTR_CMDLINE
Attribute key for a process property. |
static int |
DEF_CONNECT_TIMEOUT
Default launch/connect timeout (ms). |
static int |
ERR_UNABLE_TO_RESOLVE_JRE
A status code indicating that a JRE could not be resolved for a project. |
static String |
EXTENSION_POINT_RUNTIME_CLASSPATH_ENTRY_RESOLVERS
Simple identifier constant (value "runtimeClasspathEntryResolvers" ) for the
runtime classpath entry resolvers extension point. |
static String |
EXTENSION_POINT_RUNTIME_CLASSPATH_PROVIDERS
Simple identifier constant (value "classpathProviders" ) for the
runtime classpath providers extension point. |
static String |
JRE_CONTAINER
Classpath container used for a project's JRE. |
static String |
JRELIB_VARIABLE
Classpath variable name used for the default JRE's library. |
static String |
JRESRC_VARIABLE
Classpath variable name used for the default JRE's library source. |
static String |
JRESRCROOT_VARIABLE
Classpath variable name used for the default JRE's library source root. |
static String |
PREF_CONNECT_TIMEOUT
Preference key for launch/connect timeout. |
Method Summary | |
static void |
addContainerResolver(IRuntimeClasspathEntryResolver resolver,
String containerIdentifier)
Registers the given resolver for the specified container. |
static void |
addVariableResolver(IRuntimeClasspathEntryResolver resolver,
String variableName)
Registers the given resolver for the specified variable. |
static void |
addVMInstallChangedListener(IVMInstallChangedListener listener)
Adds the given listener to the list of registered VM install changed listeners. |
static String[] |
computeDefaultRuntimeClassPath(IJavaProject jproject)
Computes the default application classpath entries for the given project. |
static IRuntimeClasspathEntry[] |
computeUnresolvedRuntimeClasspath(IJavaProject project)
Computes and returns the default unresolved runtime claspath for the given project. |
static IRuntimeClasspathEntry[] |
computeUnresolvedRuntimeClasspath(ILaunchConfiguration configuration)
Computes and returns the unresolved class path for the given launch configuration. |
static IRuntimeClasspathEntry[] |
computeUnresolvedSourceLookupPath(ILaunchConfiguration configuration)
Computes and returns the unresolved source lookup path for the given launch configuration. |
static IVMInstall |
computeVMInstall(ILaunchConfiguration configuration)
Returns the VM install for the given launch configuration. |
static void |
fireVMAdded(IVMInstall vm)
Notifies all VM install changed listeners of the VM addition |
static void |
fireVMChanged(PropertyChangeEvent event)
Notifies all VM install changed listeners of the given property change. |
static void |
fireVMRemoved(IVMInstall vm)
Notifies all VM install changed listeners of the VM removal |
static IRuntimeClasspathProvider |
getClasspathProvider(ILaunchConfiguration configuration)
Returns the classpath provider for the given launch configuration. |
static IClasspathEntry |
getDefaultJREContainerEntry()
Creates and returns a classpath entry describing the default JRE container entry. |
static IVMConnector |
getDefaultVMConnector()
Return the default VM connector. |
static IVMInstall |
getDefaultVMInstall()
Return the default VM set with setDefaultVM() . |
static IJavaProject |
getJavaProject(ILaunchConfiguration configuration)
Return the IJavaProject referenced in the specified configuration or
null if none. |
static IClasspathEntry |
getJREVariableEntry()
Creates and returns a classpath entry describing the JRE_LIB classpath variable. |
static LibraryLocation[] |
getLibraryLocations(IVMInstall vm)
Evaluates library locations for a IVMInstall. |
static Preferences |
getPreferences()
Returns the preference store for the launching plug-in. |
static IRuntimeClasspathProvider |
getSourceLookupPathProvider(ILaunchConfiguration configuration)
Returns the source lookup path provider for the given launch configuration. |
static IVMConnector |
getVMConnector(String id)
Returns the VM connetor defined with the specified identifier, or null if none. |
static IVMConnector[] |
getVMConnectors()
Returns all VM connector extensions. |
static IVMInstall |
getVMInstall(IJavaProject project)
Returns the VM assigned to build the given Java project. |
static IVMInstallType |
getVMInstallType(String id)
Returns the VM install type with the given unique id. |
static IVMInstallType[] |
getVMInstallTypes()
Returns the list of registered VM types. |
static IRuntimeClasspathEntry |
newArchiveRuntimeClasspathEntry(IPath path)
Returns a new runtime classpath entry for the given archive (possibly external). |
static IRuntimeClasspathEntry |
newArchiveRuntimeClasspathEntry(IResource resource)
Returns a new runtime classpath entry for the given archive. |
static IRuntimeClasspathEntry |
newProjectRuntimeClasspathEntry(IJavaProject project)
Returns a new runtime classpath entry for the given project. |
static IRuntimeClasspathEntry |
newRuntimeClasspathEntry(String memento)
Returns a runtime classpath entry constructed from the given memento. |
static IRuntimeClasspathEntry |
newRuntimeContainerClasspathEntry(IPath path,
int classpathProperty)
Returns a runtime classpath entry for the given container path with the given classpath property. |
static IRuntimeClasspathEntry |
newVariableRuntimeClasspathEntry(IPath path)
Returns a new runtime classpath entry for the classpath variable with the given path. |
static void |
removeVMInstallChangedListener(IVMInstallChangedListener listener)
Removes the given listener from the list of registered VM install changed listeners. |
static IRuntimeClasspathEntry[] |
resolveRuntimeClasspath(IRuntimeClasspathEntry[] entries,
ILaunchConfiguration configuration)
Resolves the given classpath, returning the resolved classpath in the context of the given launch configuration. |
static IRuntimeClasspathEntry[] |
resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry,
IJavaProject project)
Returns resolved entries for the given entry in the context of the given Java project. |
static IRuntimeClasspathEntry[] |
resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry,
ILaunchConfiguration configuration)
Returns resolved entries for the given entry in the context of the given launch configuration. |
static IRuntimeClasspathEntry[] |
resolveSourceLookupPath(IRuntimeClasspathEntry[] entries,
ILaunchConfiguration configuration)
Resolves the given source lookup path, returning the resolved source lookup path in the context of the given launch configuration. |
static void |
savePreferences()
Saves the preferences for the launching plug-in. |
static void |
saveVMConfiguration()
Saves the VM configuration information to disk. |
static void |
setDefaultVMConnector(IVMConnector connector,
IProgressMonitor monitor)
Sets a VM connector as the system-wide default VM. |
static void |
setDefaultVMInstall(IVMInstall vm,
IProgressMonitor monitor)
Sets a VM as the system-wide default VM, and notifies registered VM install change listeners of the change. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final String JRELIB_VARIABLE
public static final String JRESRC_VARIABLE
public static final String JRESRCROOT_VARIABLE
public static final String EXTENSION_POINT_RUNTIME_CLASSPATH_ENTRY_RESOLVERS
"runtimeClasspathEntryResolvers"
) for the
runtime classpath entry resolvers extension point.
public static final String EXTENSION_POINT_RUNTIME_CLASSPATH_PROVIDERS
"classpathProviders"
) for the
runtime classpath providers extension point.
public static final String JRE_CONTAINER
IBM 1.3.1
. This information is
shared in a projects classpath file, so teams must agree on JRE naming
conventions.
public static final int ERR_UNABLE_TO_RESOLVE_JRE
source
object provided
to the status handler is the Java project for which the path could not be
resolved. The status handler must return an IVMInstall
or null
.
The container resolver will re-set the project's classpath if required.
public static final String PREF_CONNECT_TIMEOUT
public static final int DEF_CONNECT_TIMEOUT
public static final String ATTR_CMDLINE
org.eclipse.debug.core.model.IProcess
allows attaching
String properties to processes.
The value of this attribute is the command line a process
was launched with. Implementers of IVMRunner
should use
this attribute key to attach the command lines to the processes they create.
Method Detail |
public static IVMInstallType[] getVMInstallTypes()
"org.eclipse.jdt.launching.vmTypes"
extension point.
Returns an empty list if there are no registered VM types.
public static IVMInstall getVMInstall(IJavaProject project) throws CoreException
null
if no VM is referenced on the project's build path.
CoreException
- if unable to determine the project's VM installpublic static IVMInstallType getVMInstallType(String id)
null
if no
VM install type with the given id is registered.public static void setDefaultVMInstall(IVMInstall vm, IProgressMonitor monitor) throws CoreException
vm
- The vm to make the default. May be null
to clear
the default.monitor
- progress monitor or null
CoreException
public static void setDefaultVMConnector(IVMConnector connector, IProgressMonitor monitor) throws CoreException
connector
- The connector to make the default. May be null to clear
the default.
CoreException
public static IVMInstall getDefaultVMInstall()
setDefaultVM()
.
null
when no default
VM was set or when the default VM has been disposed.public static IVMConnector getDefaultVMConnector()
public static IRuntimeClasspathEntry newProjectRuntimeClasspathEntry(IJavaProject project)
project
- Java project
public static IRuntimeClasspathEntry newArchiveRuntimeClasspathEntry(IResource resource)
resource
- archive resource
public static IRuntimeClasspathEntry newArchiveRuntimeClasspathEntry(IPath path)
path
- absolute path to an archive
public static IRuntimeClasspathEntry newVariableRuntimeClasspathEntry(IPath path)
path
- variable path; first segment is the name of the variable;
trailing segments are appended to the resolved variable value
public static IRuntimeClasspathEntry newRuntimeContainerClasspathEntry(IPath path, int classpathProperty) throws CoreException
path
- container pathclasspathProperty
- the type of entry - one of USER_CLASSES
,
BOOTSTRAP_CLASSES
, or STANDARD_CLASSES
CoreException
- if unable to construct a runtime classpath entrypublic static IRuntimeClasspathEntry newRuntimeClasspathEntry(String memento) throws CoreException
memento
- a menento for a runtime classpath entry
CoreException
- if unable to construct a runtime classpath entrypublic static IRuntimeClasspathEntry[] computeUnresolvedRuntimeClasspath(IJavaProject project) throws CoreException
CoreException
- if unable to compute the runtime classpathIRuntimeClasspathEntry
public static IRuntimeClasspathEntry[] computeUnresolvedSourceLookupPath(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configuration
CoreException
- if unable to compute the source lookup pathpublic static IRuntimeClasspathEntry[] resolveSourceLookupPath(IRuntimeClasspathEntry[] entries, ILaunchConfiguration configuration) throws CoreException
entries
- unresolved entriesconfiguration
- launch configuration
CoreException
- if unable to resolve the source lookup pathpublic static IRuntimeClasspathProvider getClasspathProvider(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configuration
CoreException
- if unable to resolve the path providerpublic static IRuntimeClasspathProvider getSourceLookupPathProvider(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configuration
CoreException
- if unable to resolve the path providerpublic static IRuntimeClasspathEntry[] resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry, ILaunchConfiguration configuration) throws CoreException
VARIABLE
or CONTAINTER
, variable and contanier
resolvers are consulted, otherwise, the returned entry is the same as the
given entry.
If the given entry is a variable entry, and a resolver is not registered, the entry itself is returned. If the given entry is a container, and a resolver is not registered, resolved runtime classpath entries are calculated from the associated container classpath entries, in the context of the project associated with the given launch configuration.
entry
- runtime classpath entryconfiguration
- launch configuration
CoreException
- if unable to resolveIRuntimeClasspathEntryResolver
public static IRuntimeClasspathEntry[] resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry, IJavaProject project) throws CoreException
VARIABLE
or CONTAINTER
, variable and contanier
resolvers are consulted, otherwise, the returned entry is the same as the given
entry.
If the given entry is a variable entry, and a resolver is not registered, the entry itself is returned. If the given entry is a container, and a resolver is not registered, resolved runtime classpath entries are calculated from the associated container classpath entries, in the context of the given project.
entry
- runtime classpath entryproject
- Java project context
CoreException
- if unable to resolveIRuntimeClasspathEntryResolver
public static IRuntimeClasspathEntry[] computeUnresolvedRuntimeClasspath(ILaunchConfiguration configuration) throws CoreException
configuration
- launch configuration
CoreException
- if unable to compute the classpathpublic static IRuntimeClasspathEntry[] resolveRuntimeClasspath(IRuntimeClasspathEntry[] entries, ILaunchConfiguration configuration) throws CoreException
entries
- unresolved classpathconfiguration
- launch configuration
CoreException
- if unable to compute the classpathpublic static IJavaProject getJavaProject(ILaunchConfiguration configuration) throws CoreException
IJavaProject
referenced in the specified configuration or
null
if none.
CoreException
- if the referenced Java project does not existpublic static IVMInstall computeVMInstall(ILaunchConfiguration configuration) throws CoreException
ATTR_VM_INSTALL_TYPE
and ATTR_VM_INSTALL_ID
attributes.
configuration
- launch configuration
CoreException
- if unable to compute a vm installpublic static String[] computeDefaultRuntimeClassPath(IJavaProject jproject) throws CoreException
jproject
- The project to compute the classpath for
CoreException
- if unable to compute the default classpathpublic static void saveVMConfiguration() throws CoreException
CoreException
public static LibraryLocation[] getLibraryLocations(IVMInstall vm)
public static IClasspathEntry getJREVariableEntry()
public static IClasspathEntry getDefaultJREContainerEntry()
public static IVMConnector getVMConnector(String id)
null
if none.
id
- VM connector identifier
null
if nonepublic static IVMConnector[] getVMConnectors()
public static Preferences getPreferences()
public static void savePreferences()
public static void addVariableResolver(IRuntimeClasspathEntryResolver resolver, String variableName)
resolver
- runtime classpathe entry resolvervariableName
- variable name to register forpublic static void addContainerResolver(IRuntimeClasspathEntryResolver resolver, String containerIdentifier)
resolver
- runtime classpathe entry resolvercontainerIdentifier
- identifier of the classpath container to register forpublic static void addVMInstallChangedListener(IVMInstallChangedListener listener)
listener
- the listener to addpublic static void removeVMInstallChangedListener(IVMInstallChangedListener listener)
listener
- the listener to removepublic static void fireVMChanged(PropertyChangeEvent event)
event
- event desribing the change.public static void fireVMAdded(IVMInstall vm)
vm
- the VM that has been addedpublic static void fireVMRemoved(IVMInstall vm)
vm
- the VM that has been removed
|
Eclipse JDT 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |