Deprecatedとは : JavaA2Z

Deprecated

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

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

参考サイト

javadoc @deprecated

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

// 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()
    {
    }
}