「推奨されない」とは *

あるメソッドが重要とみなされなくなったためにクラスから削除される可能性があるので使用すべきではないとき、そのメソッドは推奨されません。こうしたことが起きるのは、クラスに変更が加えられていくと、メソッド名が変更されたり、新しいメソッドが追加されたり、属性が変更されるなど、そのクラスの API が変更されるためです。新しい API への移行を促すため、推奨されないクラスおよびメソッドのマニュアル (API ドキュメント) には、コメントとして「@deprecated」という印が付けられています。次の表に、推奨されないメソッドの一覧を示します。

表 4-1 推奨されないメソッド

クラス	メソッド	推奨するメソッドまたは代替法
java.awt.BorderLayout	addLayoutComponent()	addLayoutComponent(component,object)
java.awt.CardLayout	addLayoutComponent()	addLayoutComponent(component,object)
java.awt.CheckboxGroup	getCurrent()	getSelectedCheckbox()
	setCurrent()	setSelectedCheckbox()
java.awt.Choice	countItems()	getItemCount()
java.awt.Component	getPeer()
	enable()	setEnabled(true)
	disable()	setEnabled(false)
	show()	setVisible(true)
	hide()	setVisible(false)
	location()	getLocation()
	move()	setLocation()
	size()	getSize()
	resize()	setSize()
	bounds()	getBounds()
	reshape()	setBounds()
	preferredSize()	getPreferredSize()
	minimumSize()	getMinimumSize()
	layout()	doLayout()
	inside()	contains()
	locate()	getComponentAt()
	deliverEvent()	dispatchEvent()
	postEvent()	dispatchEvent()
	handleEvent()	processEvent()
	mouseDown()	processMouseEvent()
	mouseDrag()	processMouseMotionEvent()
	mouseUp()	processMouseEvent(MouseEvent)
	mouseMove()	processMouseMotionEvent()
	mouseEnter()	processMouseEvent()
	mouseExit()	processMouseEvent()
	keyDown()	processKeyEvent()
	keyUp()	processKeyEvent()
	action()	コンポーネント破棄アクションイベントに対する ActionListener として登録してください。
	gotFocus()	processFocusEvent()
	lostFocus()	processFocusEvent()
	nextFocus()	transferFocus()
java.awt.Container	countComponents()	getComponentCount()
	insets()	getInsets()
	preferredSize()	getPreferredSize()
	minimumSize()	getMinimumSize()
	deliverEvent()	dispatchEvent()
	locate()	getComponentAt()

表 4-2 推奨されないメソッド

クラス	メソッド	推奨するメソッドまたは代替法
java.awt.FontMetrics	getMaxDescent()	getMaxDescent()
java.awt.Frame	setCursor()	Component 中の setCursor() メソッド
	getCursorType()	Component 中の getCursor() メソッド
java.awt.Graphics	getClipRect()	getClipBounds()
java.awt.List	countItems()	getItemCount()
	clear()	removeAll()
	isSelected()	isIndexSelected()
	allowsMultipleSelections()	isMultipleMode()
	setMultipleSelections()	setMultipleMode()
	preferredSize()	getPreferredSize()
	minimumSize()	getMinimumSize()
	delItems()	public としては使用しないでください。package private 用に残されています。
java.awt.Menu	countItems()	getItemCount()
java.awt.MenuBar	countMenus()	getMenuCount()
java.awt.MenuComponents	getPeer()
	postEvent()	dispatchEvent()
java.awt.MenuContainer	postEvent()	dispatchEvent()
java.awt.MenuItem	enable()	setEnabled(true)
	disable()	setEnabled(false)
java.awt.Polygon	getBoundingBox()	getBounds()
	inside()	contains()
java.awt.Rectangle	reshape()	setBounds()
	move()	setLocation()
	resize()	setSize()
	inside()	contains()
java.awt.ScrollPane	layout()	doLayout()
java.awt.Scrollbar	getVisible()	getVisibleAmount()
	setLineIncrement()	setUnitIncrement()
	getLineIncrement()	getUnitIncrement()
	setPageIncrement()	setBlockIncrement()
	getPageIncrement()	getBlockIncrement()
java.awt.TextArea	insertText()	insert()
	appendText()	append()
	replaceText()	replaceRange()
	preferredSize()	getPreferredSize()
	minimumSize()	getMinimumSize()
java.awt.TextField	setEchoCharacter()	setEchoChar()
	preferredSize()	getPreferredSize()
	minimumSize()	getMinimumSize()
java.awt.Window	postEvent()	dispatchEvent()
java.io.ByteArrayOutputStream	toString()	toString(String enc) または toString()。これらは、プラットフォームのデフォルトの文字コードを使用します。
java.io.DataInputStream	readLine()	BufferedReader.readLine()
java.io.PrintStream	printStream()	PrintWriter class
java.io.StreamTokenizer	streamTokenizer()	入力ストリームを文字ストリームに変換してください。
java.lang.Character	isJavaLetter()	isJavaIdentifierStart(char)
	isJavaLetterOrDigit()	isJavaIdentifierPart(char)
	isSpace()	isWhitespace(char)
java.lang.ClassLoader	defineClass()	defineClass(java.lang.String,byte[],int,int)
java.lang.Runtime	getLocalizedInputStream()	InputStreamReader および BufferedReader クラス
	getLocalizedOutputStream()	OutputStreamWriter、BufferedWriter、PrintWriter クラスを使用してください

表 4-3 推奨されないメソッド

クラス	メソッド	推奨するメソッドまたは代替法
java.lang.String	string()	文字コード名を取得するかまたはデフォルトの文字コードを使用する、String コンストラクタを使用してください。
	getBytes()	getBytes(String enc)または getBytes()
java.lang.System	getenv()	java.lang.System.getProperty メソッドのシステムプロパティおよび Boolean, Integer, または Long プリミティブ型の対応する get TypeName メソッドを使用してください。
java.lang.Thread	resume()	「推奨されないスレッドメソッド」 を参照。
java.lang.Thread	stop()	「推奨されないスレッドメソッド」 を参照。
java.lang.Thread	suspend()	「推奨されないスレッドメソッド」 を参照。
java.util.Date	getYear()	Calendar.get(Calendar.YEAR)-1900
	setYear()	Calendar.set(Calendar.YEAR+1900)
	getMonth()	Calendar.get(Calendar.MONTH)
	setMonth()	Calendar.set(Calendar.MONTH,int month)
	getDate()	Calendar.get(Calendar.DAY_OF_MONTH)
	setDate()	Calendar.set(Calendar.DAY_OF_MONTH, int date)
	getDay()	Calendar.get(Calendar.DAY_OF_WEEK)
	getHours()	Calendar.get(Calendar.HOUR_OF_DAY)
	setHours()	Calendar.set(Calendar.HOUR_OF_DAY,int hours)
	getMinutes()	Calendar.get(Calendar.MINUTE)
	setMinutes()	Calendar.set(Calendar.MINUTE,int minutes)
	getSeconds()	Calendar.get(Calendar.SECOND)
	setSeconds()	Calendar.set(Calendar.SECOND,int seconds)
	parse()	DateFormat.parse(String s)
	getTimezoneOffset()	Calendar.get(Calendar.ZONE_OFFSET)+ Calendar.get(Calendar.DST_OFFSET)
	toLocaleString()	DateFormat.format(Date date)
	toGMTString()	DateFormat.format(Date date) (GMT タイムゾーンを使用)
	UTC()	Calendar.set(year+1900,month,date,hrs, min,sec) または GregorianCalendar(year+1900,month, date,hrs,min,sec) (UTC タイムゾーンを使用)、その後に Calendar.getTime().getTime()