Summary

Deprecate obsolete classes and methods in javax.swing.plaf.basic.

Problem

Some of the methods in several classes in javax.swing.plaf.basic are obsolete. Also some classes exist only for backward compatibility. Applications need to be informed that they should no longer be used.

Solution

Deprecate these obsolete classes and methods in javax.swing.plaf.basic.

Specification

src/java.desktop/share/classes/javax/swing/plaf/basic/BasicDirectoryModel.java

     /**
-     * Obsolete - not used.
+     * Obsolete - not used. This method is a no-op.
      * @param e list data event
+     * @deprecated Obsolete method, not used anymore.
      */
+    @Deprecated(since = "17")
     public void intervalAdded(ListDataEvent e) {
     }

     /**
 -     * Obsolete - not used.
+     * Obsolete - not used. This method is a no-op.
      * @param e list data event
+     * @deprecated Obsolete method, not used anymore.
      */
+    @Deprecated(since = "17")
     public void intervalRemoved(ListDataEvent e) {
     }



+     * @deprecated Obsolete method, not used anymore.
      */
+    @Deprecated(since = "17")
     protected boolean lt(File a, File b) {

src/java.desktop/share/classes/javax/swing/plaf/basic/BasicMenuItemUI.java

-    /** Mouse input handler */
+    /**
+     * Mouse input handler.
+     * This class exists only for backward compatibility.
+     * All its functionality has been moved into Handler.
+     * @deprecated
+     */
+    @Deprecated(since = "17")
     protected class MouseInputHandler implements MouseInputListener {

src/java.desktop/share/classes/javax/swing/plaf/basic/BasicScrollPaneUI.java

         /**
      * Listener for viewport events.
+     * This class exists only for backward compatibility.
+     * All its functionality has been moved into Handler.
+     * @deprecated
      */
+    @Deprecated(since = "17")
     public class ViewportChangeHandler implements ChangeListener

26,7 +530,11 @@ protected ChangeListener createViewportChangeListener() {

     /**
      * Horizontal scrollbar listener.
+     * This class exists only for backward compatibility.
+     * All its functionality has been moved into Handler.
+     * @deprecated
      */
+    @Deprecated(since = "17")
     public class HSBChangeListener implements ChangeListener
     {
         /**
@@ -565,7 +573,11 @@ protected ChangeListener createHSBChangeListener() {

     /**
      * Vertical scrollbar listener.
+     * This class exists only for backward compatibility.
+     * All its functionality has been moved into Handler.
+     * @deprecated
      */
+    @Deprecated(since = "17")
     public class VSBChangeListener implements ChangeListener


     /**
      * Property change handler.
+     * This class exists only for backward compatibility.
+     * All its functionality has been moved into Handler.
+     * @deprecated
      */
+    @Deprecated(since = "17")
     public class PropertyChangeHandler implements PropertyChangeListener

src/java.desktop/share/classes/javax/swing/plaf/basic/BasicToolBarUI.java

+     * @deprecated It is recommended that {@link BasicToolBarUI#createFloatingWindow(JToolBar)}
+     *             be used instead
      */
+    @Deprecated(since = "17")
     protected JFrame createFloatingFrame(JToolBar toolbar) {