如何导出java程序intellij_Intellij IDEA如何生成JavaDoc

JavaDoc是一种将注释生成HTML文档的技术。

1、使用javadoc命令生成文档

首先了解一下javadoc指令的用法

用法: javadoc [options] [packagenames] [sourcefiles] [@files]

cd450d189ad8c6c538c21e89187e9204.png

使用指令生成文档,这里的java文件的编码是utf-8,所以要带上编码选项 -encoding utf-8

指令 javadoc -encoding utf-8 Fish.java

d27f27ef8f15efe169fcbc9f07e82906.png

打开index.html文件

fa6d86fbfe3ee44001e39211e2490897.png

100cfc05959ce7d8f6a79fb17322b8bc.png

使用eclipse生成文档

选中java文件,右键选择Export,进入Export界面,选Java-Javadoc

510f2a2aaf8a01fde28d323cae26c7d9.png

点击Next,选中目录

e8218daae13111dd0810f1f4ba907756.png

两次一直选择Next,配置VM options指定源文件编码为 -encoding utf-8 , 点击Finsh

d7238067147902c8df3274a6320e63db.png

查看生成文档过程的信息与文档

fa170c5420efd4ea14651eaf3edbffbd.png

7a0252a72f6bc8cfd3ec68d89e25b3e3.png

3、 Intellij Idea生成JavaDoc

JavaDoc是一种将注释生成HTML文档的技术,生成的HTML文档类似于Java的API,易读且清晰明了。在简略介绍JavaDoc写法之后,再看一下在Intellij Idea 中如何将代码中的注释生成HTML文档。

先看一段样例代码:

48304ba5e6f9fe08f3fa1abda7d326ab.png

1 //: object/Documentation

2 /** 这是一个Javadoc测试程序

3 * @author Mike

4 * @version 1.0

5 * @since 1.5

6 * */

7 public class Documentation {

8 /**这是一个成员变量

9 * */

10 public String name;

11 /** a function

12 * @param name 姓名

13 * @return 返回name姓名

14 * @throws Exception 无异常抛出

15 * */

16 public String function(String name) throws Exception{

17 return name;

18 }

19 }///:~

48304ba5e6f9fe08f3fa1abda7d326ab.png

稍微解释一下:

以//: 开始,以///:~结束。

@author  作者名

@version 版本号

@since 指明需要最早使用的jdk版本

@param 参数名

@return 返回值情况

@throws 异常抛出情况

idea生成HTML文档的方法:

第一步:

e5e5afe466842f78100db34279fa7cfb.png

第二步:

a37eb965f232439046e59c5a6fa94d77.png

1. 选择是整个项目还是模块还是单个文件

2. 文档输出路径

3. Locale 选择地区,这个决定了文档的语言,中文就是zh_CN

4. 传入JavaDoc的参数,一般这样写 -encoding UTF-8 -charset UTF-8 -windowtitle "文档HTML页面标签的标题" -link http://docs.Oracle.com/javase/7/docs/api

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值