JAVA 文档注释,类的说明,HTML说明文档的生成
2015-06-05 16:05
549 查看
有的时候,我们会写一些类,编译成.class文件,给别人使用,那么,别人不知道这个类有哪些方法,如何调用。
所以我们需要做一个类的说明文档。
可以采用在.java类里面进行注释,通过注释来生成类的说明文档的方法。
一、.java中注释的写法:
Test1.java
ps:
注释采用/**开始,用*/结尾
@author 作者
@version 版本
@param arr 传入的值 (arr是方法参数名称,是什么参数名,这里填写什么,后面“传入的值”,这几个字是参数名的说明)
@return 返回的值 (返回什么填写什么,前面,“返回的值”这几个字是返回值的说明)
注意:此类要写public 否则无法生成说明文档
二、在dos中采用以下命令生成说明文档
javadoc -d Mydoc1 -author -version Test1.java
ps:
1、以上命令Mydoc1是生成后的文件保存目录
2、-author是生成作者
3、-version是生成版本号
三、生成后的说明文档文件结构截图:
生成后,保存的文件是网页文件.html的,双击index.html即可用浏览器打开查看
查看效果截图:
在这个说明文档中,有构造函数的说明,如果我们需要取消,只需要把构造函数定义为私有的,就可以了,代码如下:
转载自: http://www.cnblogs.com/phpyangbo/p/java-class-shuomingwendang.html
所以我们需要做一个类的说明文档。
可以采用在.java类里面进行注释,通过注释来生成类的说明文档的方法。
一、.java中注释的写法:
Test1.java
/* 文档注释 */ /** 此类是对数组进行取最值,排序等操作的 @author 张三 @version 1.0 */ public class Test1{ /** 取Int数组里面的最大值 @param arr 传入一个int数组 @return 返回一个Int数值 */ public static int max(int[] arr){ int j = arr[0]; for(int i=0;i<arr.length;i++){ if(j<arr[i]){ j = arr[i]; } } return j; } /** 取Int数组里面的最小值 @param arr 传入一个int数组 @return 返回一个Int数值 */ public static int x(int[] arr){ int j = arr[0]; for(int i=0;i<arr.length;i++){ if(j>arr[i]){ j = arr[i]; } } return j; } }
ps:
注释采用/**开始,用*/结尾
@author 作者
@version 版本
@param arr 传入的值 (arr是方法参数名称,是什么参数名,这里填写什么,后面“传入的值”,这几个字是参数名的说明)
@return 返回的值 (返回什么填写什么,前面,“返回的值”这几个字是返回值的说明)
注意:此类要写public 否则无法生成说明文档
二、在dos中采用以下命令生成说明文档
javadoc -d Mydoc1 -author -version Test1.java
ps:
1、以上命令Mydoc1是生成后的文件保存目录
2、-author是生成作者
3、-version是生成版本号
三、生成后的说明文档文件结构截图:
生成后,保存的文件是网页文件.html的,双击index.html即可用浏览器打开查看
查看效果截图:
在这个说明文档中,有构造函数的说明,如果我们需要取消,只需要把构造函数定义为私有的,就可以了,代码如下:
/* 文档注释 */ /** 此类是对数组进行取最值,排序等操作的 @author 张三 @version 1.0 @addDate 2015-05-31 */ public class Test1{ private Test1(){ } /** 取Int数组里面的最大值 @param arr 传入一个int数组 @return 返回一个Int数值 */ public static int max(int[] arr){ int j = arr[0]; for(int i=0;i<arr.length;i++){ if(j<arr[i]){ j = arr[i]; } } return j; } /** 取Int数组里面的最小值 @param arr 传入一个int数组 @return 返回一个Int数值 */ public static int x(int[] arr){ int j = arr[0]; for(int i=0;i<arr.length;i++){ if(j>arr[i]){ j = arr[i]; } } return j; } }
转载自: http://www.cnblogs.com/phpyangbo/p/java-class-shuomingwendang.html
相关文章推荐
- 枚举类型的单例模式(java)
- 【Java23种设计模式学习笔记】一:策略模式
- java_notes_static、final、内部类、代码块
- eclipse调试的方法和技巧
- Spring实例化相关问题
- 关于springmvc引用json配置会报错的问题
- 扩展SpringMVC以支持更精准的数据绑定
- java三种排序比较
- 扩展SpringMVC以支持绑定JSON格式的请求参数
- Spring中引入properties文件
- JAVASE学习笔记:第七章 常用类Lang包之包装类
- JVM中java对象的生命周期
- LeetCode_20---Valid Parentheses
- (转)Spring实例化
- eclipse
- 用Struts2写的第一个"Hello,World!"
- atitit.spring3 mvc url配置最佳实践
- SpringMVC学习(一)
- JAVA设计模式之单例模式
- Struts2高危漏洞分析和解决方案