---

Overview  Package    Class   Use  Tree  Deprecated  Index  Help		Eclipse JDT Release 3.5
PREV CLASS    NEXT CLASS	NO FRAMES
SUMMARY: NESTED | FIELD |  CONSTR |  METHOD	DETAIL: FIELD |  CONSTR |  METHOD

---

org.eclipse.jdt.launching
Class AbstractVMRunner

java.lang.Object
  
org.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 configuration and VM install

Since:

3.0

---

Overview  Package    Class   Use  Tree  Deprecated  Index  Help		Eclipse JDT Release 3.5
PREV CLASS    NEXT CLASS	NO FRAMES
SUMMARY: NESTED | FIELD |  CONSTR |  METHOD	DETAIL: FIELD |  CONSTR |  METHOD

---

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