|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.4.0) E13403-05 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.ide.Service javax.ide.debug.Debugger
public abstract class Debugger
The Debugger
can be used to start the debuggee or to
retrieve command line options so the extension can start the debuggee
itself.
IDE providers must provide an implementation of getClientConnector( Context )
and getServerConnector(Context)
.
Constructor Summary | |
---|---|
Debugger()
|
Method Summary | |
---|---|
abstract ClientConnector |
getClientConnector(Context context)
Creates a client connector for a debugging session. |
static Debugger |
getDebugger()
Get the debugger implementation for this IDE. |
abstract ServerConnector |
getServerConnector(Context context)
Creates a server connector for a debugging session. |
Methods inherited from class javax.ide.Service |
---|
getService, initialize, resetAllServices |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public Debugger()
Method Detail |
---|
public abstract ServerConnector getServerConnector(Context context) throws java.lang.UnsupportedOperationException
ServerConnector
object returned can be used to start the
debuggee or to retrieve command line options so the extension can start
the debuggee itself.
If the extension wants to start the the debuggee itself, it should
call Connector.getOptions()
to retrieve the command line
options that it should use to start the debuggee.
If the extension wants to start a third party container (such as
Tomcat, WebLogic, Avalon based systems, properietary based
systems, etc.), it can ignore options that are specific to the
IDE's preferred container (for example, the extension may ignore the
values corresponding to the Connector.OPTION_MAIN_CLASS
key). The extension should not ignore the values corresponding to
the Connector.OPTION_DEBUG_FIRST
and
Connector.OPTION_DEBUG_LAST
keys, as these are dictated
by the IDE so that the debugger will be able connect with the
debuggee.
If the extension wants the IDE to start the debuggee, it should call
Connector.startDebuggee(Map)
.
The returned Connector will implement ServerConnector
. The
extension writer should call ServerConnector.startListening()
to
start the debugger listening, and then the extension should either start
the debuggee process or tell the IDE to do so by calling Connector.startDebuggee(Map)
. When the debuggee process is launched,
the listening debugger will automatically accept the connection.
context
- the current Context
.
java.lang.UnsupportedOperationException
- if the IDE does not
support the debugger as server.public abstract ClientConnector getClientConnector(Context context) throws java.lang.UnsupportedOperationException
ClientConnector
object returned can be used to start the
debuggee or to retrieve command line options so the extension can start
the debuggee itself.
If the extension wants to start the the debuggee itself, it should
call Connector.getOptions()
to retrieve the command line
options that it should use to start the debuggee.
If the extension wants to start a third party container (such as
Tomcat, WebLogic, Avalon based systems, properietary based
systems, etc.), it can ignore options that are specific to the
IDE's preferred container (for example, the extension may ignore the
values corresponding to the Connector.OPTION_MAIN_CLASS
key). The extension should not ignore the values corresponding to
the Connector.OPTION_DEBUG_FIRST
and
Connector.OPTION_DEBUG_LAST
keys, as these are dictated
by the IDE so that the debugger will be able connect with the
debuggee.
If the extension wants the IDE to start the debuggee, it should call
Connector.startDebuggee(Map)
.
The returned Connector will implement ClientConnector
. The
extension writer should either start the debuggee process or tell the
IDE to do so by calling Connector.startDebuggee(Map)
, and then the
extension writer should call ClientConnector.attachDebugger()
to
tell the debugger to attach to the debuggee.
context
- the current Context
.
java.lang.UnsupportedOperationException
- if the IDE does not
support debugger as client.public static Debugger getDebugger()
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.4.0) E13403-05 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |