public interface IDebuggerCallbacks
Modifier and Type | Method and Description |
---|---|
int[] |
getAppVersion(File application)
Returns the version number of an application.
|
String[] |
getBrowserParameters(String uri)
Returns the parameters to pass to the browser or null if non-existent.
|
File |
getHttpExe()
Returns the executable of the browser to launch for http: URLs, or
null if not known. |
String |
getHttpExeName()
Returns a name such as "firefox" or "Web browser", the name of the
browser, useful for error messages.
|
File |
getPlayerExe()
Returns the executable for the standalone Flash player, or
null
if not known. |
String |
getPlayerExeName()
Returns a name such as "SAFlashPlayer.exe" or "gflashplayer" or "Flash
player", the name of the standalone player, useful for error messages.
|
Process |
launchDebugTarget(String[] cmd)
Launches a debug target.
|
Process |
launchDebugTarget(String[] cmd,
ILauncher launcher)
Launches a debug target using the launcher instance
ILauncher.launch(cmd) . |
String |
queryWindowsRegistry(String key,
String value)
Query the Windows registry.
|
String |
queryWindowsRegistry(String key,
String value,
int registryBitMode)
Same as queryWindowsRegistry, but allows specific access to the 32-bit
or 64-bit part of the registry.
|
void |
recomputeExeLocations()
Tells the debugger to recompute the values which will be returned by
getHttpExe() and getPlayerExe().
|
void |
terminateDebugTarget(Process process)
Terminates a debug target process.
|
void |
terminateDebugTarget(Process process,
ILauncher launcher)
Terminates a debug target process by invoking
ILauncher.terminate(process) |
void recomputeExeLocations()
File getHttpExe()
null
if not known.String[] getBrowserParameters(String uri)
File getPlayerExe()
null
if not known.String getHttpExeName()
null
.String getPlayerExeName()
null
.Process launchDebugTarget(String[] cmd) throws IOException
IOException
void terminateDebugTarget(Process process) throws IOException
IOException
Process launchDebugTarget(String[] cmd, ILauncher launcher) throws IOException
ILauncher.launch(cmd)
.IOException
void terminateDebugTarget(Process process, ILauncher launcher) throws IOException
ILauncher.terminate(process)
IOException
String queryWindowsRegistry(String key, String value) throws IOException
key
- The registry key, in a format suitable for the REG.EXE
program. You must use full key names such as
HKEY_LOCAL_MACHINE rather the shorter abbreviations such as
HKLM.value
- The value within that key, or null for the unnamed ("empty")
valueIOException
- indicates the registry query failed -- warning, this can
really happen! Some implementations of this function don't
work on Windows 2000. So, this function should not be counted
on too heavily -- you should have a backup plan.String queryWindowsRegistry(String key, String value, int registryBitMode) throws IOException
IOException
int[] getAppVersion(File application) throws IOException
As of this writing, the only thing this is used for is to determine, on
Windows, whether the user is running IE 8; if he is, we need to pass the
"-noframemerging" command-line argument. It is generally okay to just
return null
from this function; a robust implementation is
not required.
application
- the application whose version number is desired. On Windows,
this will typically be a path to a .exe file. On Mac, it may
point to a .app directory such as "/Applications/Safari.app",
or it may point to the underlying binary, such as
"/Applications/Safari.app/Contents/MacOS/Safari".IOException
- e.g. for file not found, etc.Copyright © 2016 The Apache Software Foundation. All rights reserved.