文档介绍：java开发注释规范规范javadoc是j2sdk里面一个非常重要的工具,如果你按照规范在java的源代码里面写好注释的话,那么它就可以生成相应的文档。开发者察看起来会非常方便。很多IDE都可以直接生成javadoc的,这里介绍如何写javadoc以及如何在eclipse下生成javadoc。javadoc通常从package、公开类或者接口、公开或者受保护的字段、公开或者受保护的方法提取信息。每条注释应该是以/**开始以*/结尾。例如/*******@paramidthecoreIDoftheperson****@paramuserNamethenameoftheperson*youshouldusetheconstructortocreateapersonobject*/publicSecondClass(intid,StringuserName){=id;=userName;}注释应该写在要说明部分的前面,如上所示。并且在其中可以包括html的标记,如果上面没有标记的话,那么youshouldusrthe......将会在javadoc里面紧跟***@paramuserName....,这样不是我们希望的。一般注释可以分为类注释、方法注释、字段注释等。下面分别作简单的介绍类注释类注释应该在import语句的后面在类声明的前面,.;/******@authorming**thisinterfaceistodefineamethodprint()*youshouldimplementsthisinterfaceisyouwanttoprinttheusername****@.#main(String[])*/publicinterfaceDoSomething{/******@paramnamewhichwillbeprinted****@returnnothingwillbereturned**/publicvoidprint(Stringname);}其中***@author和***@see都是常用的注释第一个表示作者,第二个表示参考的连接。,你可以在其中使用***@******@******@throws等标签。例如/*******@parami****@returntrueif.....elsefalse****@throwsIOExceptionwhenreadingthesomethingwronghappened*thenthemethodwillthrowsaIOException*/publicbooleandoMethod(inti)throwsIOException{returntrue;},通常是static德,例如/***thestaticfiledhello*/publicstaticinthello=1;在eclipse中我们新建javaproject然后编写几个接口和类以后就可以用javadoc生成文档了,从菜单project选择generatejavadoc,会出现一个向导,你按照他的提示一步一步的设定要求,,如果选择生成的话,