Java 注释规范是 Java 编程语言中的一种重要的编码规范,它提供了一种有效的方式来描述代码,以便其他开发人员可以更好地理解和使用代码。
Java 注释分为三类:单行注释、多行注释和文档注释。单行注释是最常用的注释形式,它以“//”开头,后面可以加上任意文字来说明代码的作用。多行注释是一个块性的注释,它以“
Java API定义了许多标准注释类型。
以下部分讨论了在java.lang包中定义的四种最常用的标准注释。
弃用的注释类型是标记注释类型。它标记了已弃用的代码元素。
使用已弃用的程序元素将导致编译器生成警告。
@Deprecate class MyClass { private MyClass() { } public static MyClass getInstance() { MyClass dt = new MyClass(); return dt; } } public class Main { public static void main(String[] args) { MyClass dt; // Generates a compile-time note } }
重写注释类型是只能在方法上使用的标记注释类型。
它表示方法重写在其超类中声明的方法。
如果我们要覆盖超类中的一个方法,建议使用@Override注释注释覆盖的方法。
编译器将确保注释的方法真正覆盖超类中的一个方法。
如果注释的方法不覆盖超类中的方法,编译器将生成错误。
class A { public void m1() { } } class B extends A { @Override public void m1() { } }
SuppressWarnings用于抑制命名的编译器警告。它声明一个名为value的元素,其数据类型是一个String数组。
import java.util.ArrayList; public class Main { @SuppressWarnings("unchecked") public void test() { @SuppressWarnings("rawtypes") ArrayList list = new ArrayList(); list.add("Hello"); // The compiler issues an unchecked warning } }
具有一个抽象方法声明的接口被称为功能接口。
如果使用此注释注释的接口不是函数接口,则会生成编译时错误。
@FunctionalInterface interface MyThread{ void run(); }
只有一个抽象方法的接口是一个功能接口,不管它是否用@FunctionalInterface注释注释。
要注释一个Java包,创建一个名为package-info.java的文件,并将注释包声明放在其中。
以下代码显示了package-info.java文件的内容。
// package-info.java @Version(major=1, minor=0) package com..annotation;
Java面向对象设计 -Java接口什么是接口?Java中的接口定义了一个引用类型来创建抽象概念。接口由类实现以提供概念的实现。在Java...
Java面向对象设计 -Java接口实现实现接口接口指定对象必须提供的协议。类可以提供接口的抽象方法的部分实现,并且在这种情况下,...
Java面向对象设计 -Java异常抛出如果一段代码可能抛出一个已检查的异常,我们有两个选择:使用try-catch块处理已检查的异常。在方...
Java数据类型教程 -Java数据类型包装器Java库在java.lang包中提供了八个类来表示八种基本类型中的每一种。这些类称为包装类,因...
Java数据类型教程 -Java字符串创建/长度创建字符串对象String类包含许多可用于创建String对象的构造函数。默认构造函数创建一个...