mirrors/cdt
1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-04-29 19:45:01 +02:00
Code Issues Wiki Activity

First part of re-factoring of the Breakpoint service.

Browse source
This commit is contained in:
Francois Chouinard 2007-12-10 22:12:01 +00:00
parent 4463f50fc6
commit cd887eb0e3
1 changed files with 33 additions and 59 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

92
plugins/org.eclipse.dd.dsf.debug/src/org/eclipse/dd/dsf/debug/service/IBreakpoints.java
View file

@ -19,8 +19,7 @@ import org.eclipse.dd.dsf.datamodel.IDMContext;
import org.eclipse.dd.dsf.service.IDsfService; import org.eclipse.dd.dsf.service.IDsfService;
/** /**
* Breakpoint service interface. The breakpoint service tracks platform breakpoint * Breakpoint service interface
* objects, and based on those, it manages breakpoints in the debugger back end.
*/ */
public interface IBreakpoints extends IDsfService { public interface IBreakpoints extends IDsfService {
@ -30,40 +29,36 @@ public interface IBreakpoints extends IDsfService {
public interface IBreakpointsTargetDMContext extends IDMContext {}; public interface IBreakpointsTargetDMContext extends IDMContext {};
/** /**
* Specific breakpoint context * Specific breakpoint context
*/ */
public interface IDsfBreakpointDMContext extends IDMContext {}; public interface IDsfBreakpointDMContext extends IDMContext {
// Get the execution context
IBreakpointsTargetDMContext getTargetContext();
// Get the breakpoint reference
Object getReference();
};
/** /**
* Breakpoint structure. * Breakpoint structure
* Properties are stored in a map.
*/ */
public interface IDsfBreakpoint { public interface IDsfBreakpoint {
// Breakpoint types // Breakpoint types
public static enum IDsfBreakpointNature { BREAKPOINT, WATCHPOINT, CATCHPOINT, TRACEPOINT }; public static enum IDsfBreakpointNature { BREAKPOINT, WATCHPOINT, CATCHPOINT, TRACEPOINT };
// Minimal breakpoint properties // Retrieve the breakpoint nature
public static final String DSFBREAKPOINT = "org.eclipse.dd.dsf.debug.service.breakpoint"; //$NON-NLS-1$
public static final String FILE_NAME = DSFBREAKPOINT + ".fileName"; //$NON-NLS-1$
public static final String LINE_NUMBER = DSFBREAKPOINT + ".lineNumber"; //$NON-NLS-1$
public static final String FUNCTION = DSFBREAKPOINT + ".function"; //$NON-NLS-1$
public static final String CONDITION = DSFBREAKPOINT + ".condition"; //$NON-NLS-1$
public static final String IGNORE_COUNT = DSFBREAKPOINT + ".ignoreCount"; //$NON-NLS-1$
public static final String IS_ENABLED = DSFBREAKPOINT + ".isEnabled"; //$NON-NLS-1$
// Minimal watchpoint properties
public static final String EXPRESSION = DSFBREAKPOINT + ".expression"; //$NON-NLS-1$
public static final String READ = DSFBREAKPOINT + ".read"; //$NON-NLS-1$
public static final String WRITE = DSFBREAKPOINT + ".write"; //$NON-NLS-1$
public Object getReference();
public IDsfBreakpointNature getNature(); public IDsfBreakpointNature getNature();
// Retrieve the breakpoint set of properties
public Map<String,Object> getProperties(); public Map<String,Object> getProperties();
// Retrieve a single breakpoint property
public Object getProperty(String key, Object defaultValue); public Object getProperty(String key, Object defaultValue);
public Object setProperty(String key, Object value); // Update a single breakpoint property
public void setProperty(String key, Object value);
}; };
/** /**
@ -75,18 +70,17 @@ public interface IBreakpoints extends IDsfService {
* @param context the execution context of the breakpoint * @param context the execution context of the breakpoint
* @param drm the list of breakpoints in the execution context * @param drm the list of breakpoints in the execution context
*/ */
public void getBreakpointList(IBreakpointsTargetDMContext context, public void getBreakpoints(IBreakpointsTargetDMContext context,
DataRequestMonitor<IDsfBreakpointDMContext[]> drm); DataRequestMonitor<IDsfBreakpointDMContext[]> drm);
/** /**
* Retrieves a specific breakpoint from the service. * Retrieves a specific breakpoint from the service.
* *
* @param context the execution context of the breakpoint
* @param dmc the breakpoint reference * @param dmc the breakpoint reference
* @return IDsfBreakpoint * @param drm the DRM returning the breakpoint data
*/ */
public IDsfBreakpoint getBreakpoint(IBreakpointsTargetDMContext context, public void getBreakpointDMData(IDsfBreakpointDMContext dmc,
IDsfBreakpointDMContext dmc); DataRequestMonitor<IDsfBreakpoint> drm);
/** /**
* Adds a breakpoint on the target. * Adds a breakpoint on the target.
@ -102,27 +96,26 @@ public interface IBreakpoints extends IDsfService {
* the back-end to decide if it is an error or not. * the back-end to decide if it is an error or not.
* *
* @param context the execution context of the breakpoint * @param context the execution context of the breakpoint
* @param breakpoint the breakpoint to insert * @param breakpoint the breakpoint
* @param drm the DRM returning the breakpoint reference * @param drm the DRM returning the breakpoint reference
*/ */
public void addBreakpoint(IBreakpointsTargetDMContext context, public void insertBreakpoint(IBreakpointsTargetDMContext context,
IDsfBreakpoint breakpoint, IDsfBreakpoint breakpoint,
DataRequestMonitor<IDsfBreakpointDMContext> drm); DataRequestMonitor<IDsfBreakpointDMContext> drm);
/** /**
* Removes the breakpoint or watchpoint on the target. * Removes the breakpoint on the target.
* *
* If the breakpoint doesn't exist, silently ignore it. * If the breakpoint doesn't exist, silently ignore it.
* *
* @param context the execution context of the breakpoint * @param dmc the context of the breakpoints to remove
* @param dmc the reference of breakpoint to remove
* @param rm the asynchronous request monitor * @param rm the asynchronous request monitor
*/ */
public void removeBreakpoint(IBreakpointsTargetDMContext context, public void removeBreakpoint(IDsfBreakpointDMContext dmc,
IDsfBreakpointDMContext dmc, RequestMonitor rm); RequestMonitor rm);
/** /**
* Updates the breakpoint or watchpoint properties on the target. * Updates the breakpoint properties on the target.
* *
* To add/update/remove a property, simply create a map with * To add/update/remove a property, simply create a map with
* the desired value(s) for the given key(s). * the desired value(s) for the given key(s).
@ -132,32 +125,13 @@ public interface IBreakpoints extends IDsfService {
* removed then re-inserted. * removed then re-inserted.
* *
* A null value is used for removal of a property e.g.: * A null value is used for removal of a property e.g.:
* properties.set(FUNCTION, null); * properties.set(some_key, null);
* *
* @param context the execution context of the breakpoint * @param delta the delta properties
* @param dmc the reference of breakpoint to modify * @param dmc the context of the breakpoints to modify
* @param rm the asynchronous request monitor * @param rm the asynchronous request monitor
*/ */
public void updateBreakpoint(IBreakpointsTargetDMContext context, public void updateBreakpoint(IDsfBreakpointDMContext dmc,
IDsfBreakpointDMContext dmc, Map<String,Object> properties, Map<String,Object> delta, RequestMonitor drm);
DataRequestMonitor<IDsfBreakpointDMContext> drm);
/**
* Adds a watchpoint on the target.
*
* The watchpoint reference is returned in the DRM. The actual watchpoint
* object can be later be retrieved using getBreakpoint(reference).
*
* E.g.:
* IDsfBreakpointDMContext ref = addWatchpoint(...);
* IDsfBreakpoint bp = getBreakpoint(ref);
*
* @param context the execution context of the watchpoint
* @param watchpoint the watchpoint to insert
* @param rm the asynchronous request monitor
*/
public void addWatchpoint(IBreakpointsTargetDMContext context,
IDsfBreakpoint watchpoint,
DataRequestMonitor<IDsfBreakpointDMContext> drm);
} }