Java 如何将程序中的注释提取出来生成说明文档

第一种方法:

可以使用JavaDoc工具。它可以从程序源码中将类、方法、成员变量等文档注释抽取出来形成一个与源代码配套的API帮助文档。但是在编写代码时要以一定的规范做注释才可以。通过JavaDoc实现工具就可以同时生成代码的开发文档了。JavaDoc工具位于 C:\Program Files\Java\jdk1.6.0_10\bin 路径下。

其中/**...*/这种注释用于支持JavaDoc工具,还有一些以@开头的标识信息也可以抽取出来,如下图。

这里使用源码中StringBuffer.java 文件为例。

打开控制台窗口,首先进入StringBuffer.java的目录,这里放在c盘test目录下。

执行javadoc StringBuffer.java

如下图

如果报无法找到命令,请确认安装JDK时是否配置了环境变量。

生成的文件如下。

打开文件就会看到类似于Java API样式的说明文档。

第二种方式:

借助eclipse实现。

在项目列表中按右键,选择Export,然后在Export对话框中选择java下的javadoc,下一步。在Javadoc Generation对话框中:javadoc command:应该选择jdk bin 目录下的javadoc.exedestination:为生成文档的保存路径。finish提交即可开始生成文档。

 欢迎访问我的博客

时间: 2024-11-05 21:42:52

Java 如何将程序中的注释提取出来生成说明文档的相关文章

分享JAVA从初级程序员到架构师视频,文档,架构设计,大型网站架构分析,大数据分析资料

JAVA从初级程序员到架构师视频,文档,架构设计,大型网站架构分析,大数据分析资料, 搭建高并发.高可用电商架构设计资料需要的联系我.很多目录都没列出来(QQ空间相册里有很多目录的截图)加QQ:1927360914

MVC在Java Web应用程序中的实现

一.MVC简介 MVC全名是Model View Controller,是模型(model)-视图(view)-控制器(controller)的缩写,一种软件设计典范,用一种业务逻辑.数据.界面显示分离的方法组织代码,将业务逻辑聚集到一个部件里面,在改进和个性化定制界面及用户交互的同时,不需要重新编写业务逻辑. Model(模型)是应用程序中用于处理应用程序数据逻辑的部分. 通常模型对象负责在数据库中存取数据. View(视图)是应用程序中处理数据显示的部分. 通常视图是依据模型数据创建的. C

MVC模式在Java Web应用程序中的实现

MVC简介 MVC全名是Model View Controller,是模型(model)-视图(view)-控制器(controller)的缩写,一种软件设计典范,用一种业务逻辑.数据.界面显示分离的方法组织代码,将业务逻辑聚集到一个部件里面,在改进和个性化定制界面及用户交互的同时,不需要重新编写业务逻辑.MVC被独特的发展起来用于映射传统的输入.处理和输出功能在一个逻辑的图形化用户界面的结构中. MVC 是一种使用 MVC(Model View Controller 模型-视图-控制器)设计创

MVC模式在Java Web应用程序中的实例分析

MVC作为软件架构中及其重要的一种架构思想,在实际的java web项目开发中被开发者们广泛的应用.遵循MVC思想的所产生的解决方法也可以因实际情况的不同来进行不同的选择.这里以一个应用struts+hibernate+jsp的实例来进一步认识MVC. 学生管理系统中添加学生模块的的MVC架构: Model(系统的业务逻辑):Hibernate进行管理的数据实体+定义的业务逻辑的体现--------数据库操作类,也就是通常所说的Dao层 数据实体(PO,Entity): package PO;

【腾讯GAD暑期训练营游戏程序班】游戏场景管理作业说明文档

场景管理作业说明文档                              用了八叉树的算法,测出三层时最快,区域范围内物体数量为21块,控制台打印出的结果如图所示: 场景物体:游戏中,所有具有空间属性的物体游戏场景:<围棋>二维表<进击的围棋><围棋世界>基于空间分组的场景管理的进一步优化进一步分组四叉树视锥范围剔除非可见区域当前必要场景区域 动态加载谷歌 可感知即存在 不可感知即不存在 场景加载

倍福TwinCAT(贝福Beckhoff)常见问题(FAQ)-如何在程序中添加注释

在TwinCAT2中,(*中间输入注释*),也可以用这种方法批量注释,在TwinCAT3中,使用//即可 ? ? 更多教学视频和资料下载,欢迎关注以下信息: 我的优酷空间: http://i.youku.com/acetaohai123 ? 我的在线论坛: http://csrobot.gz01.bdysite.com/ ? 问题交流: QQ:910358960 邮箱:[email protected] ? ?

JAVA基础----应用程序中如何新开一个线程

通过继承Thread新开线程 将类声明为 Thread 的子类.该子类应重写 Thread 类的 run 方法.接下来可以分配并启动该子类的实例.例如,计算大于某一规定值的质数的线程可以写成: class PrimeThread extends Thread { long minPrime; PrimeThread(long minPrime) { this.minPrime = minPrime; } public void run() { // compute primes larger t

MVC模式在Java Web应用程序中的实例

1.可用性 使用SimpleMappingExceptionResolver实现异常处理 只需要在Spring的配置文件applicationContext.xml中增加以下内容: <bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">        <property name="defaultErrorView" value=&q

将程序中的表格,导出生成excel表格。使用Aspose插件实现

http://www.cnblogs.com/lanyue52011/p/3372452.html这个是原文地址 /// <summary> /// 点击按钮,将内存表导出excel表格! /// </summary> /// <param name="sender"></param> /// <param name="e"></param> protected void Button1_Cli