Change History for the Execution API - NetBeans API Javadoc 5.0.0

Introduction

This document lists changes made to the Execution API.

Index of APIs

Execution API

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.

(Mar 16 '04) Execution of Startup folder removed
(Mar 16 '04) NbClassLoader constructors deprecated
(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

All changes by date

(Mar 16 '04) Execution of Startup folder removed
(Mar 16 '04) NbClassLoader constructors deprecated
(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

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.openide.execution > 1.20

(1.2) Execution of Startup folder removed
(1.2) NbClassLoader constructors deprecated
(1.2) Execution API split into deprecated and nondeprecated halves

Changes by affected class

`org.openide.cookies.ArgumentsCookie`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.cookies.ExecCookie`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.execution.ExecInfo`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.actions.ExecuteAction`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.loaders.ExecutionSupport`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.execution.Executor`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.execution.ExecutorType`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.execution.NbClassLoader`

(Mar 16 '04) NbClassLoader constructors deprecated

`org.openide.execution.NbfsStreamHandlerFactory`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.execution.NbfsURLConnection`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.execution.ProcessExecutor`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

`org.openide.execution.ThreadExecutor`

(Mar 16 '04) Execution API split into deprecated and nondeprecated halves

Details of all changes by API and date

Execution API

Execution of `Startup` folder removed

Mar 16 '04; API spec. version: 1.2; made by: jglick

Previously it was possible to place objects with an ExecCookie into the Startup folder of the system filesystem, and they would be run during startup.

In NetBeans 4.0 there is no such cookie any more, and that old style of execution is no longer supported. Modules may continue to use ModuleInstall.restored for startup hooks, possibly providing special modes for user customization, but there is no generic infrastructure for this.

Compatibility:

There is no direct equivalent in NetBeans 4.0.

`NbClassLoader` constructors deprecated

Mar 16 '04; API spec. version: 1.2; affected top-level classes: NbClassLoader; made by: jglick

All of the existing constructors of NbClassLoader were deprecated since they used Filesystems to refer to the classpath; one new classpath-safe constructor was added instead.

For similar reasons, a number of static methods in the class were deprecated as well.

Compatibility:

Old constructors continue to behave as before but that behavior is unlikely to be useful in NetBeans 4.0.

Execution API split into deprecated and nondeprecated halves

Mar 16 '04; API spec. version: 1.2; affected top-level classes: org.openide.actions.ExecuteAction org.openide.cookies.ArgumentsCookie org.openide.cookies.ExecCookie org.openide.execution.ExecInfo org.openide.execution.Executor org.openide.execution.ExecutorType org.openide.execution.NbfsStreamHandlerFactory org.openide.execution.NbfsURLConnection org.openide.execution.ProcessExecutor org.openide.execution.ThreadExecutor org.openide.loaders.ExecutionSupport; made by: jglick

As part of the NetBeans 4.0 build system, the Execution API was split into two halves. The first half continues to be used as before. The second half is now deprecated and lives in a separate module.

Compatibility:

New code must declare which of the two modules (or both) it wishes to compile against and use.

Binary-compatible