<b>J2SE 1.5的注释语法</b>[Java编程]

说起注解语法,关于任何一个Java开辟人员来说都已经耳熟能详了,我们每天都在利用着 @author, @param,等等编写注释,然后用javadoc生成文档.Java的这种便利的文档生成办法遭到了开辟者的广泛赞誉.而从JDK1.5开始,注释语法供应了更为强盛的功效.

我们先谈谈注释语法本身,它有时刻也称为meta-data :“描写数据的数据” .普通来说它们可以被用来生成文档,查抄代码间依靠关系,帮忙编译器作语法查抄.时下对比风行的工具有Xdoclet等.关于文档生成早已经有了javadoc工具的完善表现,而关于代码查抄,目前java也供应了语言级的支持.

我们知道,javadoc是通过提取java源文件中的标签信息来生成文档.所以要学习新的注释语法,们首先要熟习的就是新增的标签.新的注释语法支持两种标签,系统尺度标签和用户自定义标签.标签的标记也原先一样,@标记加上标签名字.我们先从JDK1.5自带的尺度标签说起.

首先介绍@override , 也不用多罗嗦,顾名思义了,就是用来阐明办法覆载的.我们假定有一个子类必必要覆载父类的办法.

public class Parent{
public void foo(){
System.out.println("Original Implementation of foo");
}
}
public class Child extends Parent{
@Override
public void foo(){
System.out.println("Overide Implementation of foo");
}
}

目前为止我们看不出来这个@Override给我们带来了任何好处,所以我们先说说加个这个标签后,我们用javac编译的时刻编译器履行了些什么呢?编译器会查抄这个办法,然后从父类查找能否有这个办法,不然就编译出错.这个特点可以帮忙我们避免一些初级错误.上面这个例子,子类想覆载foo()办法,不过你大概一时忽视把它写成了fob(), 关于这样的”初级错误”,假如你没有在前期就发现的话,到系统集成测试的时刻,大概会化上你几个小时乃至一两天去找出这样的bug.目前好了,编译器在编译的时刻就会给出错误,

Child.java:3: method does not override a method from its superclass
@Override
^
1 error

怎么样,这个功效还不错吧.

看过了尺度标签的利用办法,我们来看看用户自定义标签.首先介绍@interface, 它用于定义新的注释范例（annotation type）.新建一个注释范例看起来和定义一Interface 没有什么两样,MyTag.java用于新建一个用户自定义标签,代码以下,

package tiger.annotation;
/**
* 用户自定义标签??MyTag
*/
public @interface MyTag { }
定义了一个tag之后,我们便可以在任何java文件中利用这个tag了,
import tiger.annotation.MyTag;
public class TagTest{
@MyTag
public void testTag(){
}
}

注释范例还可以有成员变量,

package tiger.annotation;
/**
* 用户自定义标签??带有成员变量的MyTag
*/
public @interface MyTag {
String name();
int age();
}

然后我们可以这么利用这个标签,

@MyTag(name="MyTag",age=1)
public void testTag(){
}

　　以上是“<b>J2SE 1.5的注释语法</b>[Java编程]”的内容，如果你对以上该文章内容感兴趣，你可以看看七道奇为您推荐以下文章：