Introduction

This document lists changes made to the External Execution API.

Index of APIs

External Execution API
External Execution Startup Arguments API
External Execution Process Destroy SPI

Incompatible changes by date

Fuller descriptions of all changes can be found below (follow links).

Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.

(Nov 20 '08) Published as a stable API

All changes by date

(Feb 7 '12) SPI to allow extending process startup
(Dec 20 '11) New API method to open IO tab on error
(Nov 21 '11) New API/SPI to abstract process builder
(Feb 17 '10) New API method to avoid reset of custom IO
(Jul 1 '09) New SPI for improved external process termination
(Nov 20 '08) Published as a stable API
(Jul 1 '08) Initial version released
(Apr 7 '08) Configurable charset for process streams

Changes by version

These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line:

OpenIDE-Module-Module-Dependencies: org.netbeans.modules.extexecution > 1.20

(1.30) SPI to allow extending process startup
(1.29) New API method to open IO tab on error
(1.28) New API/SPI to abstract process builder
(1.20) New API method to avoid reset of custom IO
(1.16) New SPI for improved external process termination
(1.14) Configurable charset for process streams
(1.13) Published as a stable API
(1.6) Initial version released

Changes by affected class

`org.netbeans.api.extexecution.ExecutionDescriptor`

(Dec 20 '11) New API method to open IO tab on error
(Feb 17 '10) New API method to avoid reset of custom IO
(Apr 7 '08) Configurable charset for process streams

`org.netbeans.api.extexecution.ExternalProcessSupport`

(Jul 1 '09) New SPI for improved external process termination

`org.netbeans.api.extexecution.ProcessBuilder`

(Nov 21 '11) New API/SPI to abstract process builder

`org.netbeans.spi.extexecution.ProcessBuilderFactory`

(Nov 21 '11) New API/SPI to abstract process builder

`org.netbeans.spi.extexecution.ProcessBuilderImplementation`

(Nov 21 '11) New API/SPI to abstract process builder

`org.netbeans.spi.extexecution.destroy.ProcessDestroyPerformer`

(Jul 1 '09) New SPI for improved external process termination

`org.netbeans.api.extexecution.startup.StartupExtender`

(Feb 7 '12) SPI to allow extending process startup

`org.netbeans.spi.extexecution.startup.StartupExtenderImplementation`

(Feb 7 '12) SPI to allow extending process startup

Details of all changes by API and date

External Execution API

New API method to open IO tab on error

Dec 20 '11; API spec. version: 1.29; affected top-level classes: ExecutionDescriptor; made by: phejl; issues: #206254
Added configuration method to ExecutionDescriptor to allow opening of output tab on nonzero exit code.

New API/SPI to abstract process builder

Nov 21 '11; API spec. version: 1.28; affected top-level classes: ProcessBuilder ProcessBuilderFactory ProcessBuilderImplementation; made by: phejl; issues: #205104
New API/SPI classes to allow different implementations of process builders.

New API method to avoid reset of custom IO

Feb 17 '10; API spec. version: 1.20; affected top-level classes: ExecutionDescriptor; made by: phejl; issues: #180459
Added configuration method to ExecutionDescriptor to make reset of IO optional for custom IO.

Published as a stable API

Nov 20 '08; API spec. version: 1.13; made by: phejl
Published as a stable API. Refactored to API packages.

Initial version released

Jul 1 '08; API spec. version: 1.6; made by: phejl
First initial release of the External Execution API.

Configurable charset for process streams

Apr 7 '08; API spec. version: 1.14; affected top-level classes: ExecutionDescriptor; made by: phejl; issues: #161607
Added charset() method to ExecutionDescriptor to configure the charset used to decode process streams.

External Execution Startup Arguments API

SPI to allow extending process startup

Feb 7 '12; API spec. version: 1.30; affected top-level classes: StartupExtender StartupExtenderImplementation; made by: phejl; issues: #206196
This API/SPI allow third party plugins (such as JRebel) to register extenders of process startup. The interested clients such as projects or servers may optionaly query such extenders and pass additional arguments to the process.

External Execution Process Destroy SPI

New SPI for improved external process termination

Jul 1 '09; API spec. version: 1.16; affected top-level classes: ExternalProcessSupport ProcessDestroyPerformer; made by: mkleint; issues: #138116
Added API/SPI support to kill the whole process tree on Process.destroy().