oracle.ide.runner
Class DebuggerEventSource

java.lang.Object
  oracle.ide.runner.DebuggerEventSource

public abstract class DebuggerEventSource
extends java.lang.Object

A class that represents a debugger as the source of debugger events.

See Also:

DebuggerAdapter, DebuggerListener

Nested Class Summary

static class

DebuggerEventSource.StackFrame

Field Summary

static int	DEBUGGER_STATE_FINISHED_CONNECTIONLOST The debugger state for finished because the connection was lost unexpectedly.
static int	DEBUGGER_STATE_FINISHED_DETACH The debugger state for finished because the user chose to detach.
static int	DEBUGGER_STATE_FINISHED_PROGRAMEXIT The debugger state for finished because the program exited.
static int	DEBUGGER_STATE_FINISHED_TERMINATE The debugger state for finished because the user chose to terminate.
static int	DEBUGGER_STATE_RESUMING_CONTINUESTEP The debugger state for resuming because the user chose to continue step.
static int	DEBUGGER_STATE_RESUMING_RESUME The debugger state for resuming because the user chose to resume.
static int	DEBUGGER_STATE_RESUMING_RUNTOCURSOR The debugger state for resuming because the user chose to run to cursor.
static int	DEBUGGER_STATE_RESUMING_STEPINTO The debugger state for resuming because the user chose to step into.
static int	DEBUGGER_STATE_RESUMING_STEPINTOMETHOD The debugger state for resuming because the user chose to step into method.
static int	DEBUGGER_STATE_RESUMING_STEPOUT The debugger state for resuming because the user chose to step out.
static int	DEBUGGER_STATE_RESUMING_STEPOVER The debugger state for resuming because the user chose to step over.
static int	DEBUGGER_STATE_RESUMING_STEPTOENDOFMETHOD The debugger state for resuming because the user chose to step to end of method.
static int	DEBUGGER_STATE_STARTING The debugger state for starting.
static int	DEBUGGER_STATE_STOPPING_BREAKPOINT The debugger state for stopping because a breakpoint has been hit.
static int	DEBUGGER_STATE_STOPPING_FINISHEDSTEPPING The debugger state for stopping because a stop command has completed.
static int	DEBUGGER_STATE_STOPPING_PAUSED The debugger state for stopping because the user chose to pause.
static int	LANGUAGE_ANT The language may be ANT
static int	LANGUAGE_JAVA The language may be Java
static int	LANGUAGE_JAVASCRIPT The language may be JAVASCRIPT
static int	LANGUAGE_PLSQL The language may be PLSQL
static int	LANGUAGE_UNKNOWN The language may be unknown
static int	LANGUAGE_XSLT The language may be XSLT

Constructor Summary

DebuggerEventSource()

Method Summary

Context	getContext() Get the context of the debugging process that send this event
abstract int	getLanguages() Returns the languages that this debugger might be debugging.
abstract DebuggerEventSource.StackFrame[]	getStackFrames() Returns the stack frames for the current thread, when the debugger event type is DEBUGGER_STOPPING.
abstract int	getState() Returns the state of the debugger.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LANGUAGE_UNKNOWN

public static final int LANGUAGE_UNKNOWN

The language may be unknown

See Also:

Constant Field Values

LANGUAGE_JAVA

public static final int LANGUAGE_JAVA

The language may be Java

See Also:

Constant Field Values

LANGUAGE_PLSQL

public static final int LANGUAGE_PLSQL

The language may be PLSQL

See Also:

Constant Field Values

LANGUAGE_XSLT

public static final int LANGUAGE_XSLT

The language may be XSLT

See Also:

Constant Field Values

LANGUAGE_ANT

public static final int LANGUAGE_ANT

The language may be ANT

See Also:

Constant Field Values

LANGUAGE_JAVASCRIPT

public static final int LANGUAGE_JAVASCRIPT

The language may be JAVASCRIPT

See Also:

Constant Field Values

DEBUGGER_STATE_STARTING

public static final int DEBUGGER_STATE_STARTING

The debugger state for starting.

See Also:

Constant Field Values

DEBUGGER_STATE_STOPPING_BREAKPOINT

public static final int DEBUGGER_STATE_STOPPING_BREAKPOINT

The debugger state for stopping because a breakpoint has been hit.

See Also:

Constant Field Values

DEBUGGER_STATE_STOPPING_FINISHEDSTEPPING

public static final int DEBUGGER_STATE_STOPPING_FINISHEDSTEPPING

The debugger state for stopping because a stop command has completed.

See Also:

Constant Field Values

DEBUGGER_STATE_STOPPING_PAUSED

public static final int DEBUGGER_STATE_STOPPING_PAUSED

The debugger state for stopping because the user chose to pause.

See Also:

Constant Field Values

DEBUGGER_STATE_RESUMING_RESUME

public static final int DEBUGGER_STATE_RESUMING_RESUME

The debugger state for resuming because the user chose to resume.

See Also:

Constant Field Values

DEBUGGER_STATE_RESUMING_STEPOVER

public static final int DEBUGGER_STATE_RESUMING_STEPOVER

The debugger state for resuming because the user chose to step over.

See Also:

Constant Field Values

DEBUGGER_STATE_RESUMING_STEPINTO

public static final int DEBUGGER_STATE_RESUMING_STEPINTO

The debugger state for resuming because the user chose to step into.

See Also:

Constant Field Values

DEBUGGER_STATE_RESUMING_STEPOUT

public static final int DEBUGGER_STATE_RESUMING_STEPOUT

The debugger state for resuming because the user chose to step out.

See Also:

Constant Field Values

DEBUGGER_STATE_RESUMING_STEPTOENDOFMETHOD

public static final int DEBUGGER_STATE_RESUMING_STEPTOENDOFMETHOD

The debugger state for resuming because the user chose to step to end of method.

See Also:

Constant Field Values

DEBUGGER_STATE_RESUMING_CONTINUESTEP

public static final int DEBUGGER_STATE_RESUMING_CONTINUESTEP

The debugger state for resuming because the user chose to continue step.

See Also:

Constant Field Values

DEBUGGER_STATE_RESUMING_RUNTOCURSOR

public static final int DEBUGGER_STATE_RESUMING_RUNTOCURSOR

The debugger state for resuming because the user chose to run to cursor.

See Also:

Constant Field Values

DEBUGGER_STATE_RESUMING_STEPINTOMETHOD

public static final int DEBUGGER_STATE_RESUMING_STEPINTOMETHOD

The debugger state for resuming because the user chose to step into method.

See Also:

Constant Field Values

DEBUGGER_STATE_FINISHED_PROGRAMEXIT

public static final int DEBUGGER_STATE_FINISHED_PROGRAMEXIT

The debugger state for finished because the program exited.

See Also:

Constant Field Values

DEBUGGER_STATE_FINISHED_CONNECTIONLOST

public static final int DEBUGGER_STATE_FINISHED_CONNECTIONLOST

The debugger state for finished because the connection was lost unexpectedly.

See Also:

Constant Field Values

DEBUGGER_STATE_FINISHED_TERMINATE

public static final int DEBUGGER_STATE_FINISHED_TERMINATE

The debugger state for finished because the user chose to terminate.

See Also:

Constant Field Values

DEBUGGER_STATE_FINISHED_DETACH

public static final int DEBUGGER_STATE_FINISHED_DETACH

The debugger state for finished because the user chose to detach.

See Also:

Constant Field Values

Constructor Detail

DebuggerEventSource

public DebuggerEventSource()

Method Detail

getLanguages

public abstract int getLanguages()

Returns the languages that this debugger might be debugging. The returned value may be one or more of the following or'd together: LANGUAGE_UNKNOWN LANGUAGE_JAVA LANGUAGE_PLSQL LANGUAGE_XSLT LANGUAGE_ANT LANGUAGE_JAVASCRIPT

getState

public abstract int getState()

Returns the state of the debugger. If the debugger event type is DEBUGGER_STARTING, this method will return one of the following states:

• DEBUGGER_STATE_STARTING

If the debugger event type is DEBUGGER_STOPPING, this method will return one of the following states:

• DEBUGGER_STATE_STOPPING_BREAKPOINT
• DEBUGGER_STATE_STOPPING_FINISHEDSTEPPING
• DEBUGGER_STATE_STOPPING_PAUSED

If the debugger event type is DEBUGGER_RESUMING, this method will return one of the following states:

• DEBUGGER_STATE_RESUMING_RESUME
• DEBUGGER_STATE_RESUMING_RESUME
• DEBUGGER_STATE_RESUMING_STEPOVER
• DEBUGGER_STATE_RESUMING_STEPINTO
• DEBUGGER_STATE_RESUMING_STEPOUT
• DEBUGGER_STATE_RESUMING_STEPTOENDOFMETHOD
• DEBUGGER_STATE_RESUMING_CONTINUESTEP
• DEBUGGER_STATE_RESUMING_RUNTOCURSOR
• DEBUGGER_STATE_RESUMING_STEPINTOMETHOD

If the debugger event type is DEBUGGER_FINISHED, this method will return one of the following states:

• DEBUGGER_STATE_FINISHED_PROGRAMEXIT
• DEBUGGER_STATE_FINISHED_CONNECTIONLOST
• DEBUGGER_STATE_FINISHED_TERMINATE
• DEBUGGER_STATE_FINISHED_DETACH

Returns:

the debugger state

getStackFrames

public abstract DebuggerEventSource.StackFrame[] getStackFrames()

Returns the stack frames for the current thread, when the debugger event type is DEBUGGER_STOPPING.

If the debugger event type is DEBUGGER_STARTING, DEBUGGER_RESUMING, or DEBUGGER_FINISHED, this method will return null.

Returns:

the stack frames

getContext

public Context getContext()

Get the context of the debugging process that send this event

Returns:

A context that can be null