J2SE1.5 注释语法

温小俞

温小俞

2016-01-29 12:52

J2SE1.5 注释语法,J2SE1.5 注释语法
  说起注解语法,对于任何一个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(){
  }

  使用标签最终是为了帮助开发人员提取注释信息,然后根据不同需求做进一步处理,下面我们来看看如何获取注释信息。

  =============================================================================
  import java.lang.annotation.Annotation;
  import tiger.annotation.MyTag;
  public class TagTest{

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

  public static void main(String[] args){
  TagTest tt = new TagTest();
  try {
  Annotation[] annotation =tt.getClass().getMethod("test").getAnnotations();
  for (Annotation tag :annotation) {
  System.out.println("Tag is:" + tag);
  System.out.
展开更多 50%)
分享

猜你喜欢

J2SE1.5 注释语法

Java JAVA基础
J2SE1.5 注释语法

“老虎”来了 J2SE1.5新功能一览

编程语言 网络编程
“老虎”来了 J2SE1.5新功能一览

s8lol主宰符文怎么配

英雄联盟 网络游戏
s8lol主宰符文怎么配

用J2SE1.5建立多任务的Java应用程序2

编程语言 网络编程
用J2SE1.5建立多任务的Java应用程序2

用J2SE1.5建立多任务的Java应用程序

编程语言 网络编程
用J2SE1.5建立多任务的Java应用程序

lol偷钱流符文搭配推荐

英雄联盟 网络游戏
lol偷钱流符文搭配推荐

Eclipse3.1中体验J2SE5.0之注释类型

编程语言 网络编程
Eclipse3.1中体验J2SE5.0之注释类型

ASP语法注释

Web开发
ASP语法注释

lolAD刺客新符文搭配推荐

英雄联盟
lolAD刺客新符文搭配推荐

Java语言的接口与类型安全

Java语言的接口与类型安全

as入门之数学函数--Math类

as入门之数学函数--Math类
下拉加载更多内容 ↓