为接口生成javadoc(eclipse)

6 篇文章 0 订阅

1、先配置注释样式

(1)项目右键-》properties


(2)点击edit即可对注释进行编辑

eg:
Types:
/**
* <b>描述:</b>
* <br><b>作者:</b> ***
* <br><b>版本:</b>v2.0
* <br><b>ProjectName:</b> ${project_name}
* <br><b>PackageName:</b> ${package_name}
* <br><b>ClassName:</b> ${type_name}
* <br><b>Date:</b> ${date} ${time}
*/

Methods:
	/**
	 * <b>描述:</b><br>
	 * <b>HTTP Method:</b> GET <br>
	 * <b>接口地址:</b>
     * ${tags} <br>
	 * "remarks": "No remarks" <br>
	 * "returnReason": "OK" 成功 <br>
	 * "returnStatus": 200 返回成功 <br>
	 * "returnTotal":  returnInformation的个数 <br>
	 * "returnInformation": <br>
	 *             { <br>
	 *             } <br>
	 *  <b>Author:</b>*** <br>
	 * <b>Date:</b> ${date} ${time}
	 */


2、代码中选中class名或者method名,快捷键ctrl+shift+j进行注释

对相应的参数加上自己的注释

3、export javadoc文档

项目或者java方法右键-》export

通过修改生成位置,可以让文档生成到服务器启动可以访问的位置,方便别人查看api,调用接口
输入-encoding UTF-8 -charset UTF-8防止中文乱码


4、生成结果


  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: Eclipse 中默认的 JavaDoc 时间格式是不可以修改的,但是你可以通过插件来设置。推荐使用插件 "Eclipse JavaDoc Formatter",可以帮助你自定义 JavaDoc 格式,包括时间格式。 要安装该插件,请执行以下步骤: 1. 打开 Eclipse 2. 点击 "Help" 菜单 3. 选择 "Eclipse Marketplace" 4. 在搜索栏中输入 "Eclipse JavaDoc Formatter" 5. 选择 "Eclipse JavaDoc Formatter",点击 "Go to Install" 6. 按照提示完成安装 安装后,请执行以下步骤来设置 JavaDoc 时间格式: 1. 点击 "Window" 菜单 2. 选择 "Preferences" 3. 在左侧选择 "JavaDoc Formatter" 4. 在右侧找到 "Timestamp format" 选项 5. 输入你想要的时间格式,例如:yyyy-MM-dd HH:mm:ss 6. 点击 "Apply" 并 "OK" 以后每次生成 JavaDoc 时都会使用你设置的时间格式。 ### 回答2: 在Eclipse中设置Javadoc中的时间格式可以通过以下步骤实现: 1. 打开Eclipse,并进入要设置Javadoc的项目。 2. 在项目导航器中选择要设置Javadoc格式的类或接口,然后右键单击并选择“Properties”选项。 3. 在“Properties”窗口中,选择“Java Build Path”选项。 4. 在右侧的“Javadoc”选项卡中,可以看到“Edit”按钮。点击该按钮。 5. 在弹出的“Javadoc command”窗口中,可以看到Javadoc命令的默认格式。它可能类似于以下命令: `<javadoc executable> -d <output dir> -author -version -tag <tag name>:<tag locations> <source dir>` 注意到命令中没有指定日期格式。 6. 在Javadoc命令中添加参数来指定日期格式。可以使用`-tag`选项来指定日期格式。例如,要在Javadoc输出中包含日期,并按照"yyyy-MM-dd"的格式显示,可以使用以下命令: `<javadoc executable> -d <output dir> -author -version -tag <tag name>:<tag locations> -tag mydate:a:"@date yyyy-MM-dd" <source dir>` 在上述命令中,`-tag mydate:a:"@date yyyy-MM-dd"`将自定义标签`@mydate`添加到Javadoc命令中,并指定了日期的格式。 7. 完成设置后,点击“OK”按钮保存更改。 通过上述步骤,您就可以在Eclipse中成功设置Javadoc中日期的格式了。 ### 回答3: 要设置EclipseJavadoc的时间格式,可以按照以下步骤进行操作。 首先,在Eclipse的工具栏上点击"Window",然后选择"Preferences"打开Eclipse的偏好设置。 在弹出的窗口中,选择"Java",然后找到"Code Style"下的"Code Templates"。点击这个选项后,会显示出当前代码模板的设置选项。 在右侧的框架中,选择"Comments"选项卡,然后找到"types"部分的"File"和"Class"。在这两个选项后面有一个"Edit"按钮,点击进行编辑。 接下来,在弹出的窗口中,会显示出Javadoc的模板,包括Javadoc的格式和内容。在需要显示时间的位置,可以使用变量${date}和${time}。 ${date}和${time}分别代表了当前日期和时间的格式。可以使用以下格式控制符来设置日期和时间的显示格式: - 使用yyyy代表年份的4位数显示。 - 使用MM代表月份的2位数显示。 - 使用dd代表天数的2位数显示。 - 使用HH代表小时的24小时制的2位数显示。 - 使用mm代表分钟的2位数显示。 - 使用ss代表秒数的2位数显示。 例如,要将当前时间的格式设置为"yyyy-MM-dd HH:mm:ss",可以在Javadoc的模板中使用${date}和${time},并按照以上指定的格式控制符来设置时间格式。 设置完毕后,点击"OK"来保存修改。从现在开始,每次生成Javadoc时,时间将按照设置的格式显示在对应的位置。 以上就是设置EclipseJavadoc时间格式的方法。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值