首页 > 代码库 > java中注解的使用方法

java中注解的使用方法

java中注解用“@”表示,注解的常用功能有三个:

      1、生成文档。这是最常见的,也是java 最早提供的注解。

      2、跟踪代码依赖性,实现替代配置文件功能。

      3、在编译时进行格式检查。

一、生成javadoc

      javadoc是Sun公司提供的一个技术,它从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。也就是说,只要在编写程序时以一套特定的标签作注释,在程序编写完成后,通过Javadoc就可以同时形成程序的开发文档了。

      javadoc命令是用来生成自己API文档的,使用方式:在java源文件中写入相应的注释,使用命令行在源文件所在目录输入javadoc +文件名.java即可,常用的java开发工具都有生成javadoc的功能。

二、替代配置文件

      java中的配置信息设置有两种方式:

     非注解形式,即指在配置文件中配置相关参数,使实体类、参数各方面分离。
     注解方式,即annotation方式,是jdk提供的一种注入或配置方式。即将实体类与相关参数都在一起,只是通过@annotation的方式,使之联合在一起,除形式不一样外,其它的都一样。

     注解(Annotation )就是将一些标注的信息,写在java文件中,实际上servlet以前在web.xml中注册(配置mapping等等),现在servlet也可以采用注解的方式,将配置直接写在servlet类之上。采用注解的好处就是:不需要单独一个一个的在外部文件中增加配置信息了,如果采用注解方式,当你写完一个类(包括注解部分),那这个类的配置也就写完了,不需要反复于配置文件和类的编写。采用注解的坏处是:1、让一些配置信息写在java代码中,导致代码比较混乱,2、因为注解是写在java文件中的,所以如果给你的项目是通过注解实现的,而且给你的项目不是源码,那么你是没有办法修改配置信息的,除非反编译。

三、在编译时进行检查

     例如Override注解指明被注解的方法需要覆写超类中的方法。看这样一段代码

     public class Test_Override {
     @Override
           public String toString() {
                return super.toString() + "测试使用 ‘Override‘ 注解";
           }
     }

     如果因为“toString”拼写错误导致该方法未能重写父类中的方法,那么就会报错。

java中注解的使用方法