Deprecated API

Deprecated Classes

java.io.LineNumberInputStream
This class incorrectly assumes that bytes adequately represent characters. As of JDK 1.1, the preferred way to operate on character streams is via the new character-stream classes, which include a class for counting line numbers.

java.io.StringBufferInputStream
This class does not properly convert characters into bytes. As of JDK 1.1, the preferred way to create a stream from a string is via the StringReader class.

Deprecated Fields

java.awt.Frame.CROSSHAIR_CURSOR
replaced by Cursor.CROSSHAIR_CURSOR.

java.awt.Frame.DEFAULT_CURSOR
replaced by Cursor.DEFAULT_CURSOR.

java.awt.Frame.E_RESIZE_CURSOR
replaced by Cursor.E_RESIZE_CURSOR.

java.awt.Frame.HAND_CURSOR
replaced by Cursor.HAND_CURSOR.

java.lang.SecurityManager.inCheck
This type of security checking is not recommended. It is recommended that the checkPermission call be used instead.

java.awt.Frame.MOVE_CURSOR
replaced by Cursor.MOVE_CURSOR.

java.awt.Frame.N_RESIZE_CURSOR
replaced by Cursor.N_RESIZE_CURSOR.

java.awt.Frame.NE_RESIZE_CURSOR
replaced by Cursor.NE_RESIZE_CURSOR.

java.awt.Frame.NW_RESIZE_CURSOR
replaced by Cursor.NW_RESIZE_CURSOR.

java.awt.Frame.S_RESIZE_CURSOR
replaced by Cursor.S_RESIZE_CURSOR.

java.awt.Frame.SE_RESIZE_CURSOR
replaced by Cursor.SE_RESIZE_CURSOR.

java.awt.Frame.SW_RESIZE_CURSOR
replaced by Cursor.SW_RESIZE_CURSOR.

java.awt.Frame.TEXT_CURSOR
replaced by Cursor.TEXT_CURSOR.

java.awt.Frame.W_RESIZE_CURSOR
replaced by Cursor.W_RESIZE_CURSOR.

java.awt.Frame.WAIT_CURSOR
replaced by Cursor.WAIT_CURSOR.

Deprecated Methods

java.awt.Component.action(Event, Object)
As of JDK version 1.1, should register this component as ActionListener on component which fires action events.

java.awt.List.addItem(String)
replaced by add(String).

java.awt.List.addItem(String, int)
replaced by add(String, int).

java.awt.CardLayout.addLayoutComponent(String, Component)
replaced by addLayoutComponent(Component, Object).

java.awt.BorderLayout.addLayoutComponent(String, Component)
replaced by addLayoutComponent(Component, Object).

java.awt.List.allowsMultipleSelections()
As of JDK version 1.1, replaced by isMultipleMode().

java.lang.ThreadGroup.allowThreadSuspension(boolean)
The definition of this call depends on ThreadGroup.suspend(), which is deprecated. Further, the behavior of this call was never specified.

java.awt.TextArea.appendText(String)
As of JDK version 1.1, replaced by append(String).

java.awt.Component.bounds()
As of JDK version 1.1, replaced by getBounds().

java.lang.SecurityManager.classDepth(String)
This type of security checking is not recommended. It is recommended that the checkPermission call be used instead.

java.lang.SecurityManager.classLoaderDepth()
This type of security checking is not recommended. It is recommended that the checkPermission call be used instead.

java.awt.List.clear()
As of JDK version 1.1, replaced by removeAll().

java.awt.Container.countComponents()
As of JDK version 1.1, replaced by getComponentCount().

java.awt.Choice.countItems()
As of JDK version 1.1, replaced by getItemCount().

java.awt.Menu.countItems()
As of JDK version 1.1, replaced by getItemCount().

java.awt.List.countItems()
As of JDK version 1.1, replaced by getItemCount().

java.awt.MenuBar.countMenus()
As of JDK version 1.1, replaced by getMenuCount().

java.lang.Thread.countStackFrames()
The definition of this call depends on Thread.suspend(), which is deprecated. Further, the results of this call were never well-defined.

java.lang.SecurityManager.currentClassLoader()
This type of security checking is not recommended. It is recommended that the checkPermission call be used instead.

java.lang.SecurityManager.currentLoadedClass()
This type of security checking is not recommended. It is recommended that the checkPermission call be used instead.

java.lang.ClassLoader.defineClass(byte[], int, int)
Replaced by defineClass(java.lang.String, byte[], int, int)

java.awt.List.delItem(int)
replaced by remove(String) and remove(int).

java.awt.List.delItems(int, int)
As of JDK version 1.1, Not for public use in the future. This method is expected to be retained only as a package private method.

java.awt.Component.deliverEvent(Event)
As of JDK version 1.1, replaced by dispatchEvent(AWTEvent e).

java.awt.Container.deliverEvent(Event)
As of JDK version 1.1, replaced by dispatchEvent(AWTEvent e)

java.awt.Component.disable()
As of JDK version 1.1, replaced by setEnabled(boolean).

java.awt.MenuItem.disable()
As of JDK version 1.1, replaced by setEnabled(boolean).

java.awt.Component.enable()
As of JDK version 1.1, replaced by setEnabled(boolean).

java.awt.MenuItem.enable()
As of JDK version 1.1, replaced by setEnabled(boolean).

java.awt.Component.enable(boolean)
As of JDK version 1.1, replaced by setEnabled(boolean).

java.awt.MenuItem.enable(boolean)
As of JDK version 1.1, replaced by setEnabled(boolean).

java.awt.Polygon.getBoundingBox()
As of JDK version 1.1, replaced by getBounds().

java.lang.String.getBytes(int, int, byte[], int)
This method does not properly convert characters into bytes. As of JDK 1.1, the preferred way to do this is via the getBytes(String enc) method, which takes a character-encoding name, or the getBytes() method, which uses the platform's default encoding.

java.awt.Graphics.getClipRect()
As of JDK version 1.1, replaced by getClipBounds().

java.awt.CheckboxGroup.getCurrent()
As of JDK version 1.1, replaced by getSelectedCheckbox().

java.awt.Frame.getCursorType()
As of JDK version 1.1, replaced by Component.getCursor().

java.util.Date.getDate()
As of JDK version 1.1, replaced by Calendar.get(Calendar.DAY_OF_MONTH).

java.util.Date.getDay()
As of JDK version 1.1, replaced by Calendar.get(Calendar.DAY_OF_WEEK).

java.lang.System.getenv(String)
The preferred way to extract system-dependent information is the system properties of the java.lang.System.getProperty methods and the corresponding getTypeName methods of the Boolean, Integer, and Long primitive types. For example:

     String classPath = System.getProperty("java.class.path",".");
 

     if (Boolean.getBoolean("myapp.exper.mode"))
         enableExpertCommands();
 

java.awt.Toolkit.getFontList()
see GraphicsEnvironment.getAvailableFontFamilyNames()

java.awt.Toolkit.getFontMetrics(Font)
This returns integer metrics for the default screen.

java.awt.Toolkit.getFontPeer(String, int)
see java.awt.GraphicsEnvironment#getAllFonts

java.util.Date.getHours()
As of JDK version 1.1, replaced by Calendar.get(Calendar.HOUR_OF_DAY).

java.lang.SecurityManager.getInCheck()
This type of security checking is not recommended. It is recommended that the checkPermission call be used instead.

java.awt.Scrollbar.getLineIncrement()
As of JDK version 1.1, replaced by getUnitIncrement().

java.lang.Runtime.getLocalizedInputStream(InputStream)
As of JDK 1.1, the preferred way translate a byte stream in the local encoding into a character stream in Unicode is via the InputStreamReader and BufferedReader classes.

java.lang.Runtime.getLocalizedOutputStream(OutputStream)
As of JDK 1.1, the preferred way to translate a Unicode character stream into a byte stream in the local encoding is via the OutputStreamWriter, BufferedWriter, and PrintWriter classes.

java.awt.FontMetrics.getMaxDecent()
As of JDK version 1.1.1, replaced by getMaxDescent().

java.util.Date.getMinutes()
As of JDK version 1.1, replaced by Calendar.get(Calendar.MINUTE).

java.util.Date.getMonth()
As of JDK version 1.1, replaced by Calendar.get(Calendar.MONTH).

java.awt.Scrollbar.getPageIncrement()
As of JDK version 1.1, replaced by getBlockIncrement().

java.awt.Component.getPeer()
As of JDK version 1.1, programs should not directly manipulate peers. replaced by boolean isDisplayable().

java.awt.MenuComponent.getPeer()
As of JDK version 1.1, programs should not directly manipulate peers.

java.awt.Font.getPeer()
Font rendering is now platform independent.

java.util.Date.getSeconds()
As of JDK version 1.1, replaced by Calendar.get(Calendar.SECOND).

java.util.Date.getTimezoneOffset()
As of JDK version 1.1, replaced by Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET).

java.awt.Scrollbar.getVisible()
As of JDK version 1.1, replaced by getVisibleAmount().

java.util.Date.getYear()
As of JDK version 1.1, replaced by Calendar.get(Calendar.YEAR) - 1900.

java.awt.Component.gotFocus(Event, Object)
As of JDK version 1.1, replaced by processFocusEvent(FocusEvent).

java.awt.Component.handleEvent(Event)
As of JDK version 1.1 replaced by processEvent(AWTEvent).

java.awt.Component.hide()
As of JDK version 1.1, replaced by setVisible(boolean).

java.lang.SecurityManager.inClass(String)
This type of security checking is not recommended. It is recommended that the checkPermission call be used instead.

java.lang.SecurityManager.inClassLoader()
This type of security checking is not recommended. It is recommended that the checkPermission call be used instead.

java.awt.TextArea.insertText(String, int)
As of JDK version 1.1, replaced by insert(String, int).

java.awt.Container.insets()
As of JDK version 1.1, replaced by getInsets().

java.awt.Component.inside(int, int)
As of JDK version 1.1, replaced by contains(int, int).

java.awt.Polygon.inside(int, int)
As of JDK version 1.1, replaced by contains(int, int).

java.awt.Rectangle.inside(int, int)
As of JDK version 1.1, replaced by contains(int, int).

java.lang.Character.isJavaLetter(char)
Replaced by isJavaIdentifierStart(char).

java.lang.Character.isJavaLetterOrDigit(char)
Replaced by isJavaIdentifierPart(char).

java.awt.List.isSelected(int)
As of JDK version 1.1, replaced by isIndexSelected(int).

java.lang.Character.isSpace(char)
Replaced by isWhitespace(char).

java.awt.Component.keyDown(Event, int)
As of JDK version 1.1, replaced by processKeyEvent(KeyEvent).

java.awt.Component.keyUp(Event, int)
As of JDK version 1.1, replaced by processKeyEvent(KeyEvent).

java.awt.Component.layout()
As of JDK version 1.1, replaced by doLayout().

java.awt.Container.layout()
As of JDK version 1.1, replaced by doLayout().

java.awt.ScrollPane.layout()
As of JDK version 1.1, replaced by doLayout().

java.awt.Component.locate(int, int)
As of JDK version 1.1, replaced by getComponentAt(int, int).

java.awt.Container.locate(int, int)
As of JDK version 1.1, replaced by getComponentAt(int, int).

java.awt.Component.location()
As of JDK version 1.1, replaced by getLocation().

java.awt.Component.lostFocus(Event, Object)
As of JDK version 1.1, replaced by processFocusEvent(FocusEvent).

java.awt.Component.minimumSize()
As of JDK version 1.1, replaced by getMinimumSize().

java.awt.Container.minimumSize()
As of JDK version 1.1, replaced by getMinimumSize().

java.awt.TextField.minimumSize()
As of JDK version 1.1, replaced by getMinimumSize().

java.awt.TextArea.minimumSize()
As of JDK version 1.1, replaced by getMinimumSize().

java.awt.List.minimumSize()
As of JDK version 1.1, replaced by getMinimumSize().

java.awt.TextField.minimumSize(int)
As of JDK version 1.1, replaced by getMinimumSize(int).

java.awt.List.minimumSize(int)
As of JDK version 1.1, replaced by getMinimumSize(int).

java.awt.TextArea.minimumSize(int, int)
As of JDK version 1.1, replaced by getMinimumSize(int, int).

java.awt.Component.mouseDown(Event, int, int)
As of JDK version 1.1, replaced by processMouseEvent(MouseEvent).

java.awt.Component.mouseDrag(Event, int, int)
As of JDK version 1.1, replaced by processMouseMotionEvent(MouseEvent).

java.awt.Component.mouseEnter(Event, int, int)
As of JDK version 1.1, replaced by processMouseEvent(MouseEvent).

java.awt.Component.mouseExit(Event, int, int)
As of JDK version 1.1, replaced by processMouseEvent(MouseEvent).

java.awt.Component.mouseMove(Event, int, int)
As of JDK version 1.1, replaced by processMouseMotionEvent(MouseEvent).

java.awt.Component.mouseUp(Event, int, int)
As of JDK version 1.1, replaced by processMouseEvent(MouseEvent).

java.awt.Component.move(int, int)
As of JDK version 1.1, replaced by setLocation(int, int).

java.awt.Rectangle.move(int, int)
As of JDK version 1.1, replaced by setLocation(int, int).

java.awt.Component.nextFocus()
As of JDK version 1.1, replaced by transferFocus().

java.awt.Container.nextFocus(Component)
As of JDK version 1.1, replaced by transferFocus(Component).

java.awt.Window.nextFocus(Component)
As of JDK version 1.1, replaced by transferFocus(Component).

java.util.Date.parse(String)
As of JDK version 1.1, replaced by DateFormat.parse(String s).

java.awt.Component.postEvent(Event)
As of JDK version 1.1, replaced by dispatchEvent(AWTEvent).

java.awt.MenuComponent.postEvent(Event)
As of JDK version 1.1, replaced by dispatchEvent(AWTEvent).

java.awt.Window.postEvent(Event)
As of JDK version 1.1 replaced by dispatchEvent(AWTEvent).

java.awt.MenuContainer.postEvent(Event)
As of JDK version 1.1 replaced by dispatchEvent(AWTEvent).

java.awt.Component.preferredSize()
As of JDK version 1.1, replaced by getPreferredSize().

java.awt.Container.preferredSize()
As of JDK version 1.1, replaced by getPreferredSize().

java.awt.TextField.preferredSize()
As of JDK version 1.1, replaced by getPreferredSize().

java.awt.TextArea.preferredSize()
As of JDK version 1.1, replaced by getPreferredSize().

java.awt.List.preferredSize()
As of JDK version 1.1, replaced by getPreferredSize().

java.awt.TextField.preferredSize(int)
As of JDK version 1.1, replaced by getPreferredSize(int).

java.awt.List.preferredSize(int)
As of JDK version 1.1, replaced by getPreferredSize(int).

java.awt.TextArea.preferredSize(int, int)
As of JDK version 1.1, replaced by getPreferredSize(int, int).

java.io.DataInputStream.readLine()
This method does not properly convert bytes to characters. As of JDK 1.1, the preferred way to read lines of text is via the BufferedReader.readLine() method. Programs that use the DataInputStream class to read lines can be converted to use the BufferedReader class by replacing code of the form:

     DataInputStream d = new DataInputStream(in);
 

with:

     BufferedReader d
          = new BufferedReader(new InputStreamReader(in));
 

java.io.ObjectInputStream.readLine()
This method does not properly convert bytes to characters. see DataInputStream for the details and alternatives.

java.awt.TextArea.replaceText(String, int, int)
As of JDK version 1.1, replaced by replaceRange(String, int, int).

java.awt.Component.reshape(int, int, int, int)
As of JDK version 1.1, replaced by setBounds(int, int, int, int).

java.awt.Rectangle.reshape(int, int, int, int)
As of JDK version 1.1, replaced by setBounds(int, int, int, int).

java.awt.Component.resize(Dimension)
As of JDK version 1.1, replaced by setSize(Dimension).

java.awt.Component.resize(int, int)
As of JDK version 1.1, replaced by setSize(int, int).

java.awt.Rectangle.resize(int, int)
As of JDK version 1.1, replaced by setSize(int, int).

java.lang.Thread.resume()
This method exists solely for use with Thread.suspend(), which has been deprecated because it is deadlock-prone. For more information, see Why are Thread.stop, Thread.suspend and Thread.resume Deprecated?.

java.lang.ThreadGroup.resume()
This method is used solely in conjunction with Thread.suspend and ThreadGroup.suspend, both of which have been deprecated, as they are inherently deadlock-prone. See Thread.suspend() for details.

java.lang.Runtime.runFinalizersOnExit(boolean)
This method is inherently unsafe. It may result in finalizers being called on live objects while other threads are concurrently manipulating those objects, resulting in erratic behavior or deadlock.

java.lang.System.runFinalizersOnExit(boolean)
This method is inherently unsafe. It may result in finalizers being called on live objects while other threads are concurrently manipulating those objects, resulting in erratic behavior or deadlock.

java.util.Properties.save(OutputStream, String)
This method does not throw an IOException if an I/O error occurs while saving the property list. As of JDK 1.2, the preferred way to save a properties list is via the store(OutputStream out, String header) method.

java.awt.CheckboxGroup.setCurrent(Checkbox)
As of JDK version 1.1, replaced by setSelectedCheckbox(Checkbox).

java.awt.Frame.setCursor(int)
As of JDK version 1.1, replaced by Component.setCursor(Cursor).

java.util.Date.setDate(int)
As of JDK version 1.1, replaced by Calendar.set(Calendar.DAY_OF_MONTH, int date).

java.awt.TextField.setEchoCharacter(char)
As of JDK version 1.1, replaced by setEchoChar(char).

java.util.Date.setHours(int)
As of JDK version 1.1, replaced by Calendar.set(Calendar.HOUR_OF_DAY, int hours).

java.awt.Scrollbar.setLineIncrement(int)
As of JDK version 1.1, replaced by setUnitIncrement(int).

java.util.Date.setMinutes(int)
As of JDK version 1.1, replaced by Calendar.set(Calendar.MINUTE, int minutes).

java.util.Date.setMonth(int)
As of JDK version 1.1, replaced by Calendar.set(Calendar.MONTH, int month).

java.awt.List.setMultipleSelections(boolean)
As of JDK version 1.1, replaced by setMultipleMode(boolean).

java.awt.Scrollbar.setPageIncrement(int)
As of JDK version 1.1, replaced by setBlockIncrement().

java.util.Date.setSeconds(int)
As of JDK version 1.1, replaced by Calendar.set(Calendar.SECOND, int seconds).

java.util.Date.setYear(int)
As of JDK version 1.1, replaced by Calendar.set(Calendar.YEAR, year + 1900).

java.awt.Component.show()
As of JDK version 1.1, replaced by setVisible(boolean).

java.awt.Component.show(boolean)
As of JDK version 1.1, replaced by setVisible(boolean).

java.awt.Component.size()
As of JDK version 1.1, replaced by getSize().

java.lang.Thread.stop()
This method is inherently unsafe. Stopping a thread with Thread.stop causes it to unlock all of the monitors that it has locked (as a natural consequence of the unchecked ThreadDeath exception propagating up the stack). If any of the objects previously protected by these monitors were in an inconsistent state, the damaged objects become visible to other threads, potentially resulting in arbitrary behavior. Many uses of stop should be replaced by code that simply modifies some variable to indicate that the target thread should stop running. The target thread should check this variable regularly, and return from its run method in an orderly fashion if the variable indicates that it is to stop running. If the target thread waits for long periods (on a condition variable, for example), the interrupt method should be used to interrupt the wait. For more information, see Why are Thread.stop, Thread.suspend and Thread.resume Deprecated?.

java.lang.ThreadGroup.stop()
This method is inherently unsafe. See Thread.stop() for details.

java.lang.Thread.stop(Throwable)
This method is inherently unsafe. See Thread.stop() (with no arguments) for details. An additional danger of this method is that it may be used to generate exceptions that the target thread is unprepared to handle (including checked exceptions that the thread could not possibly throw, were it not for this method). For more information, see Why are Thread.stop, Thread.suspend and Thread.resume Deprecated?.

java.lang.Thread.suspend()
This method has been deprecated, as it is inherently deadlock-prone. If the target thread holds a lock on the monitor protecting a critical system resource when it is suspended, no thread can access this resource until the target thread is resumed. If the thread that would resume the target thread attempts to lock this monitor prior to calling resume, deadlock results. Such deadlocks typically manifest themselves as "frozen" processes. For more information, see Why are Thread.stop, Thread.suspend and Thread.resume Deprecated?.

java.lang.ThreadGroup.suspend()
This method is inherently deadlock-prone. See Thread.suspend() for details.

java.util.Date.toGMTString()
As of JDK version 1.1, replaced by DateFormat.format(Date date), using a GMT TimeZone.

java.util.Date.toLocaleString()
As of JDK version 1.1, replaced by DateFormat.format(Date date).

java.io.ByteArrayOutputStream.toString(int)
This method does not properly convert bytes into characters. As of JDK 1.1, the preferred way to do this is via the toString(String enc) method, which takes an encoding-name argument, or the toString() method, which uses the platform's default character encoding.

java.util.Date.UTC(int, int, int, int, int, int)
As of JDK version 1.1, replaced by Calendar.set(year + 1900, month, date, hrs, min, sec) or GregorianCalendar(year + 1900, month, date, hrs, min, sec), using a UTC TimeZone, followed by Calendar.getTime().getTime().

Deprecated Constructors

java.util.Date(int, int, int)
As of JDK version 1.1, replaced by Calendar.set(year + 1900, month, date) or GregorianCalendar(year + 1900, month, date).

java.util.Date(int, int, int, int, int)
As of JDK version 1.1, replaced by Calendar.set(year + 1900, month, date, hrs, min) or GregorianCalendar(year + 1900, month, date, hrs, min).

java.util.Date(int, int, int, int, int, int)
As of JDK version 1.1, replaced by Calendar.set(year + 1900, month, date, hrs, min, sec) or GregorianCalendar(year + 1900, month, date, hrs, min, sec).

java.util.Date(String)
As of JDK version 1.1, replaced by DateFormat.parse(String s).

java.io.StreamTokenizer(InputStream)
As of JDK version 1.1, the preferred way to tokenize an input stream is to convert it into a character stream, for example:

   Reader r = new BufferedReader(new InputStreamReader(is));
   StreamTokenizer st = new StreamTokenizer(r);
 

java.lang.String(byte[], int)
This method does not properly convert bytes into characters. As of JDK 1.1, the preferred way to do this is via the String constructors that take a character-encoding name or that use the platform's default encoding.

java.lang.String(byte[], int, int, int)
This method does not properly convert bytes into characters. As of JDK 1.1, the preferred way to do this is via the String constructors that take a character-encoding name or that use the platform's default encoding.