Eclipse JDT
Release 3.1

org.eclipse.jdt.launching
Class AbstractVMRunner

java.lang.Object
  extended byorg.eclipse.jdt.launching.AbstractVMRunner
All Implemented Interfaces:
IVMRunner

public abstract class AbstractVMRunner
extends Object
implements IVMRunner

Abstract implementation of a VM runner.

Clients implementing VM runners should subclass this class.

Since:
2.0
See Also:
IVMRunner

Constructor Summary
AbstractVMRunner()
           
 
Method Summary
protected  void abort(String message, Throwable exception, int code)
          Throws a core exception with an error status object built from the given message, lower level exception, and error code.
protected  String[] combineVmArgs(VMRunnerConfiguration configuration, IVMInstall vmInstall)
          Combines and returns VM arguments specified by the runner configuration, with those specified by the VM install, if any.
protected  Process exec(String[] cmdLine, File workingDirectory)
           
protected  Process exec(String[] cmdLine, File workingDirectory, String[] envp)
           
protected  String getCmdLineAsString(String[] cmdLine)
          Returns the given array of strings as a single space-delimited string.
protected  Map getDefaultProcessMap()
          Returns the default process attribute map for Java processes.
protected abstract  String getPluginIdentifier()
          Returns the identifier of the plug-in this VM runner originated from.
protected  IProcess newProcess(ILaunch launch, Process p, String label, Map attributes)
          Returns a new process aborting if the process could not be created.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.eclipse.jdt.launching.IVMRunner
run
 

Constructor Detail

AbstractVMRunner

public AbstractVMRunner()
Method Detail

abort

protected void abort(String message,
                     Throwable exception,
                     int code)
              throws CoreException
Throws a core exception with an error status object built from the given message, lower level exception, and error code.

Parameters:
message - the status message
exception - lower level exception associated with the error, or null if none
code - error code
Throws:
CoreException - The exception encapsulating the reason for the abort

getPluginIdentifier

protected abstract String getPluginIdentifier()
Returns the identifier of the plug-in this VM runner originated from.

Returns:
plug-in identifier

exec

protected Process exec(String[] cmdLine,
                       File workingDirectory)
                throws CoreException
Throws:
CoreException
See Also:
DebugPlugin.exec(String[], File)

exec

protected Process exec(String[] cmdLine,
                       File workingDirectory,
                       String[] envp)
                throws CoreException
Throws:
CoreException
Since:
3.0
See Also:
DebugPlugin.exec(String[], File, String[])

getCmdLineAsString

protected String getCmdLineAsString(String[] cmdLine)
Returns the given array of strings as a single space-delimited string.

Parameters:
cmdLine - array of strings
Returns:
a single space-delimited string

getDefaultProcessMap

protected Map getDefaultProcessMap()
Returns the default process attribute map for Java processes.

Returns:
default process attribute map for Java processes

newProcess

protected IProcess newProcess(ILaunch launch,
                              Process p,
                              String label,
                              Map attributes)
                       throws CoreException
Returns a new process aborting if the process could not be created.

Parameters:
launch - the launch the process is contained in
p - the system process to wrap
label - the label assigned to the process
attributes - values for the attribute map
Returns:
the new process
Throws:
CoreException - problems occurred creating the process
Since:
3.0

combineVmArgs

protected String[] combineVmArgs(VMRunnerConfiguration configuration,
                                 IVMInstall vmInstall)
Combines and returns VM arguments specified by the runner configuration, with those specified by the VM install, if any.

Parameters:
configuration - runner configuration
vmInstall - vm install
Returns:
combined VM arguments specified by the runner confiugration and VM install
Since:
3.0

Eclipse JDT
Release 3.1

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