Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
org.openide.loaders.CreateFromTemplateAttributesProvider Use CreateFromTemplateAttributes instead.
org.openide.awt.Toolbar.DnDListener There is no public support for toolbar drag and drop.
org.openide.loaders.XMLDataObject.Processor Use Environment.Provider instead.

Deprecated Classes

Class and Description
org.openide.loaders.ConnectionSupport Should no longer be used.
org.openide.loaders.CreateFromTemplateHandler in 7.59. Use CreateFromTemplateHandler instead.
org.openide.text.EditorSupport Use DataEditorSupport instead
org.openide.loaders.FolderLookup use Lookups.forPath(java.lang.String) instead.
org.openide.actions.InstantiateAction Deprecated since 3.42. The use of this action should be avoided.
org.openide.loaders.RepositoryNodeFactory Probably unwise to call this for any reason; obsolete UI.
org.openide.awt.Toolbar.DnDEvent
org.openide.loaders.XMLDataObject.Info use Lookup Representation of xmlinfo file holding container of Processors.

Deprecated Fields

Field and Description
org.openide.awt.Toolbar.BASIC_HEIGHT Use getBasicHeight instead.
org.openide.text.EditorSupport.EDITOR_MODE Use CloneableEditorSupport.EDITOR_MODE instead.
org.openide.text.EditorSupport.modifiedAppendix no longer used
org.openide.loaders.XMLDataObject.PROP_INFO info is not supported anymore. Replaced with lookup.
org.openide.loaders.DataFilter.serialVersionUID Only public by accident.
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

Method and Description
org.openide.loaders.XMLDataObject.addEntityResolver(EntityResolver) EntityResolver is a parser user responsibility. Every time set a EntityResolver to an XML parser you use. The OpenIDE now defines a system EntityCatalog.
org.openide.loaders.DataNode.createActions() Use DataNode.getActions(boolean) or do nothing and let the data loader specify actions.
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 = "<myroot/>"; 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 XMLUtil.createXMLReader(boolean,boolean) instead setting ns to false. For more details see createParser
org.openide.loaders.DataLoader.defaultActions() Instead of overriding this method it is preferable to override DataLoader.actionsContext().
org.openide.loaders.InstanceSupport.findHelp(InstanceCookie) use org.openide.util.HelpCtx.findHelp (Object)
org.openide.loaders.Environment.findSettingsContext(DataObject) This method is probably unused and useless.
org.openide.awt.Toolbar.fireDragToolbar(int, int, int) There is no public support for toolbar drag and drop.
org.openide.awt.Toolbar.fireDropToolbar(int, int, int) There is no public support for toolbar drag and drop.
org.openide.loaders.DataNode.getActions() Use getActions(boolean)
org.openide.awt.Toolbar.getBasicHeight() Returns preferred icon size.
org.openide.loaders.TemplateWizard.getDescriptionAsResource(DataObject) Use TemplateWizard.getDescription(org.openide.loaders.DataObject) instead.
org.openide.loaders.XMLDataObject.getInfo() not used anymore
org.openide.loaders.XMLDataObject.getRegisteredInfo(String) Register via lookup
org.openide.actions.SaveAsTemplateAction.iconResource() Should never be called publically.
org.openide.loaders.InstanceSupport.isApplet() 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.loaders.InstanceSupport.isExecutable() 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.loaders.InstanceSupport.isInterface() 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.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.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.loaders.XMLDataObject.registerCatalogEntry(String, String) Do not rely on global (non-modular) resolvers. Use XMLUtil instead.
org.openide.loaders.XMLDataObject.registerCatalogEntry(String, String, ClassLoader) Do not rely on global (non-modular) resolvers. Use XMLUtil instead.
org.openide.loaders.XMLDataObject.registerInfo(String, XMLDataObject.Info) Register an Environment via lookup, see some details.
org.openide.loaders.XMLDataObject.removeEntityResolver(EntityResolver) EntityResolver is a parser user responsibility.
org.openide.awt.Toolbar.rowCount(int) Always returns 1
org.openide.text.EditorSupport.setActions(SystemAction[]) has no effect
org.openide.loaders.MultiDataObject.setCookieSet(CookieSet) just use getCookieSet().add(...) instead
org.openide.loaders.TemplateWizard.setDescriptionAsResource(DataObject, String) Use TemplateWizard.setDescription(org.openide.loaders.DataObject, java.net.URL) instead.
org.openide.awt.Toolbar.setDnDListener(Toolbar.DnDListener)
org.openide.loaders.XMLDataObject.setInfo(XMLDataObject.Info) does not do anything useful
org.openide.loaders.TemplateWizard.setIterator(DataObject, TemplateWizard.Iterator) since 2.13 you should provide the iterator from getCookie method
org.openide.awt.ToolbarPool.setToolbarsListener(Toolbar.DnDListener)
org.openide.loaders.XMLDataObject.updateIconBase(String) it is better to listen on properties
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

Constructor and Description
org.openide.loaders.DataFolder(FileObject) This method should not be used in client code. If you are searching for a DataFolder for a FileObject use DataFolder.findFolder(org.openide.filesystems.FileObject) factory method.
org.openide.loaders.DataFolder(FileObject, DataLoader) Since 1.13 do not use this constructor, it is for backward compatibility only.
org.openide.loaders.DataLoader(Class<? extends DataObject>) Use DataLoader.DataLoader(String) instead.
org.openide.loaders.DataShadow(FileObject, DataObject, DataLoader) Since 1.13 do not use this constructor, it is for backward compatibility only
org.openide.loaders.DataFolder.Index(DataFolder) Please explicitly specify a node to be safe.
org.openide.loaders.MultiFileLoader(Class<? extends DataObject>) Use MultiFileLoader#MultiFileLoader(String) instead.
org.openide.loaders.UniFileLoader(Class<? extends DataObject>) Use UniFileLoader#UniFileLoader(String) instead.