Deprecated API

Deprecated Classes

org.openide.options.ControlPanel
With the use of services and XML layers, this class is not useful.

org.openide.text.EditorSupport
Use DataEditorSupport instead

org.openide.loaders.ExtensionListEditor
Should not be used directly (property editor search path will find it).

org.openide.nodes.IndexedCustomizer
Better to use Index.Support.showIndexedCustomizer which behaves better with the window system.

org.openide.windows.InputOutput.Null
Use InputOutput.NULL instead.

org.openide.windows.InputOutput.NullOutputWriter
Use InputOutput.NULL instead.

org.openide.awt.JInlineMenu
JInlineMenu is resizing itself after being displayed, this behavior causes a lot of troubles for Swing/AWT on various platforms. Very hard to be fixed. Module developers should stop using this class.

org.openide.modules.ManifestSection

org.openide.modules.ModuleDescription

org.openide.text.NbDocument.Colors
Not useful for anything.

org.openide.NotifyDescriptor.Exception
Better to use TopManager.notifyException(java.lang.Throwable), or for more control various methods in ErrorManager.

org.openide.util.WeakListener.Change
use appropriate method instead

org.openide.util.WeakListener.Document
use appropriate method instead

org.openide.util.WeakListener.FileChange
use appropriate method instead

org.openide.util.WeakListener.FileStatus
use appropriate method instead

org.openide.util.WeakListener.Focus
use appropriate method instead

org.openide.util.WeakListener.Node
use appropriate method instead

org.openide.util.WeakListener.PropertyChange
use appropriate method instead

org.openide.util.WeakListener.Repository
use appropriate method instead

org.openide.util.WeakListener.VetoableChange
use appropriate method instead

org.openide.loaders.XMLDataObject.Info
use Lookup Representation of xmlinfo file holding container of Processors.

Deprecated Interfaces

org.openide.explorer.view.MenuView.Acceptor
This interface is almost the same as NodeAcceptor so it is redundant and obsoleted. Use NodeAcceptor interface instead.

org.openide.util.NbBundle.ClassLoaderFinder
Useless.

org.openide.Places.Folders
Most users of these folders will be using their paths directly in XML layers; since these paths are necessarily defined in the APIs anyway, using a method call for each location is not necessary.

org.openide.actions.ToolsAction.Model
Useless, see ActionManager.

org.openide.loaders.XMLDataObject.Processor
use lookup

Deprecated Exceptions

org.openide.util.io.FoldingIOException
Better to create a new IOException and annotate it with the throwable.

org.openide.modules.IllegalModuleException

Deprecated Fields

org.openide.filesystems.DefaultAttributes.ATTR_EXT
does not handle XML attributes

org.openide.filesystems.DefaultAttributes.ATTR_NAME
does not handle XML attributes

org.openide.filesystems.DefaultAttributes.ATTR_NAME_EXT
does not handle XML attributes

org.openide.options.ContextSystemOption.beanContext
To obtain bean context use ContextSystemOption.getBeanContextProxy().

org.openide.text.NbDocument.COLORS
Not useful for anything.

org.openide.text.EditorSupport.EDITOR_MODE
Use CloneableEditorSupport.EDITOR_MODE instead.

org.openide.explorer.propertysheet.PropertySheet.iAlphaSort
Presumably noone uses this variable. If you want to customize the property sheet look you can change the image files directly (or use your own).

org.openide.explorer.propertysheet.PropertySheet.iCustomize
Presumably noone uses this variable. If you want to customize the property sheet look you can change the image files directly (or use your own).

org.openide.explorer.propertysheet.PropertySheet.iDisplayWritableOnly
Presumably noone uses this variable. If you want to customize the property sheet look you can change the image files directly (or use your own).

org.openide.explorer.propertysheet.PropertySheet.iNoSort
Presumably noone uses this variable. If you want to customize the property sheet look you can change the image files directly (or use your own).

org.openide.explorer.propertysheet.PropertySheet.iTypeSort
Presumably noone uses this variable. If you want to customize the property sheet look you can change the image files directly (or use your own).

org.openide.text.EditorSupport.modifiedAppendix

org.openide.windows.InputOutput.nullReader
Use InputOutput.NULL instead.

org.openide.windows.InputOutput.nullWriter
Use InputOutput.NULL instead.

org.openide.util.Utilities.OS_DEC
please use OS_TRU64 instead

org.openide.loaders.XMLDataObject.PROP_INFO
info is not supported anymore. Replaced with lookup.

org.openide.loaders.XMLDataObject.XMLINFO_DTD_PUBLIC_ID
replaced with Lookup

org.openide.loaders.XMLDataObject.XMLINFO_DTD_PUBLIC_ID_FORTE
replaced with Lookup

Deprecated Methods

org.openide.explorer.view.MenuView.Acceptor.accept(Node)
whole interface is obsoleted, use NodeAcceptor.acceptNodes(org.openide.nodes.Node[]) instead.

org.openide.options.ControlPanel.add(SystemOption)
Use a declaration in a manifest file.

org.openide.loaders.XMLDataObject.addEntityResolver(EntityResolver)
EntityResolver is a parser user responsibility. Every time set a EntityResolver to an XML parser you use. A utility entity resolver chain is provided. The IDE also defines a default entity catalog reachable at EntityCatalog.

org.openide.text.Line.canBeMarkedCurrent(int, Line)
since 1.20.

org.openide.loaders.ExecSupport.checkCompiled()
The check should be done in an action - ExecAction, ...

org.openide.compiler.ExternalCompiler.compilerType()
While subclassing this method and specifying a type will still work, it is no longer recommended. Instead, please use Compiler.compilerGroupKey() and make all compiler-specific state available to the compiler group via other means (such as getter methods).

org.openide.Places.Nodes.controlPanel()
Typically no longer meaningful.

org.openide.loaders.XMLDataObject.createDocument()
Replaced with XMLUtil It directly violates DOM's root element reference read-only status. If you can not move to XMLUtil for compatabilty reasons please replace with following workaround:

 String templ = "";
 InputSource in = new InputSource(new StringReader(templ));
 in.setSystemId("StringReader");  //workaround
 DocumentBuilder builder = DocumentBuilderFactory.newInstance().newDocumentBuilder();
 Document doc = builder.parse(in);
 

org.openide.loaders.XMLDataObject.createEditorCookie()
CookieSet factory should be used by subclasses instead.

org.openide.loaders.XMLDataObject.createInputSource(URL)
Deprecated as it was a workaround method. Replace with new InputSource(url.toExternalForm()).

org.openide.loaders.XMLDataObject.createParser()
Use XMLUtil instead. It will create a SAX XMLReader that is SAX Parser replacement. You will have to replace DocumentHandler by ContentHandler besause XMLReader accepts just ContentHandler.

Alternatively if not interested in new callbacks defined by SAX 2.0 you can wrap returned XMLReader into XMLReaderAdapter that implements Parser.

org.openide.loaders.XMLDataObject.createParser(boolean)
Use Util instead setting ns to false. For more details see createParser

org.openide.compiler.ExternalCompilerGroup.createProcess(NbProcessDescriptor, String[], Object)
Please instead directly override ExternalCompilerGroup.createProcess(NbProcessDescriptor,String[]) as this version does not use the now-deprecated "compiler type" object.

org.openide.windows.WindowManager.createWorkspace(String)
please use method createWorkspace(String name, String displayName) instead

org.openide.filesystems.FileUtil.extractJar(FileObject, InputStream)
Use of XML filesystem layers generally obsoletes this method.

org.openide.Places.folders()
Just as easy to access folders by resource name.

org.openide.TopManager.getControlPanel()
Not useful.

org.openide.compiler.CompilerType.getDefault()
This is probably useless since compiler types normally apply to specific data object types, so no single compiler would be useful in all circumstances.

org.openide.debugger.DebuggerType.getDefault()
There is probably not a single debugger type meaningfully applicable to all file types. If you explicitly want to invoke the plain Debugger interfaces, use DebuggerType.Default instead.

org.openide.execution.Executor.getDefault()
The notion of a default executor for all file types is probably meaningless.

org.openide.execution.ScriptType.getDefault()
Probably meaningless, find all available types and filter with ScriptType.acceptFileObject(org.openide.filesystems.FileObject) instead.

org.openide.modules.ModuleDescription.getDescription()
Currently disused in favor of ModuleDescription.getDescriptionResource()

org.openide.loaders.TemplateWizard.getDescriptionAsResource(DataObject)
Use TemplateWizard.getDescription(org.openide.loaders.DataObject) instead.

org.openide.text.PositionRef.getEditorSupport()
Please use PositionRef.getCloneableEditorSupport() instead.

org.openide.loaders.XMLDataObject.getInfo()
not used anymore

org.openide.modules.ModuleDescription.getLayer()
ModuleDescription.getLayerResource() actually used now

org.openide.filesystems.FileUtil.getMIMEType(String)
in favour of getMIMEType(FileObject) as MIME cannot be generaly detected by a file object extension.

org.openide.text.PrintSettings.getPageFormat()
Use PrintSettings.getPageFormat(PrinterJob) instead.

org.openide.loaders.XMLDataObject.getRegisteredInfo(String)
Register via lookup

org.openide.filesystems.XMLFileSystem.getXmlUrls()
experimental method. Nobody should rely on this method yet.

org.openide.actions.SaveAsTemplateAction.iconResource()
Should never be called publically.

org.openide.text.Line.isBreakpoint()
since 1.20. Use Annotation instead

org.openide.loaders.InstanceSupport.isJavaBean()
This method probably should not be used, as it catches a variety of potentially serious exceptions and errors, and swallows them so as to produce a simple boolean result. (Notifying them all would be inappropriate as they typically come from user code.) Better to directly parse the bytecode, using e.g. the classfile module, which is immune to this class of errors.

org.openide.text.NbDocument.markBreakpoint(StyledDocument, int)
since 1.20. Use addAnnotation() instead

org.openide.text.NbDocument.markCurrent(StyledDocument, int)
since 1.20. Use addAnnotation() instead

org.openide.text.Line.markCurrentLine()
since 1.20. Use Annotation.attach() instead

org.openide.text.Line.markError()
since 1.20. Use Annotation.attach() instead

org.openide.text.NbDocument.markError(StyledDocument, int)
since 1.20. Use addAnnotation() instead

org.openide.text.NbDocument.markNormal(StyledDocument, int)
since 1.20. Use addAnnotation() instead

org.openide.loaders.XMLDataObject.parse(URL)
Use XMLUtil instead setting null error handler and validation to false.

org.openide.loaders.XMLDataObject.parse(URL, boolean)
Use XMLUtil instead setting null handler.

org.openide.loaders.XMLDataObject.parse(URL, ErrorHandler)
Use XMLUtil instead setting validation to false.

org.openide.loaders.XMLDataObject.parse(URL, ErrorHandler, boolean)
Use XMLUtil instead.

org.openide.Places.Nodes.project()
Typically no longer meaningful.

org.openide.text.IndentEngine.register(String, IndentEngine)
IndentEngine now is a ServiceType

org.openide.loaders.XMLDataObject.registerCatalogEntry(String, String)
use module's XMLlayer instead registering at "Services" folder an XML document with EntityCatalog.PUBLIC_ID

org.openide.loaders.XMLDataObject.registerCatalogEntry(String, String, ClassLoader)
use module's XMLlayer instead registering at "Services" folder an XML document with EntityCatalog.PUBLIC_ID

org.openide.loaders.XMLDataObject.registerInfo(String, XMLDataObject.Info)
Register via lookup

org.openide.options.ControlPanel.remove(SystemOption)

org.openide.loaders.XMLDataObject.removeEntityResolver(EntityResolver)
EntityResolver is a parser user responsibility.

org.openide.src.ClassElement.removeInterface(Identifier[])
the method's name is incorrect; please use removeInterfaces(ins) instead.

org.openide.src.ClassElement.removeInterfaces(Identifier)
the method's name is incorrect; please use removeInterface(i) instead.

org.openide.actions.OpenProjectAction.run()
does nothing

org.openide.Places.Nodes.session()
Typically no longer meaningful.

org.openide.text.EditorSupport.setActions(SystemAction[])

org.openide.text.Line.setBreakpoint(boolean)
since 1.20. Use Annotation.attach() instead

org.openide.util.NbBundle.setClassLoaderFinder(NbBundle.ClassLoaderFinder)
Useless.

org.openide.loaders.MultiDataObject.setCookieSet(CookieSet)
just use getCookieSet().add(...) instead

org.openide.nodes.AbstractNode.setCookieSet(CookieSet)
just use getCookieSet().add(...) instead

org.openide.TopManager.setDefault(TopManager)
Useless.

org.openide.nodes.NodeOp.setDefaultActions(SystemAction[])
Useless.

org.openide.loaders.TemplateWizard.setDescriptionAsResource(DataObject, String)
Use TemplateWizard.setDescription(org.openide.loaders.DataObject, java.net.URL) instead.

org.openide.awt.HtmlBrowser.setFactory(HtmlBrowser.Factory)
Use Lookup instead to register factories

org.openide.loaders.XMLDataObject.setInfo(XMLDataObject.Info)
does not do anything useful

org.openide.actions.ToolsAction.setModel(ToolsAction.Model)
Useless, see ActionManager.

org.openide.filesystems.XMLFileSystem.setXmlUrls(URL[])
experimental method. Nobody should rely on this method yet.

org.openide.execution.NbClassPath.toFile(FileObject)
You probably should use FileUtil.toFile(org.openide.filesystems.FileObject) instead.

org.openide.text.Line.unmarkCurrentLine()
since 1.20. Use Annotation.detach() instead

org.openide.text.Line.unmarkError()
since 1.20. Use Annotation.detach() instead

org.openide.loaders.XMLDataObject.updateIconBase(String)
it is better to listen on properties

org.openide.util.Utilities.wrapString(String, int, boolean, boolean)
Use (String, int, BreakIterator, boolean) as it is friendlier to I18N.

org.openide.util.Utilities.wrapStringToArray(String, int, boolean, boolean)
use Utilities.wrapStringToArray(String, int, BreakIterator, boolean) since it is better for I18N

org.openide.loaders.XMLDataObject.write(Document, OutputStream, String)
Moved to XMLUtil.

org.openide.loaders.XMLDataObject.write(Document, Writer)
Encoding used by Writer may be in direct conflict with encoding declared in document. Replaced with Util.

Deprecated Constructors

org.openide.compiler.Compiler(Compiler)
use new Compiler ().dependsOn (c);

org.openide.compiler.Compiler(Compiler[])
use new Compiler ().dependsOn (Arrays.asList (dep));

org.openide.compiler.Compiler(CompilerJob)
use job.add (new Compiler ());

org.openide.loaders.DataFolder.Index(DataFolder)
Please explicitly specify a node to be safe.

org.openide.loaders.DataFolder(FileObject, DataLoader)
Since 1.13 do not use this constructor, it is for backward compatibility only.

org.openide.loaders.DataShadow(FileObject, DataObject, DataLoader)
Since 1.13 do not use this constructor, it is for backward compatibility only

org.openide.util.HelpCtx(URL)
Does not work nicely with JavaHelp.

org.openide.explorer.view.MenuView.Menu(Node, MenuView.Acceptor)
use MenuView.Menu.MenuView.Menu(Node, NodeAcceptor)

org.openide.explorer.view.MenuView.Menu(Node, MenuView.Acceptor, boolean)
use MenuView.Menu.MenuView.Menu(Node, NodeAcceptor, boolean)

org.openide.explorer.view.MenuView.MenuItem(Node, MenuView.Acceptor)
Use proper constructor with (@link NodeAcceptor).

org.openide.explorer.view.MenuView.MenuItem(Node, MenuView.Acceptor, boolean)
Use proper constructor with (@link NodeAcceptor).

org.openide.modules.ModuleDescription(File)
Only for testing.

org.openide.modules.ModuleDescription(String)
Only for testing.

org.openide.modules.ModuleDescription(String, Manifest)
Better to explicitly provide a classloader.

org.openide.util.NbBundle()
There is no reason to instantiate or subclass this class. All methods in it are static.