@Deprecated & @Override

原创 2016年08月28日 17:09:43

1. @Deprecated” code should not be used

级别:cwe, obsolete, owasp-a9, security

Once deprecated, classes, and interfaces, and their members should be avoided, rather than used, inherited or extended. Deprecation is a warning that the class or interface has been superseded, and will eventually be removed. The deprecation period allows you to make a smooth transition away from the aging, soon-to-be-retired technology.

Noncompliant Code Example

/**
 * @deprecated  As of release 1.3, replaced by {@link #Fee}
 */@Deprecated
class Fum { ... }

public class Bar extends Fum {  // Noncompliant; Fum is deprecated

  public void myMethod() {
    Foo foo = new Foo();  // okay; the class isn't deprecated
    foo.doTheThing();  // Noncompliant
  }
}

不应该在程序中使用@Deprecated标注的接口、类和方法,该注解表明此功能已被废弃,之所以还存在是为了向前兼容,使用废弃的功能容易引起安全问题。

2. “@Override” annotation should be used on any method overriding (since Java 5) or implementing (since Java 6) another one

级别:bad-practice

Using the @Override annotation is useful for two reasons :
1. It elicits a warning from the compiler if the annotated method doesn’t actually override anything, as in the case of a misspelling.
2. It improves the readability of the source code by making it obvious that methods are overridden.

Noncompliant Code Example

class ParentClass {
  public boolean doSomething(){...}
}
class FirstChildClass extends ParentClass {
  public boolean doSomething(){...}  // Noncompliant
}

Compliant Solution

class ParentClass {
  public boolean doSomething(){...}
}
class FirstChildClass extends ParentClass {
  @Override
  public boolean doSomething(){...}  // Compliant
}

当重写父类的方法或实现接口中的方法时,应该在方法上标注@Override,一方面,这能提醒编译器如果由于拼写错误,这个方法在父类或接口中不存在,编译器能给出警告。另一方面,@Override注解能提高代码的可读性。

相关文章推荐

JAVA学习10_@Override、@Deprecated和@SuppressWarnings注释说明

J2SE5中的最新注释功能SuppressWarnings 一、什么是注释      说起注释,得先提一提什么是元数据(metadata)。所谓元数据就是数据的数据。也就是说,元数据是描述...

JAVA 注解:SuppressWarnings、Deprecated、Override

为了是大家初步了解什么是注解(Annotation),我们先来看如下代码:  相关代码一:  Java代码   public class AnnotationTest {  ...

java 注解:SuppressWarnings、Deprecated、Override

为了是大家初步了解什么是注解(Annotation),我们先来看如下代码: 相关代码一: public class AnnotationTest { public static void mai...

Annotation – @Deprecated @Override @SuppressWarnings

JDK5.0 引入了一种新的元语言工具,叫“annotation”。 Annotation 提供的信息不是程序的一部分,例如,代码片断的作者,或者告诉编译器忽略特定的错误等。Annotation不会对...

Java注释Override、Deprecated、SuppressWarnings详解

一、什么是注释     说起注释,得先提一提什么是元数据(metadata)。所谓元数据就是数据的数据。也就是说,元数据是描述数据的。就象数据表中的字段一样,每个字段描述了这个字段下的数据的含...

Java中的注解/注释详解(Override/Deprecated/SuppressWarning)

Java中的注解/注释详解 Java中的注释主要有以下三种:Override/Deprecated/SuppressWarning,接下来我们主要讨论这3个注解的内容。 一,什么是注释(注解) ...

Java.lang注释之 Override、Deprecated和SuppressWarnings

一、什么是注释     说起注释,得先提一提什么是元数据(metadata)。所谓元数据就是数据的数据。也就是说,元数据是描述数据的。就象数据表中的字段一样,每个字段描述了这个字段下的数据的含...

初步了解什么是注解 (Annotation) Override Deprecated SuppressWarnings 自定义注解

java 注解 实战剖析 为了是大家初步了解什么是注解(Annotation),我们先来看如下代码: 相关代码一: public class AnnotationTest { public st...

deprecated-list.html

  • 2012年10月24日 13:57
  • 145KB
  • 下载
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:@Deprecated & @Override
举报原因:
原因补充:

(最多只允许输入30个字)