|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK 11g Release 2 (11.1.2.3.0) E17493-04 |
|||||||||
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 11g Release 2 (11.1.2.3.0) E17493-04 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |