Deprecated API

Contents

• Interfaces
• Classes
• Exception Classes
• Fields
• Methods
• Constructors

Deprecated Interfaces

Interface	Description
org.openide.util.actions.ActionPerformer	No longer recommended. See CallbackSystemAction.setActionPerformer(ActionPerformer) for details.

Deprecated Classes

Class	Description
org.openide.ServiceType	The prefered way to register and lookup services is now Lookup as described in services registration and lookup page.
org.openide.ServiceType.Handle	The prefered way to register and lookup services is now Lookup as described in services registration and lookup page.
org.openide.ServiceType.Registry	Use lookup instead.
org.openide.util.actions.BooleanStateAction	Use new support for stateful actions in Actions or ActionState annotation
org.openide.util.Queue	Use BlockingQueue instead.

Deprecated Exception Classes

Exception Class	Description
org.openide.util.Utilities.UnorderableException	Used only by the deprecated partialSort

Deprecated Fields

Field	Description
org.openide.util.Utilities.OS_DEC	please use OS_TRU64 instead
org.openide.util.Utilities.OS_UNIX_MASK	Use Utilities.isUnix() instead.
org.openide.util.Utilities.OS_WINDOWS_MASK	Use Utilities.isWindows() instead.

Deprecated Methods

Method	Description
org.openide.ErrorManager.copyAnnotation(Throwable, Throwable)	Now does the same thing as ErrorManager.annotate(Throwable,Throwable) except marks the annotation ErrorManager.UNKNOWN severity. Otherwise you used to have inadvertent data loss when copyFrom had annotations of its own: the subannotations were kept but the main stack trace in copyFrom was discarded. In practice you usually want to keep all of copyFrom; if for some reason you just want to keep annotations, please do so explicitly using ErrorManager.findAnnotations(Throwable) and ErrorManager.attachAnnotations(Throwable, ErrorManager.Annotation[]).
org.openide.ServiceType.clone()	Service instance files should instead be copied in order to clone them.
org.openide.ServiceType.createClone()	Service instance files should instead be copied in order to clone them.
org.openide.ServiceType.Registry.find(Class)	Just use lookup.
org.openide.ServiceType.Registry.setServiceTypes(List)	Better to change service instance files instead.
org.openide.util.actions.CallbackSystemAction.getActionPerformer()	use TopComponent.getActionMap() as described in the javadoc
org.openide.util.actions.CallbackSystemAction.performAction()	This only uses ActionPerformer. Use CallbackSystemAction.actionPerformed(ActionEvent) instead.
org.openide.util.actions.CallbackSystemAction.setActionPerformer(ActionPerformer)	use TopComponent.getActionMap() as described in the javadoc
org.openide.util.actions.SystemAction.createPopupMenu(SystemAction[])	Use Utilities.actionsToPopup(Action[], Lookup)
org.openide.util.NetworkSettings.getKeyForAuthenticationPassword(URI)	use NetworkSettings.getAuthenticationPassword(java.net.URI) instead
org.openide.util.Utilities.arrayHashCode(Object[])	Use Arrays.hashCode(Object[]) instead.
org.openide.util.Utilities.getScreenSize()	this method is almost useless in multiple monitor configuration
org.openide.util.Utilities.icon2Image(Icon)	Use ImageUtilities.icon2Image(Icon).
org.openide.util.Utilities.isLargeFrameIcons()	Obsolete, useless method, no replacement.
org.openide.util.Utilities.loadImage(String)	Use ImageUtilities.loadImage(java.lang.String).
org.openide.util.Utilities.loadImage(String, boolean)	Use ImageUtilities.loadImage(java.lang.String, boolean).
org.openide.util.Utilities.mergeImages(Image, Image, int, int)	Use ImageUtilities.mergeImages(Image, Image, int, int).
org.openide.util.Utilities.partialSort(List, Comparator, boolean)	Deprecated in favor of the potentially much faster (and possibly more correct) Utilities.topologicalSort(Collection, Map).
org.openide.util.Utilities.replaceString(String, String, String)	Use String.replace(CharSequence,CharSequence) instead
org.openide.util.Utilities.showJFileChooser(JFileChooser, Component, String)	Not needed in JDK 1.4.
org.openide.util.Utilities.toFile(URL)	Use URL.toURI() and Utilities.toFile(URI) instead under JDK 1.4. (There was no proper equivalent under JDK 1.3.)
org.openide.util.Utilities.toURL(File)	Use Utilities.toURI(File) and URI.toURL() instead under JDK 1.4. (File.toURL() is buggy in JDK 1.3 and the bugs are not fixed in JDK 1.4.)
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

Deprecated Constructors

Constructor	Description
org.openide.util.HelpCtx(Class<?>)	Too easily breaks IDs after code refactoring. Rather use HelpCtx(String) with a constant value known to be in the JavaHelp map.
org.openide.util.HelpCtx(URL)	Does not work nicely with JavaHelp.