org.apache.bsf.util

Class BSFDebugManagerImpl

public class BSFDebugManagerImpl extends Skeleton implements BSFDebugManager, RemoteServiceListener

Constructor Summary
	BSFDebugManagerImpl()

Method Summary
void	finalize()
String	getLangFromFilename(String fileName) Determine the language of a script file by looking at the file extension.
boolean	isLanguageRegistered(String lang) Determine whether a language is registered.
DocumentCell	loadDocumentNotify(BSFEngine eng, String name)
void	placeBreakpointAtLine(int brkptid, String docname, int lineno)
void	placeBreakpointAtOffset(int brkptid, String docname, int offset)
void	registerDebugger(String lang, BSFDebugger debugger) Register a debugger for a scripting engine.
void	registerEngine(BSFManager mger, BSFEngine eng, String lang)
void	registerManager(BSFManager mger)
void	removeAllBreakpoints()
void	removeBreakpoint(String docname, int brkptid)
void	revokedNotify(RemoteService service) Callback from the socket/stub layer.
void	setEntryExit(String docname, boolean on)
boolean	supportBreakpointAtLine(String lang)
boolean	supportBreakpointAtOffset(String lang) Allows a debugger to ask if the engine for a given language will support either line or offset breakpoints.
void	terminate()
void	terminateEngineNotify(BSFManager mger, BSFEngine eng, String lang)
void	terminateManagerNotify(BSFManager mger)
void	unregisterDebugger(String lang)

Method Detail

getLangFromFilename

public String getLangFromFilename(String fileName)

Determine the language of a script file by looking at the file extension.

Parameters: filename the name of the file

Returns: the scripting language the file is in if the file extension is known to me (must have been registered via registerScriptingEngine).

Throws: RemoteException if file's extension is unknown.

isLanguageRegistered

public boolean isLanguageRegistered(String lang)

Determine whether a language is registered.

Parameters: lang string identifying a language

Returns: true iff it is

loadDocumentNotify

public DocumentCell loadDocumentNotify(BSFEngine eng, String name)

placeBreakpointAtLine

public void placeBreakpointAtLine(int brkptid, String docname, int lineno)

placeBreakpointAtOffset

public void placeBreakpointAtOffset(int brkptid, String docname, int offset)

registerDebugger

public void registerDebugger(String lang, BSFDebugger debugger)

Parameters: lang string identifying language

Throws: RemoteException if the language is unknown (i.e., if it has not been registered) with a reason of REASON_UNKNOWN_LANGUAGE. If the language is known but if the interface can't be created for some reason, then the reason is set to REASON_OTHER_ERROR and the actual exception is passed on as well.

registerEngine

public void registerEngine(BSFManager mger, BSFEngine eng, String lang)

registerManager

public void registerManager(BSFManager mger)

removeAllBreakpoints

public void removeAllBreakpoints()

removeBreakpoint

public void removeBreakpoint(String docname, int brkptid)

revokedNotify

public void revokedNotify(RemoteService service)

Callback from the socket/stub layer. A stub for a remote debugger is being revoked due to a lost connection. Since we support only one debuggers from only one JVM, there is only one connection and therefore we can drop all debuggers... and then drop all breakpoints. ATTENTION: Breakpoints shall not be dropped if we extend this implementation to multiple debuggers through multiple socket connections.