@Deprecated注解的使用

合集 - Java注解(11)

1.JavaSE基础：@Target元注解的使用2019-01-132.JavaSE基础：掌握Java注解2019-01-083.JavaSE基础：@Retention元注解的使用2019-01-144.JavaSE基础：@Override预定义注解的使用2019-01-175.JavaSE基础：@Inherited元注解的使用2019-01-156.JavaSE基础：@Document元注解的使用2019-01-127.JavaSE基础：@Repeatable元注解的使用2019-01-168.JavaSE基础：@SuppressWarnings注解的使用2019-01-189.JavaSE基础：@SafeVarargs注解的使用2019-01-1910.JavaSE基础：@FunctionalInterface注解的使用2019-01-21

11.@Deprecated注解的使用2019-01-22

收起

被注解@Deprecated标记的程序元素是不鼓励使用的程序元素，通常是因为它很危险，或者是因为存在更好的替代方案。

除了对象自身引用自己用@Deprecated标记的方法外，其他情况使用@Deprecated注解标记的类型，方法，字段或构造函数时，Java编译器都会生成deprecation警告。

先看看@Override注解在Java SE中的声明：

package java.lang;

import java.lang.annotation.*;
import static java.lang.annotation.ElementType.*;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}

由Java源代码声明我们了解到：@Deprecated注解，可以应用在很多地方，包括构造函数、字段、本地变量、方法、包、参数和类。

在一个元素被弃用时，也应使用Javadoc @deprecated标记对其进行记录，如以下示例所示。 在Javadoc注释和注解中使用@符并非巧合：它们在概念上是相关的。 另请注意，Javadoc标记以小写d开头，注解以大写D开头。

package org.springmorning.demo.javabase.annotation.pre;

import java.util.Date;

/**
 * @author 编程老司机
 */
public class DeprecatedAnnotation {

    /**
     * @deprecated
     * 此方法使用了java.util.Date中弃用的Date(String s)构造函数
     *
     * @param date 日期  格式为（YYYYMMDD）
     * @return Date字符串格式
     */
    @Deprecated
    public String convertDate(String date){
        return new Date(date).toString();
    }
}

 Java API中有很多地方都使用了@Deprecated注解，例如像上例中使用的java.util.Date类中的方法：

public Date(String s)

大家可以轻易在Java API中找到示例，我这里就不赘述。

 

 

 

如果您觉得博文不错，请用微信扫描右上方二维码，关注我的微信公众号“编程老司机”，获取最新推送文章。