Interface ICombinedContext

All Superinterfaces:

IContext, IDTFJContext

All Known Implementing Classes:

CombinedContext

public interface ICombinedContext
extends IDTFJContext

A combined context is an extended DTFJ context which also contains a DDR context. This is to allow commands to be passed down the stack starting with DTFJ and then moving to DDR if necessary.

Method Summary

Modifier and Type	Method	Description
void	displayContext(IOutputManager out, boolean shortFormat)	Display the contexts which are present in the core file currently being analysed.
Object	getDDRIObject()	A handle to the underlying DDR interactive session
Throwable	getDDRStartupException()	Get the exception which was thrown when trying to start a DDR interactive session.
int	getID()	Contexts have a unique positive numeric identifier within a session.
boolean	isDDRAvailable()	Flag to indicate if an associated DDR context is available as well as the DTFJ one.
void	setAsCurrent()	Called when this context becomes the current context to allow any initialisation to take place.
void	setID(int id)	Sets the numeric ID for this context.

Methods declared in interface IContext

execute, execute, execute, getCommands, getLastCommandException, getLastExecutedCommand, getPluginClassloader, getProperties, isCommandRecognised, refresh

Modifier and Type	Method	Description
void	execute(CommandParser command, PrintStream out)	Execute the entered command line with the output sent to the supplied print stream.
void	execute(String cmdline, PrintStream out)	Execute the entered command line with the output sent to the supplied print stream.
void	execute(String cmdline, String[] arguments, PrintStream out)	Execute the entered command line with the output sent to the supplied print stream.
List<ICommand>	getCommands()	Returns a list of commands which are available for this context
Exception	getLastCommandException()	Provides access to any uncaught exceptions thrown when the last command was executed.
ICommand	getLastExecutedCommand()	The last command which was successfully executed by the context.
PluginLoader	getPluginClassloader()	Gets the classloader which has been used to add plugins.
Properties	getProperties()	A set of defined properties.
boolean	isCommandRecognised(String command)	Allows to check if the given command will be executed (i.e. if there is a command that will accept the string) without actually executing it, avoiding error messages etc.
void	refresh()	Refreshes the context, this will perform actions such as rescanning the plugin path or other initialization tasks.

Methods declared in interface IDTFJContext

getAddressSpace, getImage, getMajorVersion, getMinorVersion, getProcess, getRuntime, hasPropertyBeenSet

Modifier and Type	Method	Description
ImageAddressSpace	getAddressSpace()	The address space for this context.
DTFJImageBean	getImage()	A simple Java bean which allows access to the data on DTFJ image interface.
int	getMajorVersion()	The major version of the DTFJ API for this context.
int	getMinorVersion()	The minor version of the DTFJ API for this context.
ImageProcess	getProcess()	The process for this context.
JavaRuntime	getRuntime()	The Java runtime for this context.
boolean	hasPropertyBeenSet(String name)	Used to determine if a property has been set in the context property bag, and that the value of that property is TRUE

Method Details

getID

int getID()

Contexts have a unique positive numeric identifier within a session. This number always increases if new contexts are created via the open command rather than attempting to re-use any already used IDs.

Returns:

the ID for this context

setID

void setID(int id)

Sets the numeric ID for this context. This setter is provided so as to allow context creation before assigning the ID. However once set it should not be changed. Later implementations may enforce this.

Parameters:

id - the context ID

getDDRIObject

Object getDDRIObject()

A handle to the underlying DDR interactive session

Returns:

a valid session or null if the core file is not DDR enabled

getDDRStartupException

Throwable getDDRStartupException()

Get the exception which was thrown when trying to start a DDR interactive session.

Returns:

the exception or null if the session started without error.

displayContext

void displayContext(IOutputManager out,
 boolean shortFormat)

Display the contexts which are present in the core file currently being analysed.

Parameters:

shortFormat - true for short format which just displays the first line of the java -version string

setAsCurrent

void setAsCurrent()

Called when this context becomes the current context to allow any initialisation to take place.

isDDRAvailable

boolean isDDRAvailable()

Flag to indicate if an associated DDR context is available as well as the DTFJ one.

Returns:

true if DDR is available