JavaA2Z

KAB-studio > プログラミング > JavaA2Z > Deprecatedとは

Deprecated

日本語 推奨されていません
英語 deprecated
ふりがな でぷりけーてっど
フリガナ デプリケーテッド

解説

使わない方がよいクラスメソッドフィールドの警告文。
J2SE APIリファレンス等に記述されているおきまりの文句。この警告が付いているクラスメソッドは、使用することは可能だが、コンパイル時に警告が出力される。
クラスメソッドドキュメンテーションコメント内に、Javadoc@deprecatedタグを使用することで出力することができる。
ただし、日本のロケールで出力した場合には「推奨されていません」と出力される。

参考サイト


(KAB-studioからのおしらせです)

サンプルプログラム(とか)サンプルを別ウィンドウで表示サンプルをクリップボードへコピー(WindowsでIEの場合のみ)

// Sample.java
import java.util.Date;

public class Sample
{
    public static void main( String[] args )
    {
        // 「推奨されていません」なメソッドを使用します。
        Date date = new Date( 2004, 0, 1 );
        // コンパイル時の警告:
        // コンストラクター Date(int, int, int) は使用すべきではありません。
        // でも使用することは可能。

        // 自分が作ったクラスやそのメソッドを「推奨されていません」に
        // する場合には、クラスやメソッドのドキュメンテーションコメント内に
        // @deprecatedタグを加えます。
        DeprecatedClass deprecatedClass = new DeprecatedClass();
        // 警告:
        // 型 DeprecatedClass は使用すべきではありません。

        deprecatedClass.deprecatedMethod();
        // 警告:
        // メソッド deprecatedMethod() は型 DeprecatedClass で使用すべきではありません。

        // 注:基本的に、自クラスのメソッドに@deprecatedタグを付けて
        //     使用しても警告は出ません。これは、@deprecatedタグの
        //     「印」がクラスファイルに付けられるためで、コンパイル時には
        //     参照されないからです。
    }
}


// DeprecatedClass.java

/**
*   使用を推奨しないクラス。
*   @deprecated このクラスは使わないでください。
*/
public class DeprecatedClass
{
    /**
    *   使用を推奨しないメソッド。
    *   @deprecated このメソッドは使用しないでください。
    */
    public void deprecatedMethod()
    {
    }
}
// Sample.java
import java.util.Date;

public class Sample
{
    public static void main( String[] args )
    {
        // 「推奨されていません」なメソッドを使用します。
        Date date = new Date( 2004, 0, 1 );
        // コンパイル時の警告:
        // コンストラクター Date(int, int, int) は使用すべきではありません。
        // でも使用することは可能。

        // 自分が作ったクラスやそのメソッドを「推奨されていません」に
        // する場合には、クラスやメソッドのドキュメンテーションコメント内に
        // @deprecatedタグを加えます。
        DeprecatedClass deprecatedClass = new DeprecatedClass();
        // 警告:
        // 型 DeprecatedClass は使用すべきではありません。

        deprecatedClass.deprecatedMethod();
        // 警告:
        // メソッド deprecatedMethod() は型 DeprecatedClass で使用すべきではありません。

        // 注:基本的に、自クラスのメソッドに@deprecatedタグを付けて
        //     使用しても警告は出ません。これは、@deprecatedタグの
        //     「印」がクラスファイルに付けられるためで、コンパイル時には
        //     参照されないからです。
    }
}


// DeprecatedClass.java

/**
*   使用を推奨しないクラス。
*   @deprecated このクラスは使わないでください。
*/
public class DeprecatedClass
{
    /**
    *   使用を推奨しないメソッド。
    *   @deprecated このメソッドは使用しないでください。
    */
    public void deprecatedMethod()
    {
    }
}

この単語を含むページ

「みだし」に含まれているページ

「解説」に含まれているページ

「サンプルプログラムとか」に含まれているページ

はてなブックマーク 詳細を表示 はてなブックマーク ブックマーク数
livedoorクリップ 詳細を表示 livedoorクリップ ブックマーク数
Yahoo!ブックマーク 詳細を表示 users
del.icio.us 登録する RSSに登録
サンプルを別ウィンドウで表示
サンプルをクリップボードへコピー(WindowsでIEの場合のみ)
update:2005/07/23
このページは、Javaプログラミング言語についての用語を網羅した辞書「JavaA2Z」の一ページです。
詳しくは「JavaA2Z」表紙の説明をご覧ください。