- * Note: The attribute translator is expected to access IDE breakpoint manager - * objects which are synchronized using the resource system. It may also need to - * access DSF services using the DSF session executor. Therefore, the - * implementation needs to pay special attention to the synchronization - * annotations on each method of the interface. - * - * @see BreakpointMediator - * @since 2.1 - */ -public interface IBreakpointAttributeTranslator2 { - - /** - * Initializes the translator. This method is called by the breakpoint - * mediator service, when the mediator service is initialized. - */ - @ConfinedToDsfExecutor("") - public void initialize(BreakpointsMediator2 mediator); - - /** - * Disposes the translator. Also called by the mediator upon service - * shutdown. - */ - @ConfinedToDsfExecutor("") - public void dispose(); - - /** - * Returns whether the given IDE breakpoint is supported by this debugger. - */ - @ThreadSafeAndProhibitedFromDsfExecutor("") - public boolean supportsBreakpoint(IBreakpoint bp); - - /** - * Resolve the breakpoint in given context. A platform BP may be mapped to - * ont or more target BPs, e.g. a breakpoint in an in-line function may be - * mapped to several target BPs, or a thread-specific BP may be mapped to - * several target BPs each of which is for one thread. This method will get - * the list of attribute maps each of which corresponds to one target BP. - *
- * This method is and must be called in DSF execution thread.
- *
- * @param context
- * - a IBreakpointsTargetDMContext object (which could be a
- * process or a loaded module) in which we locate target BPs for
- * the platform BP. Cannot be null.
- * @param breakpoint
- * - platform breakpoint.
- * @param bpAttributes
- * - all attributes of the breakpoint, usually output from
- * {@link #getAllBreakpointAttributes(IBreakpoint, boolean)}.
- * @param drm
- * - on completion of the request, the DataRequestMonitor
- * contains one or more attribute maps each of which
- * corresponding to one target breakpoint.
- * @throws CoreException
- */
- @ConfinedToDsfExecutor("")
- public void resolveBreakpoint(IBreakpointsTargetDMContext context, IBreakpoint breakpoint,
- Map
- * The attributes returned are independent of runtime context (process,
- * module, etc), whereas attributes from
- * {@link #resolveBreakpoint(IBreakpointsTargetDMContext, IBreakpoint, Map, DataRequestMonitor)}
- * are context sensitive.
- *
- * Note this method must not be called in DSF dispatch thread because we are
- * accessing the resources system to retrieve the breakpoint attributes.
- * Accessing the resources system potentially requires using global locks.
- *
- * @param platformBP
- * @param bpManagerEnabled
- * @return list of target (debugger implementation) recognizable attributes.
- * @throws CoreException
- */
- @ThreadSafeAndProhibitedFromDsfExecutor("")
- public Map
- * This method overlaps somewhat with the {@link #resolveBreakpoint}
- * method. However, this method is currently only used by the mediator in
- * conjunction with the {@link #canUpdateAttributes} method.
- *
- * @param platformBPAttr
- * @return
- */
- @ThreadSafe
- public Map
- * Note this method is not and must not be called in DSF dispatch thread.
- *
- * @param bpsInfo
- * @param eventType
- */
- @ThreadSafeAndProhibitedFromDsfExecutor("")
- public void updateBreakpointsStatus(Map
- * This will be called in DSF dispatch thread.
- *
- * @param bp platform breakpoint.
- * @param context
- * @param attributes target-recognizable attributes.
- * @return false as long as one of the attributes cannot be updated by client, otherwise true.
- */
- @ConfinedToDsfExecutor("")
- public boolean canUpdateAttributes(IBreakpoint bp, IBreakpointsTargetDMContext context, Map
+ * Note: The attribute translator is expected to access IDE breakpoint manager
+ * objects which are synchronized using the resource system. It may also need to
+ * access DSF services using the DSF session executor. Therefore, the
+ * implementation needs to pay special attention to the synchronization
+ * annotations on each method of the interface.
+ *
+ * @see BreakpointMediator
+ * @since 2.1
+ */
+public interface IBreakpointAttributeTranslator2 {
+
+ /**
+ * Initializes the translator. This method is called by the breakpoint
+ * mediator service, when the mediator service is initialized.
+ */
+ @ConfinedToDsfExecutor("")
+ public void initialize(BreakpointsMediator2 mediator);
+
+ /**
+ * Disposes the translator. Also called by the mediator upon service
+ * shutdown.
+ */
+ @ConfinedToDsfExecutor("")
+ public void dispose();
+
+ /**
+ * Returns whether the given IDE breakpoint is supported by this debugger.
+ */
+ @ThreadSafeAndProhibitedFromDsfExecutor("")
+ public boolean supportsBreakpoint(IBreakpoint bp);
+
+ /**
+ * Resolve the breakpoint in given context. A platform BP may be mapped to
+ * one or more target BPs, e.g. a breakpoint in an in-line function may be
+ * mapped to several target BPs, or a thread-specific BP may be mapped to
+ * several target BPs each of which is for one thread. This method will get
+ * the list of attribute maps each of which corresponds to one target BP.
+ *
+ * This method is and must be called in DSF execution thread.
+ *
+ * @param context
+ * a IBreakpointsTargetDMContext object (which could be a
+ * process or a loaded module) in which we locate target BPs for
+ * the platform BP. Cannot be null.
+ * @param breakpoint
+ * platform breakpoint.
+ * @param bpAttributes
+ * all attributes of the breakpoint, usually output from
+ * {@link #getAllBreakpointAttributes(IBreakpoint, boolean)}.
+ * @param drm
+ * on completion of the request, the DataRequestMonitor
+ * contains one or more attribute maps each of which
+ * corresponding to one target breakpoint.
+ * @throws CoreException
+ */
+ @ConfinedToDsfExecutor("")
+ public void resolveBreakpoint(IBreakpointsTargetDMContext context, IBreakpoint breakpoint,
+ Map
+ * The attributes returned are independent of runtime context (process,
+ * module, etc), whereas attributes from
+ * {@link #resolveBreakpoint(IBreakpointsTargetDMContext, IBreakpoint, Map, DataRequestMonitor)}
+ * are context sensitive.
+ *
+ * Note this method must not be called in DSF dispatch thread because we are
+ * accessing the resources system to retrieve the breakpoint attributes.
+ * Accessing the resources system potentially requires using global locks.
+ *
+ * @param platformBP
+ * @param bpManagerEnabled
+ * @return list of target (debugger implementation) recognizable attributes.
+ * @throws CoreException
+ */
+ @ThreadSafeAndProhibitedFromDsfExecutor("")
+ public Map
+ * This method overlaps somewhat with the {@link #resolveBreakpoint}
+ * method. However, this method is currently only used by the mediator in
+ * conjunction with the {@link #canUpdateAttributes} method.
+ *
+ * @param platformBPAttr
+ * @return
+ */
+ @ThreadSafe
+ public Map
+ * Note this method is not and must not be called in DSF dispatch thread.
+ *
+ * @param bpsInfo
+ * @param eventType
+ */
+ @ThreadSafeAndProhibitedFromDsfExecutor("")
+ public void updateBreakpointsStatus(Map
+ * This will be called in DSF dispatch thread.
+ *
+ * @param bp platform breakpoint.
+ * @param context
+ * @param attributes target-recognizable attributes.
+ * @return false as long as one of the attributes cannot be updated by client, otherwise true.
+ */
+ @ConfinedToDsfExecutor("")
+ public boolean canUpdateAttributes(IBreakpoint bp, IBreakpointsTargetDMContext context, Map