org.netbeans.api.debugger

Class SessionBridge

java.lang.Object

org.netbeans.api.debugger.SessionBridge

public final class SessionBridge
extends Object

Bridge between sessions. Use this for mixed languages debugging. Any debug session can suggest to change the debugging session for a debug action. A registered implementation of SessionBridge.SessionChanger can decide to change the session in order to perform the given action.

In the current implementation, step into action of JPDA debugger is suggested for a session change only. The support can be extended according to the future requirements.

Since:

1.48

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SessionBridge.SessionChanger Implement this interface to handle a debug session change.

Method Summary

Modifier and Type	Method and Description
static SessionBridge	getDefault() Get the default instance of SessionBridge.
boolean	isChangerFor(String action) Test whether there is some session changer registered for the given action.
boolean	suggestChange(Session origin, String action, Map<Object,Object> properties) Suggest a session change to perform a particular action.

Methods inherited from class java.lang.Object

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

Method Detail

getDefault

public static SessionBridge getDefault()

Get the default instance of SessionBridge.

Returns:

the default instance

suggestChange

public boolean suggestChange(Session origin,
                             String action,
                             Map<Object,Object> properties)

Suggest a session change to perform a particular action.

Parameters:

origin - The original session suggesting the session change

action - An action - a constant from ActionsManager.Action_*

properties - Properties describing the current state of the current session before the given action. The actual properties are specific for the particular session type.

Returns:

true when the session is changed and another session decided to perform the given action.
false when no other session would like to perform this action.

isChangerFor

public boolean isChangerFor(String action)

Test whether there is some session changer registered for the given action.

Parameters:

action - An action - a constant from ActionsManager.Action_*

Returns:

true when there is some session changer registered for this action, false otherwise.