Breakpoint Container Factories

org.eclipse.debug.ui.breakpointContainerFactories

3.1

This extension point provides a mechanism for contributing breakpoint container factories. A breakpoint container factory divides breakpoints up into containers based on some specific criteria. For example, a breakpoint container factory is provided to organize breakpoints by project. Factories with the specified name will be automatically created by the Debug Platform and presented to the user as options for grouping breakpoints. The supplied delegate class, which must implement org.eclipse.debug.ui.IBreakpointContainerFactoryDelegate, will be loaded only as necessary, to avoid early plugin activation.

<!ELEMENT extension (breakpointContainerFactory+)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT breakpointContainerFactory EMPTY>

<!ATTLIST breakpointContainerFactory

id    CDATA #REQUIRED

class CDATA #REQUIRED

label CDATA #REQUIRED

icon  CDATA #IMPLIED>


The following is an example of an extension provided by the Debug UI plugin

<extension point=

"org.eclipse.debug.ui.breakpointContainerFactories"

>

<breakpointContainerFactory class=

"org.eclipse.debug.internal.ui.views.breakpoints.BreakpointProjectContainerFactoryDelegate"

id=

"org.eclipse.debug.ui.breakpointProjectContainerFactory"

label=

"Project"

icon=

"icons/full/obj16/prj_obj.gif"

/>

</extension>

In the above example, the supplied factory will be included in the list of options for grouping breakpoints ("Group By > Project"). When the breakpoints view is set to group breakpoints by project, the factory will query the given class, which implements IBreakpointContainerFactoryDelegate.

Value of the attribute class must be a fully qualified name of a Java class that implements the interface org.eclipse.debug.ui.IBreakpointContainerFactoryDelegate.