This document lists changes made to the XML tools
APIs. Please ask on the dev@xml.netbeans.org or nbdev@netbeans.org
mailing list if you have any questions about the details of a
change, or are wondering how to convert existing code to be compatible.
Ask there also for new backward compatible API enhancements.
No incompatible changes following version "1.0" should be introduced.
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.
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.api.xml/1 > 1.20
org.netbeans.api.xml.cookies and the
org.netbeans.spi.xml.cookies packages were moved into
a new module api.xml.ui.
CookieObserver.Message static inner replaced by standalone
CookieObserver class. New class is immutable.
addDetail and
getDetail methods. CookieObserver.Message
turned into non-abstarct class.
XMLProcessorMessage replaced by
XMLProcessorDetail.
CookieObserver and XMLProcessorMessage introduced.
DataObjectAdapters' methods inputSource and
source do not throw IOException any more.
DataObject from support classes were
replaced by InputSource or Source respectively.
New class DataObjectAdapters was introduced to simplify
providers.
DefaultXMLProcessorMessage replaced by
DefaultXMLProcessorDetail.
DafaultXMLProcessorMessage introduced.
Minimal XML tools API subset seems to be found. Asked
API gurus and dev@openide.netbeans.orgcode> for its review.
The minimal subset consists of:
createInputSource renamed to
wrapInputSource taking one parameter.
ProcessorListener removed.
It is moved to cookies as CookieObserver.
getDefault(Lookup ctx)
method. Now it is not needed, there are no clients until new projects
scope lookups will be introduced.
UserCatalog takes context
parameter.
UsersCatalog to
UserCatalog as original name have not
been understood as User's.
SourceResolver was not well evolvable.
UsersCatalog is a wrapper class consisting of set of
methods each of them is by default implemented to indicate that
its functionality is not provided by the default implementation.
UserCatalog contextualization.
UsersCatalogProvider to
UserCatalogProvider as original name have not
been understood as User's.
UsersCatalogProvider introduced to express what is role of
SPI and what is client API.
AbstractUtil because it
was not XML specifics. It should go to some general utility API such
us OpenIDE util.
AbstractUtil which is
used just for debugging and string localizing purposes.