Interface IProcessFactory


  • public interface IProcessFactory
    A process factory is used to override default process (IProcess) creation by the debug plug-in, and can be contributed via plug-in XML. When a new process is created via DebugPlugin.newProcess(..), the launch configuration associated with the specified launch is consulted for a process factory attribute (DebugPlugin.ATTR_PROCESS_FACTORY_ID). If present, the associated process factory is consulted to create a process for the launch. If not present a default process implementation is created and returned by the debug plug-in.

    Following is example plug-in XML that contributes a process factory.

     <extension point="org.eclipse.debug.core.processFactories">
       <processFactory
               id="com.example.ExampleIdentifier"
               class="com.example.ExampleProcessFactory">
       </processFactory>
     </extension>
     
    The attributes are specified as follows:
    • id - a unique identifier for this extension point
    • class - the fully qualified name of a class the implements IProcessFactory

    Clients contributing a process factory are intended to implement this interface.

    Since:
    3.0
    • Method Detail

      • newProcess

        IProcess newProcess​(ILaunch launch,
                            Process process,
                            String label,
                            Map<String,​String> attributes)
        Creates and returns a new process representing the given java.lang.Process. A streams proxy is created for the I/O streams in the system process. The process is added to the given launch, and the process is initialized with the given attribute map.
        Parameters:
        launch - the launch the process is contained in
        process - the system process to wrap
        label - the label assigned to the process
        attributes - initial values for the attribute map
        Returns:
        the process
        See Also:
        IProcess