Deprecated API

Contents

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

Deprecated Interfaces

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

Deprecated Classes

Class and Description
org.openide.util.actions.BooleanStateAction Use new support for stateful actions in Actions or ActionState annotation
org.openide.util.Queue Use BlockingQueue instead.
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.

Deprecated Exceptions

Exceptions and Description
org.openide.util.Utilities.UnorderableException Used only by the deprecated partialSort

Deprecated Fields

Field and 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 and Description
org.openide.util.Utilities.arrayHashCode(Object[]) Use Arrays.hashCode(Object[]) instead.
org.openide.ServiceType.clone() Service instance files should instead be copied in order to clone them.
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(java.lang.Throwable) and ErrorManager.attachAnnotations(java.lang.Throwable, org.openide.ErrorManager.Annotation[]).
org.openide.ServiceType.createClone() Service instance files should instead be copied in order to clone them.
org.openide.util.actions.SystemAction.createPopupMenu(SystemAction[]) Use Utilities.actionsToPopup(javax.swing.Action[], org.openide.util.Lookup)
org.openide.ServiceType.Registry.find(Class) Just use lookup.
org.openide.util.actions.CallbackSystemAction.getActionPerformer() use TopComponent.getActionMap() as described in the javadoc
org.openide.util.NetworkSettings.getKeyForAuthenticationPassword(URI) use NetworkSettings.getAuthenticationPassword(java.net.URI) instead
org.openide.util.Utilities.getScreenSize() this method is almost useless in multiple monitor configuration
org.openide.util.Utilities.icon2Image(Icon) Use ImageUtilities.icon2Image(javax.swing.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(java.awt.Image, java.awt.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(java.util.Collection<? extends T>, java.util.Map<? super T, ? extends java.util.Collection<? extends T>>).
org.openide.util.actions.CallbackSystemAction.performAction() This only uses ActionPerformer. Use CallbackSystemAction.actionPerformed(java.awt.event.ActionEvent) instead.
org.openide.util.Utilities.replaceString(String, String, String) Use String.replace(CharSequence,CharSequence) instead
org.openide.util.actions.CallbackSystemAction.setActionPerformer(ActionPerformer) use TopComponent.getActionMap() as described in the javadoc
org.openide.ServiceType.Registry.setServiceTypes(List) Better to change service instance files 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(java.io.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 and Description
org.openide.util.HelpCtx(Class<?>) Too easily breaks IDs after code refactoring. Rather use HelpCtx.HelpCtx(String) with a constant value known to be in the JavaHelp map.
org.openide.util.HelpCtx(URL) Does not work nicely with JavaHelp.