Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
org.netbeans.editor.AtomicLockDocument Use AtomicLockDocument
org.netbeans.editor.AtomicLockListener use AtomicLockListener
org.netbeans.editor.CharSeq use DocumentUtilities.getText(javax.swing.text.Document) to obtain CharSequence instance from a document instead.
org.netbeans.editor.GapStart deprecated without replacement. Possibly use document's view as CharSequence by DocumentUtilities.getText(javax.swing.text.Document).
org.netbeans.editor.SideBarFactory use SideBarFactory from editor.lib2 module.

Deprecated Classes

Class and Description
org.netbeans.editor.Abbrev Use Editor Code Templates API instead. This class is no longer functional.
org.netbeans.editor.ActionFactory.AbbrevExpandAction Use Editor Code Templates API instead.
org.netbeans.editor.ActionFactory.AbbrevResetAction Use Editor Code Templates API instead.
org.netbeans.editor.ActionFactory.CollapseAllFolds Implementation was adopted into editor.fold.nbui module. This implementation is kept for backward compatibility only
org.netbeans.editor.ActionFactory.CollapseFold Implementation was adopted into editor.fold.nbui module. This implementation is kept for backward compatibility only
org.netbeans.editor.ActionFactory.ExpandAllFolds Implementation was adopted into editor.fold.nbui module. This implementation is kept for backward compatibility only
org.netbeans.editor.ActionFactory.ExpandFold Implementation was adopted into editor.fold.nbui module. This implementation is kept for backward compatibility only
org.netbeans.editor.ActionFactory.RemoveWordNextAction use CamelCaseInterceptor instead
org.netbeans.editor.ActionFactory.RemoveWordPreviousAction use CamelCaseInterceptor instead
org.netbeans.editor.ActionFactory.RunMacroAction Without any replacement. This action is not used anymore and is no longer functional.
org.netbeans.editor.ActionFactory.StartMacroRecordingAction Without any replacement. This action is not used anymore.
org.netbeans.editor.ActionFactory.StopMacroRecordingAction Without any replacement. This action is not used anymore and is no longer functional.
org.netbeans.editor.ActionFactory.ToggleLineNumbersAction this action is no longer used. It is reimplemented in editor.actions module.
org.netbeans.editor.ActionFactory.ToggleTypingModeAction Replaced by ToggleTypingModeAction in editor.actions module
org.netbeans.editor.AtomicLockEvent use AtomicLockEvent
org.netbeans.editor.BaseKit.CompoundAction this action is no longer used.
org.netbeans.editor.BaseKit.DefaultKeyTypedAction Please do not subclass this class. Use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.BaseKit.DeleteCharAction Please do not subclass this class. Use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.BaseKit.InsertBreakAction Please do not subclass this class. Use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.BaseKit.InsertContentAction this action is no longer used. It is reimplemented in editor.actions module.
org.netbeans.editor.BaseKit.KitCompoundAction this action is no longer used. It is reimplemented in editor.actions module.
org.netbeans.editor.BaseKit.NextWordAction use CamelCaseInterceptor instead
org.netbeans.editor.BaseKit.PreviousWordAction use CamelCaseInterceptor instead
org.netbeans.editor.BaseKit.ReadOnlyAction this action is no longer used. It is reimplemented in editor.actions module.
org.netbeans.editor.BaseKit.WritableAction this action is no longer used. It is reimplemented in editor.actions module.
org.netbeans.editor.CodeFoldingSideBar You should use FoldUtilities#createSidebarComponent(javax.swing.text.JTextComponent) or FoldUtilities#getFoldingSidebarFactory() instead. Subclassing CodeFoldingSidebar is no longer actively supported, though still working.
org.netbeans.editor.DialogSupport See org.openide.spi.editor.lib2.DialogFactory. DialogSupport has no public replacement.
org.netbeans.editor.EditorDebug Should never have been made public. No replacement.
org.netbeans.editor.EditorState Use Editor Settings and Settings Storage APIs. Please note that the states stored here are not persisted and therefore don't survive JVM restarts.
org.netbeans.editor.ext.ExtKit.AllCompletionShowAction Please use Editor Code Completion API instead, for details see Editor Code Completion.
org.netbeans.editor.ext.ExtKit.CodeSelectAction this action is deprecated and will be removed in future releases.
org.netbeans.editor.ext.ExtKit.CompletionShowAction Please use Editor Code Completion API instead, for details see Editor Code Completion.
org.netbeans.editor.ext.ExtKit.CompletionTooltipShowAction Please use Editor Code Completion API instead, for details see Editor Code Completion.
org.netbeans.editor.ext.ExtKit.DocumentationShowAction Please use Editor Code Completion API instead, for details see Editor Code Completion.
org.netbeans.editor.ext.ExtKit.ExtDefaultKeyTypedAction Please do not subclass this class. Use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.ext.ExtKit.ExtDeleteCharAction Please do not subclass this class. Use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.ext.ExtKit.GotoDeclarationAction this action is no longer used. It is reimplemented in editor.actions module.
org.netbeans.editor.ext.ExtKit.MatchBraceAction Please use Braces Matching SPI instead, for details see Editor Braces Matching.
org.netbeans.editor.FoldingToolTip This is an utility class which should not have been public. It is used only from code folding implementation and was not intended for general purpose. This implementation is retained for backward compatibility only. The live implementation can be found in editor.fold.nbui module.
org.netbeans.editor.ImplementationProvider See org.netbeans.spi.editor.lib2.EditorImplementationProvider
org.netbeans.editor.LineSeparatorConversion Use CharacterConversions instead.
org.netbeans.editor.LocaleSupport this class is deprecated as the number of bundle queries is proportional to the number of registered localizers which is not optimal from the performance point of view. The queries through this class should be replaced by queries to individual bundles.
org.netbeans.editor.MacroDialogSupport Without any replacement. This class is no longer functional.
org.netbeans.editor.MacroSavePanel Without any replacement. This class is no longer functional.
org.netbeans.editor.Mark Use Position instead.
org.netbeans.editor.MarkFactory.SyntaxMark syntax marks are no longer used to hold lexer states.
org.netbeans.editor.Registry Use EditorRegistry from Editor Library 2 instead.
org.netbeans.editor.SegmentCache The caching is no longer performed as the object creation in the present JVMs is fast. Simply use new Segment().

Deprecated Fields

Field and Description
org.netbeans.editor.BaseAction.ABBREV_RESET Not used anymore.
org.netbeans.editor.CodeFoldingSideBar.backColor Without any replacement.
org.netbeans.editor.ext.ExtKit.codeSelectAction this action name is not actively used by ExtKit and will be removed in future releases.
org.netbeans.editor.ext.ExtKit.escapeAction this action name is not actively used by ExtKit and will be removed in future releases.
org.netbeans.editor.ext.ExtKit.findAction Without any replacement.
org.netbeans.editor.CodeFoldingSideBar.font Without any replacement.
org.netbeans.editor.CodeFoldingSideBar.foreColor Without any replacement.
org.netbeans.editor.BaseDocument.LINE_BATCH_SIZE property no longer populated; deprecated without replacement.
org.netbeans.editor.BaseDocument.LINE_LIMIT_PROP property no longer populated; deprecated without replacement.

Deprecated Methods

Method and Description
org.netbeans.editor.BaseDocument.addAtomicLockListener(AtomicLockListener) use LineDocumentUtils.as(doc, AtomicLockDocument.class).addAtomicLockListener(l);
org.netbeans.editor.BaseKit.InsertBreakAction.afterBreak(JTextComponent, BaseDocument, Caret, Object) Please use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.Utilities.annotateLoggable(Throwable) Use java.util.logging.Logger instead with the proper name, log level and message.
org.netbeans.editor.BaseDocument.atomicLock() Please use BaseDocument.runAtomic(java.lang.Runnable) instead.
org.netbeans.editor.BaseDocument.atomicUnlock() Please use BaseDocument.runAtomic(java.lang.Runnable) instead.
org.netbeans.editor.BaseKit.InsertBreakAction.beforeBreak(JTextComponent, BaseDocument, Caret) Please use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.EditorUI.caretMoveDot(int, Rectangle, int)
org.netbeans.editor.EditorUI.caretSetDot(int, Rectangle, int)
org.netbeans.editor.BaseKit.DeleteCharAction.charBackspaced(BaseDocument, int, Caret, char) Please use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.BaseKit.DeleteCharAction.charDeleted(BaseDocument, int, Caret, char) Please use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.JumpList.checkAddEntry(JTextComponent, int) Use JumpList.addEntry(JTextComponent, int) instead.
org.netbeans.editor.ext.ExtKit.ExtDefaultKeyTypedAction.checkCompletion(JTextComponent, String) Please use Editor Code Completion API instead, for details see Editor Code Completion.
org.netbeans.editor.BaseKit.DefaultKeyTypedAction.checkIndent(JTextComponent, String) Please use AutomatedIndentig or Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.ext.ExtKit.ExtDefaultKeyTypedAction.checkIndentHotChars(JTextComponent, String) Please use AutomatedIndentig or Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.EditorUI.createColoringMap() Use Editor Settings or Editor Settings Storage API instead. This method is never called.
org.netbeans.editor.BaseKit.createFormatSyntax(Document) Please use Editor Indentation API instead, for details see Editor Indentation.
org.netbeans.editor.BaseKit.createPrintEditorUI(BaseDocument) this method is no longer being called by EditorUI. BaseKit.createPrintEditorUI(BaseDocument, boolean, boolean) is being called instead.
org.netbeans.editor.BaseKit.createSyntax(Document) Please use Lexer instead, for details see Lexer.
org.netbeans.editor.BaseKit.createSyntaxSupport(BaseDocument) Please use Lexer instead, for details see Lexer.
org.netbeans.editor.Analyzer.createWhiteSpaceFillBuffer(int, int, int)
org.netbeans.editor.BaseAction.findValue(String) this method is deprecated like the LocaleSupport which it uses by default. It should be replaced by implementing BaseAction.getShortDescriptionBundleClass()
org.netbeans.editor.BaseCaret.foldHierarchyChanged(FoldHierarchyEvent)
org.netbeans.editor.EditorUI.getAbbrev() Use Editor Code Templates API instead.
org.netbeans.editor.CodeFoldingSideBar.getBackColor() Without any replacement.
org.netbeans.editor.BaseDocumentEvent.getChars()
org.netbeans.editor.EditorUI.getColoring(String) Use Editor Settings API instead.
org.netbeans.editor.CodeFoldingSideBar.getColoringFont() Without any replacement.
org.netbeans.editor.EditorUI.getColoringMap() Use Editor Settings API instead.
org.netbeans.editor.EditorUI.getDefaultColoring() Use Editor Settings API instead.
org.netbeans.editor.Utilities.getFirstNonEmptyRow(BaseDocument, int, boolean)
org.netbeans.editor.Utilities.getFirstNonWhiteBwd(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getFirstNonWhiteBwd(BaseDocument, int, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getFirstNonWhiteFwd(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getFirstNonWhiteFwd(BaseDocument, int, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getFirstNonWhiteRow(BaseDocument, int, boolean)
org.netbeans.editor.Utilities.getFirstWhiteBwd(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getFirstWhiteBwd(BaseDocument, int, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getFirstWhiteFwd(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getFirstWhiteFwd(BaseDocument, int, int) use LineDocumentUtils
org.netbeans.editor.CodeFoldingSideBar.getForeColor() Without any replacement.
org.netbeans.editor.Mark.getInsertAfter()
org.netbeans.editor.BaseKit.getKit(Class) Use CloneableEditorSupport.getEditorKit or MimeLookup instead to find EditorKit for a mime type.
org.netbeans.editor.BaseDocument.getKitClass() Don't use implementation class of editor kits. Use mime type, MimePath and MimeLookup.
org.netbeans.editor.BaseDocumentEvent.getLine()
org.netbeans.editor.Utilities.getLineOffset(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.BaseKit.getMacroActions() Without any replacement.
org.netbeans.editor.Utilities.getNextWord(BaseDocument, int)
org.netbeans.editor.Utilities.getNextWord(JTextComponent, int)
org.netbeans.editor.Annotations.LineAnnotations.getPasive() The method name contains typo. Use Annotations.LineAnnotations.getPassive() instead.
org.netbeans.editor.Annotations.getPasiveAnnotations(int) The method name contains a typo. Use getPassiveAnnotationsForLine
org.netbeans.editor.Utilities.getPositionAbove(JTextComponent, int, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getPositionBelow(JTextComponent, int, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getPreviousWord(BaseDocument, int)
org.netbeans.editor.Utilities.getPreviousWord(JTextComponent, int)
org.netbeans.editor.Utilities.getRowCount(BaseDocument)
org.netbeans.editor.Utilities.getRowCount(BaseDocument, int, int)
org.netbeans.editor.Utilities.getRowEnd(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getRowEnd(JTextComponent, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getRowLastNonWhite(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getRowStart(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.Utilities.getRowStart(BaseDocument, int, int) Deprecated without replacement
org.netbeans.editor.Utilities.getRowStartFromLineOffset(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.SegmentCache.getSegment() Simply returns new Segment().
org.netbeans.editor.EditorUI.getSharedColoringMap(Class) Use Editor Settings API instead.
org.netbeans.editor.SegmentCache.getSharedInstance() Simply use new Segment().
org.netbeans.editor.BaseDocument.getShiftWidth() Please use Editor Indentation API instead, for details see Editor Indentation.
org.netbeans.editor.BaseDocument.getSyntaxSupport() Please use Lexer instead, for details see Lexer.
org.netbeans.editor.Utilities.getTabInsertString(BaseDocument, int)
org.netbeans.editor.Utilities.getWordEnd(BaseDocument, int)
org.netbeans.editor.Utilities.getWordEnd(JTextComponent, int)
org.netbeans.editor.Utilities.getWordStart(BaseDocument, int)
org.netbeans.editor.Utilities.getWordStart(JTextComponent, int) use LineDocumentUtils
org.netbeans.editor.BaseKit.DefaultKeyTypedAction.insertString(BaseDocument, int, Caret, String, boolean) Please use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.Utilities.isRowEmpty(BaseDocument, int) use LineDocumentUtils.isLineEmpty(org.netbeans.api.editor.document.LineDocument, int).
org.netbeans.editor.Utilities.isRowWhite(BaseDocument, int) use LineDocumentUtils
org.netbeans.editor.BaseCaret.moveDot(int, Rectangle, int) use #setDot(int) preceded by JComponent.scrollRectToVisible().
org.netbeans.editor.SegmentCache.releaseSegment(Segment) Does nothing.
org.netbeans.editor.BaseDocument.removeAtomicLockListener(AtomicLockListener) use LineDocumentUtils.as(doc, AtomicLockDocument.class).removeAtomicLockListener(l);
org.netbeans.editor.Mark.removeUpdateAction(int, int) It will not be supported in the future.
org.netbeans.editor.BaseDocument.repaintBlock(int, int) Please use JTextComponent.getUI().damageRange() instead.
org.netbeans.editor.BaseKit.DefaultKeyTypedAction.replaceSelection(JTextComponent, int, Caret, String, boolean) Please use Typing Hooks instead, for details see Editor Library 2.
org.netbeans.editor.ext.ExtCaret.requestMatchBraceUpdateSync() Please use Braces Matching SPI instead, for details see Editor Braces Matching.
org.netbeans.editor.EditorUI.scrollRectToVisible(Rectangle, int) use JComponent.scrollRectToVisible() instead of this method.
org.netbeans.editor.BaseCaret.setDot(int, Rectangle, int) use #setDot(int) preceded by JComponent.scrollRectToVisible().
org.netbeans.editor.BaseCaret.setDot(int, Rectangle, int, boolean) use #setDot(int, boolean) preceded by JComponent.scrollRectToVisible().
org.netbeans.editor.BaseDocument.setPostModificationDocumentListener(DocumentListener) Use addPostModificationDocumentListener(DocumentListener)
org.netbeans.editor.ext.ExtCaret.updateMatchBrace() Please use Braces Matching SPI instead, for details see Editor Braces Matching.
org.netbeans.editor.EditorUI.updateVirtualHeight(int) virtual size is no longer used and effects of this method are ignored
org.netbeans.editor.EditorUI.updateVirtualWidth(int) virtual size is no longer used and effects of this method are ignored

Deprecated Constructors

Constructor and Description
org.netbeans.editor.BaseDocument(Class, boolean) Use of editor kit's implementation classes is deprecated in favor of mime types.
org.netbeans.editor.CodeFoldingSideBar() Don't use this constructor, it does nothing!
org.netbeans.editor.GuardedDocument(Class) The use of editor kit's implementation classes is deprecated in favor of mime types.
org.netbeans.editor.GuardedDocument(Class, boolean, StyleContext) The use of editor kit's implementation classes is deprecated in favor of mime types.