Package org.eclipse.jdt.launching
Interface IRuntimeClasspathEntryResolver
-
- All Known Subinterfaces:
IRuntimeClasspathEntryResolver2
public interface IRuntimeClasspathEntryResolverResolves variable and/or container runtime classpath entries in the context of a launch configuration or Java project. A resolver can be declared as an extension (org.eclipse.jdt.launching.runtimeClasspathEntryResolver), or be registered with theJavaRuntimeprogrammatically.A resolver is registered for a specific classpath
A resolver extension is defined inVARIABLEand/orCONTAINER. A resolver is consulted when a runtime classpath entry is needs to be resolved.plugin.xml. Following is an example definition of a runtime classpath entry resolver extension.<extension point="org.eclipse.jdt.launching.runtimeClasspathEntryResolvers"> <runtimeClasspathEntryResolver id="com.example.ExampleResolver" class="com.example.ExampleResolverImpl" variable="VAR_NAME" container="CONTAINER_ID" </runtimeClasspathEntryResolver> </extension>The attributes are specified as follows:idspecifies a unique identifier for this extension.classspecifies the fully qualified name of the Java class that implementsIRuntimeClasspathEntryResolver.variablename of the classpath variable this resolver is registered for.containeridentifier of the classpath container this resolver is registered for.
variableorcontainermust be specified.Clients may implement this interface.
- Since:
- 2.0
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description IRuntimeClasspathEntry[]resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry, ILaunchConfiguration configuration)Returns resolved runtime classpath entries for the given runtime classpath entry, in the context of the given launch configuration.IRuntimeClasspathEntry[]resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry, IJavaProject project)Returns resolved runtime classpath entries for the given runtime classpath entry, in the context of the given Java project.default IRuntimeClasspathEntry[]resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry, IJavaProject project, boolean excludeTestCode)Returns resolved runtime classpath entries for the given runtime classpath entry, in the context of the given Java project.IVMInstallresolveVMInstall(IClasspathEntry entry)Returns a VM install associated with the given classpath entry, ornullif none.
-
-
-
Method Detail
-
resolveRuntimeClasspathEntry
IRuntimeClasspathEntry[] resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry, ILaunchConfiguration configuration) throws CoreException
Returns resolved runtime classpath entries for the given runtime classpath entry, in the context of the given launch configuration.- Parameters:
entry- runtime classpath entry to resolve, of typeVARIABLEorCONTAINTERconfiguration- the context in which the runtime classpath entry needs to be resolved- Returns:
- resolved entries (zero or more)
- Throws:
CoreException- if unable to resolve the entry
-
resolveRuntimeClasspathEntry
IRuntimeClasspathEntry[] resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry, IJavaProject project) throws CoreException
Returns resolved runtime classpath entries for the given runtime classpath entry, in the context of the given Java project.- Parameters:
entry- runtime classpath entry to resolve, of typeVARIABLEorCONTAINTERproject- context in which the runtime classpath entry needs to be resolved- Returns:
- resolved entries (zero or more)
- Throws:
CoreException- if unable to resolve the entry
-
resolveRuntimeClasspathEntry
default IRuntimeClasspathEntry[] resolveRuntimeClasspathEntry(IRuntimeClasspathEntry entry, IJavaProject project, boolean excludeTestCode) throws CoreException
Returns resolved runtime classpath entries for the given runtime classpath entry, in the context of the given Java project.- Parameters:
entry- runtime classpath entry to resolve, of typeVARIABLEorCONTAINTERproject- context in which the runtime classpath entry needs to be resolvedexcludeTestCode- when true, test code should be excluded- Returns:
- resolved entries (zero or more)
- Throws:
CoreException- if unable to resolve the entry- Since:
- 3.10
-
resolveVMInstall
IVMInstall resolveVMInstall(IClasspathEntry entry) throws CoreException
Returns a VM install associated with the given classpath entry, ornullif none.- Parameters:
entry- classpath entry- Returns:
- vm install associated with entry or
nullif none - Throws:
CoreException- if unable to resolve a VM
-
-