The supplied dates indicate when the API change was made, on the CVS trunk. From this you can generally tell whether the change should be present in a given build or not; for trunk builds, simply whether it was made before or after the change; for builds on a stabilization branch, whether the branch was made before or after the given date. In some cases corresponding API changes have been made both in the trunk and in an in-progress stabilization branch, if they were needed for a bug fix; this ought to be marked in this list.
release41 branch was made on Apr 03 '05 for use in the NetBeans 4.1 release.
Specification versions: 6.0 begins after this point.
release40 branch was made on Nov 01 '04 for use in the NetBeans 4.0 release.
Specification versions: 5.0 begins after this point.
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.
NbDocument.Colors moved to org.openide.options.NbDocument.COLORSPrintSettingsCloneableEditorSupport.notifyModified is called only on first modificationNbDocument.Colors moved to org.openide.options.NbDocument.COLORSPrintPreferencesPrintSettingsseverity, custom_sidebar_color, browsable and priority
attributes
Line.SHOW_TOFRONT
CloneableEditorSupport.notifyModified is called only on first modificationgetInputStream() method in CloneableEditorSupportIndexOutOfBoundsException
can be thrown from NbDocument.findLineOffset method
Line methods deprecated in favor of annotationsIndentEngine a service typePrintSettings.getPageFormat requires a printer jobThese 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.text > 1.20
NbDocument.Colors moved to org.openide.options.NbDocument.COLORSPrintPreferencesPrintSettingsseverity, custom_sidebar_color, browsable and priority
attributes
Line.SHOW_TOFRONT
CloneableEditorSupport.notifyModified is called only on first modificationgetInputStream() method in CloneableEditorSupportLine methods deprecated in favor of annotationsorg.openide.text.ActiveEditorDroporg.openide.text.Annotatableorg.openide.text.Annotationorg.openide.text.AnnotationProviderorg.openide.text.CloneableEditororg.openide.text.CloneableEditorSupportCloneableEditorSupport.notifyModified is called only on first modificationgetInputStream() method in CloneableEditorSupportorg.openide.text.CloneableEditorSupportRedirectororg.openide.windows.CloneableOpenSupportorg.openide.text.DataEditorSupportorg.openide.text.DocumentLineLine methods deprecated in favor of annotationsorg.openide.text.EditorSupportorg.openide.text.IndentEngineIndentEngine a service typeorg.openide.text.LineLine.SHOW_TOFRONT
Line methods deprecated in favor of annotationsorg.openide.text.NbDocumentNbDocument.Colors moved to org.openide.options.NbDocument.COLORSIndexOutOfBoundsException
can be thrown from NbDocument.findLineOffset method
org.openide.loaders.OpenSupportorg.openide.text.PositionReforg.openide.text.PrintPreferencesPrintPreferencesorg.openide.text.PrintSettingsPrintSettingsPrintSettings.getPageFormat requires a printer jobCloneableEditorSupport; made by: mslama; issues:
#171713Add CloneableEditorSupport.asynchronous to control if CloneableEditorSupport.open opens document synchronously or not. If CloneableEditorSupport.asynchronous return true then CloneableEditorSupport.open opens document synchronously and handles UserQuestionException. If CloneableEditorSupport.asynchronous return false then CloneableEditorSupport.open does not open document. Document is then opened during initialization of CloneableEditor form non AWT thread and UserQuestionException is handled there. Implementation of method asynchronous in CloneableEditorSupport returns false ie. it keeps original behavior of CloneableEditorSupport.open. Subclasses can overwrite method asynchronous to return true to avoid blocking AWT thread by call CloneableEditorSupport.open which calls CloneableEditorSupport.openDocument.
NbDocument; made by: mslama; issues:
#168415Add NbDocument.findRecentEditorPane to allow non blocking retrieval of recently selected editor pane. Method returns null when editor pane initialization is not finished. Client is notified about finished pane initialization by property change event EditorCookie.Observable.PROP_OPENED_PANES. NbDocument.findRecentEditorPane is replacement for EditorCookie.getOpenedPanes which waits till all editor panes are initialized. It is nonblocking only when EditorCookie is instanceof CloneableEditorSupport.
Line; made by: mslama; issues:
#138146Improve Line.show to have better control over its open/visibility behavior. Previous version of Line.show mixes open and visibility behavior into one parameter. New version separates this into 2 parameters. It is possible to use any combination of these 2 parameters without need to add new constants for previous version. 2 enum types ShowOpenType and ShowVisibilityType are added.
CloneableEditorSupport; made by: mmetelka; issues:
#13063CloneableEditorSupport.saveDocument() checks document's "beforeSaveDocument" property for a Runnable to be executed before the actual save will be done.
CloneableEditor; made by: jtulach; issues:
#130171In order to speedup, or remove the load of initialization of kit in AWT during startup, the initialization is done outside of AWT thread as much as possible. This provides new API for editor kits, one component and one system property.
NbDocument.Colors moved to org.openide.options.NbDocument; made by: mslama; issues:
#88531
Class NbDocument.Colors was removed to remove dependency on org.openide.options.
Runtime backward compatibility was ensured by moving into org.openide.options module which is
already deprecated.
NbDocument.COLORSNbDocument; made by: mslama; issues:
#88531
Field NbDocument.COLORS was removed to remove dependency on org.openide.options.
PrintPreferencesPrintPreferences; made by: rmatous; issues:
#88531
Class PrintPreferences was added as replacement for original
class PrintSettings.
PrintSettingsorg.openide.text.PrintSettings; made by: rmatous; issues:
#88531
Classes PrintSettings and PrintSettingsBeanInfo
were removed. Runtime backward compatibility was ensured
by moving both into org.openide.options module which is already deprecated.
Line; made by: pnejedly; issues:
#94607The Line.show() method accepts show mode constant,
that influences the way the Line is displayed on the request.
These additional constants provide new modes for opening the line
in a shared editor window that can be replaced by subsequent calls of
Line.show(SHOW_REUSE) on Lines from different
Document. This is useful for quick source browsing without
cluttering the UI with too many opened editors.
CloneableEditorSupportRedirector; made by: jtulach; issues:
#51690The CloneableEditorSupportRedirector
class allows a redirection of operations on a CloneableEditorSupport
object to another one. This can be useful if there are two logical
files representing one physical and one wants to have just a single
editor for both files. In such case just implement the
CloneableEditorSupportRedirector.
CloneableEditorSupport; made by: vstejskal; issues:
#52657The CloneableEditorSupport.getEditorKit() method
allows to access EditorKits registered in
MimeLookup. This is meant to be the primary way of finding
EditorKits registered by Netbeans modules. The
JEditorPane.createEditorKitForContentType and the
other related methods in JEditorPane should only be
used for finding EditorKits provided by JDK.
CloneableEditor; made by: saubrecht; issues:
#50129The custom JEditorPane used by CloneableEditor
has a custom DropTarget
instance which listens for some special objects (usually files) being
dragged over the editor pane and uses an instace of
ExternalDropHandler class from the global
Lookup to see if the drop can be accepted.
If the dragged object is supported then the caret in the editor does
not follow the cursor to indicate the drop position as if when dragging
a text snippet and regular Drop-Copy cursor is shown instead.
When the object is dropped into the editor the ExternalDropHandler
will process it (e.g. opens the file in a new editor tab).
CloneableEditorSupport CloneableEditor org.openide.text.DataEditorSupport; made by: dsimonek; issues:
#66777A messageHtmlName method has been added to
CloneableEditorSupport to allow for display names with html tags.
CloneableEditor uses this new method to set its html display name
correctly. Also DataEditorSupport now overrides
messageHtmlName to connect with Node.getHtmlDisplayName.
ActiveEditorDrop; made by: mroskanin; issues:
#61367An ActiveEditorDrop interface has been added due to
drag and drop callback support described at issue #61367
CloneableEditorSupport CloneableEditor; made by: abadea; issues:
#60922A wrapEditorComponent method has been added to
CloneableEditorSupport allowing to wrap the editor component
in another component.
severity, custom_sidebar_color, browsable and priority
attributes
severity, custom_sidebar_color, browsable and priority
attributes.
Line.SHOW_TOFRONT
Line; issues:
#47825EditorSupportLineSet and brings
editor's parent Window to be fronted above all other top-level windows.
CloneableEditorSupport.notifyModified is called only on first modificationCloneableEditorSupport; made by: jtulach; issues:
#52493
It has been found that CloneableEditorSupport.notifyModified
is called more often than it should. It used to be called after every
keystroke, which is bad, as its return value could not be honored -
it is not possible to prevent modification when the document is already
modified. Now the method is called only on first modification of the
document and if it returns false, the modification is not allowed.
This may be incompatible for clients that relied on the often calls.
Such clients need to be fixed.
CloneableEditorSupport; made by: pnejedly; issues:
#51441Deprecated EditorSupport has had a method
openAt, which has no easy replacement in
CloneableEditorSupport.
The method is implemented in CloneableEditorSupport,
but is package private. This change makes it protected.
CloneableEditorSupport.Pane interface,
Pane.ensureVisible(). The implementing classes should ensure that the pane's component
is open and visible after calling this method. Is used in CloneableEditorSupport.openAt().
Line; made by: jtulach; issues:
#43484AnnotationProvider; made by: pnejedly; issues:
#41345NbDocument CloneableEditorSupport CloneableEditor org.openide.text.EditorSupport; made by: mkleint; issues:
#41085CloneableEditorSupport; made by: pnejedly; issues:
#37892CloneableEditorSupport.documentID
to allow subclasses to compute preferred ID String used for
TopComponent persistence.
getInputStream() method in CloneableEditorSupportCloneableEditorSupport; made by: pjiricka; issues:
#34692CloneableEditorSupport; made by: jtulach; issues:
#32937PositionRef org.openide.text.DataEditorSupport; made by: jtulach; issues:
#32143PositionRef.getEditorSupport() method
has been removed to enabled separation of EditorSupport to openide-loaders.jar
Line org.openide.text.DataEditorSupport; made by: jtulach; issues:
#32143Line.getDataObject()
method had to be removed and replaced by Line.getLookup which
provides more general way for providing line context. The direct replacement
for the old method is DataObject DataEditorSupport.findDataObject(Line).
Line DocumentLine; made by: jtulach; issues:
#32143Line and
DocumentLine constructors taking DataObject had to be
modified to take Lookup or plain Object instead.
CloneableEditorSupport; made by: jtulach; issues:
#32143String messageLine (Line) that can be
overriden to provide meaningful display name for lines produced
by this support.
IndexOutOfBoundsException
can be thrown from NbDocument.findLineOffset method
NbDocument; issues:
#17144NbDocument.findLineOffset() can throw an unchecked
IndexOutOfBoundsException. The method could throw
the exception also before (and also other kinds of them see the issue),
but it was not declared in javadoc. This change makes it compliant
to use with standard Swing text package and also with
Line.Set.getCurrent() method.
AnnotationAnnotation.notifyAttached() and
Annotation.notifyDetached().
AnnotatableAnnotatable.getText(). Listeners can be attached to
Annotatable.PROP_TEXT property.
AnnotatableLine methods deprecated in favor of annotationsLine DocumentLinesetBreakpoint, isBreakpoint,
markError, unmarkError,
markCurrentLine, unmarkCurrentLine, and
canBeMarkedCurrent are deprecated. Use
Annotation.attach() and detach() instead.
Line now extends Annotatable abstract class.
Annotation Annotatable NbDocumentNbDocument methods like markError,
markCurrent, markNormal are deprecated. Use
addAnnotation and removeAnnotation instead.
CloneableEditorSupport; made by: initializeCloneableEditor to allow easier
customization of the editor after creation and also after deserialization.
CloneableEditorSupportgetUndoRedo() method was made protected final instead of
final.
CloneableEditorSupportupdateTitles() method was made protected final instead of
private.
IndentEngine a service typeIndentEngineServiceType. A few new methods relating to lookup.
register had been deleted as it is no longer useful); the
method was then restored but made deprecated.
org.openide.text.EditorSupport CloneableEditorSupport CloneableEditor org.openide.loaders.OpenSupport org.openide.windows.CloneableOpenSupportEditorSupport and
OpenSupport, so that subclasses can have much finer control
over pieces of its functionality.
NbDocumentNbDocument.COLORS and NbDocument.Colors
deprecated.
boston. These classes were long disused (and should only have
ever been used by the editor module anyway, which did not need them).
PrintSettings.getPageFormat requires a printer joborg.openide.text.PrintSettingsgetPageFormat method now requires a PrinterJob
argument.
boston. User-stored settings of this class should be
backwards compatible, however code directly calling
getPageFormat will produce a deprecation warning. Probably no
one should be directly referring to this class or its BeanInfo outside the
package; public only because it is a system option that must be public to
appear.
Built on July 6 2010. | Portions Copyright 1997-2010 Sun Microsystems, Inc. All rights reserved.