Settings API/SPI Changes by Date - NetBeans API Javadoc (Current Development Version)

Index of APIs

Settings 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.

All changes by date

(Apr 17 '07) Provides support for Lookups.forPath
(May 9 '06) Added new attribute for provider registration - settings.subclasses
(Sep 3 '02) Provide context to convertors
(Aug 22 '02) Added DOMConvertor supporting composed content

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.settings/1 > 1.20

(1.13) Provides support for Lookups.forPath
(1.12) Added new attribute for provider registration - settings.subclasses
(1.2) Provide context to convertors
(1.1) Added DOMConvertor supporting composed content

Changes by affected class

`org.netbeans.spi.settings.Convertor`

(Sep 3 '02) Provide context to convertors

`org.netbeans.spi.settings.DOMConvertor`

(Sep 3 '02) Provide context to convertors
(Aug 22 '02) Added DOMConvertor supporting composed content

Details of all changes by API and date

Settings SPI

Provides support for `Lookups.forPath`

Apr 17 '07; API spec. version: 1.13; made by: jtulach; issues: #98426
Provides support for Lookups.forPath(String) method in order to replace now deprecated FolderLookup.

Added new attribute for provider registration - settings.subclasses

May 9 '06; API spec. version: 1.12; made by: dstrupl; issues: #65950
New file attribute can be used if the registered convertor is capable of handling subclasses of the registered class. The attribute name is "settings.subclasses" and it can be set on the same file object under "xml/memory" as "settings.providerPath". The value of the attribute must be boolean. Defaults to false.

Provide context to convertors

Sep 3 '02; API spec. version: 1.2; affected top-level classes: Convertor DOMConvertor; made by: jpokorsky; issues: #26076
Get a context associated with the reader. It can contain various info like a file location of the read object etc.

Added DOMConvertor supporting composed content

Aug 22 '02; API spec. version: 1.1; affected top-level classes: DOMConvertor; made by: jpokorsky; issues: #26284
Allow to reuse already written convertors by newly created ones to facilitate a storing of complex objects.