Deprecated API

Contents

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

Deprecated Interfaces

java.security.Certificate
A new certificate handling package is created in the Java 2 platform. This Certificate interface is entirely deprecated and is here to allow for a smooth transition to the new package.

sun.net.www.protocol.http.HttpAuthenticator
-- use java.net.Authenticator instead

com.sun.util.PTimerWentOffListener

Deprecated Classes

java.security.Identity
This class is no longer used. Its functionality has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.

java.security.IdentityScope
This class is no longer used. Its functionality has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.

com.sun.util.PTimer
This class is kept for backwards compatiability with Personal Java. The java.util.Timer class is the preferred way of implementing timers under the Personal Profile.

com.sun.util.PTimerWentOffEvent

sun.misc.Ref
This class has been replaced by java.util.SoftReference.

java.security.Signer
This class is no longer used. Its functionality has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.

Deprecated Fields

sun.net.ftp.FtpClient.ftpProxyHost

sun.net.ftp.FtpClient.ftpProxyPort

sun.security.x509.X509Key.key
Use the BitArray form which does not require keys to be byte aligned.

java.awt.datatransfer.DataFlavor.plainTextFlavor
as of 1.3. Use DataFlavor.getReaderForText( Transferable) instead of Transferable. getTransferData(DataFlavor.plainTextFlavor).

sun.net.www.http.HttpClient.proxyHost

sun.net.www.http.HttpClient.proxyPort

sun.net.ftp.FtpClient.useFtpProxy

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.BorderLayout.addLayoutComponent(String, Component)
replaced by addLayoutComponent(Component, Object).

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

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.checkMulticast(InetAddress, byte)
Use #checkPermission(java.security.Permission) 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.List.countItems()
As of JDK version 1.1, replaced by getItemCount().

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.MenuBar.countMenus()
As of JDK version 1.1, replaced by getMenuCount().

java.net.URLDecoder.decode(String)
The resulting string may vary depending on the platform's default encoding. Instead, use the decode(String,String) method to specify the encoding.

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.Container.deliverEvent(Event)
As of JDK version 1.1, replaced by dispatchEvent(AWTEvent e)

java.awt.Component.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).

sun.security.x509.X500Name.emit(DerOutputStream)
Use encode() instead

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.net.URLEncoder.encode(String)
The resulting string may vary depending on the platform's default encoding. Instead, use the encode(String,String) method to specify the encoding.

sun.security.provider.DSA.engineGetParameter(String)

sun.security.provider.DSA.engineSetParameter(String, Object)

sun.security.util.ObjectIdentifier.equals(ObjectIdentifier)
Use equals((Object)oid)

sun.security.x509.AlgorithmId.getAlgorithmId(String)
use the short get form of this method.

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

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.awt.Scrollbar.getLineIncrement()
As of JDK version 1.1, replaced by getUnitIncrement().

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

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

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

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.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.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.awt.Component.inside(int, int)
As of JDK version 1.1, replaced by contains(int, int).

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

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.Container.layout()
As of JDK version 1.1, replaced by doLayout().

java.awt.Component.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.Container.locate(int, int)
As of JDK version 1.1, replaced by getComponentAt(int, int).

java.awt.Component.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).

sun.applet.AppletViewer.main(String[])

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

java.awt.Component.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.TextArea.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.List.minimumSize(int)
As of JDK version 1.1, replaced by getMinimumSize(int).

java.awt.TextField.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.Rectangle.move(int, int)
As of JDK version 1.1, replaced by setLocation(int, int).

java.awt.Component.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.datatransfer.DataFlavor.normalizeMimeType(String)

java.awt.datatransfer.DataFlavor.normalizeMimeTypeParameter(String, String)

java.awt.MenuContainer.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.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.Container.preferredSize()
As of JDK version 1.1, replaced by getPreferredSize().

java.awt.Component.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.TextArea.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.List.preferredSize(int)
As of JDK version 1.1, replaced by getPreferredSize(int).

java.awt.TextField.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).

sun.net.www.http.HttpClient.resetProperties()
-- system properties are no longer cached.

java.awt.Rectangle.reshape(int, int, int, int)
As of JDK version 1.1, replaced by setBounds(int, int, 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.Component.resize(Dimension)
As of JDK version 1.1, replaced by setSize(Dimension).

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

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

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 the Java 2 platform v1.2, the preferred way to save a properties list is via the store(OutputStream out, String header) method.

com.sun.util.PTimer.schedule(PTimerSpec)
since Personal Java Spec 1.2, replaced by the new PTimer.scheduleTimerSpec(com.sun.util.PTimerSpec) method.

java.net.MulticastSocket.send(DatagramPacket, byte)
Use the following code or its equivalent instead: ...... int ttl = mcastSocket.getTimeToLive(); mcastSocket.setTimeToLive(newttl); mcastSocket.send(p); mcastSocket.setTimeToLive(ttl); ......

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.awt.TextField.setEchoCharacter(char)
As of JDK version 1.1, replaced by setEchoChar(char).

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

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.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().

sun.net.www.http.HttpClient.writeRequests(MessageHeader)

Deprecated Constructors

sun.security.x509.AlgorithmId()
use one of the other constructors.