aidl 生成java idea生成api文档_idea 注释模板


今天聊聊IDEA的文档,省时间,就让IDEA帮你生成。

1 javadoc的配置与效果

1.1 类注释

效果

右键新建Class后,会自动生成和它相应的类注释。


aidl 生成java idea生成api文档_idea 大小写_02


配置方法

工具栏File—Settings(Ctrl+Alt+S),选择Editor,按下图操作。就可以自己定义想在类里显示的东西了。


aidl 生成java idea生成api文档_aidl 生成java_03


1.2 方法注释

效果

在方法体中,输入“/**”然后回车,可以自动显示出该方法中的多个参数以及返回值(如果有异常也会以“@exception”标记出来),然后大家根据这个模板,直接编辑内容就行。


aidl 生成java idea生成api文档_idea 方法注释_04


配置方法

建议直接使用IDEA定义好的方法,不配置。

不然使用起来也很麻烦。配合其他的文档版本管理软件,如git或svn,应该够用的。

比较常用的javadoc标记:@see、@author、@link、@see

需要的地方,直接采用类似的方法标注即可:@see OrderService @author paoer

当然,如果确实有很常用的,可以再通过File--Settings--Live Templates来配置。(目前配置来讲感觉非常不好用,不建议,下面的细节内容不细抠了)。

2 生成代码对应的doc文档

最后的,还是高大上的效果!!~~


aidl 生成java idea生成api文档_aidl 生成java_05


配置方法

选择工具栏Tools--Generate JavaDoc... 选择File'...

可以选择是按模块生成文档,还是按项目生成文档(建议按模块生成,不用生成项目下所有模块,太多了)。其他配置如下:


aidl 生成java idea生成api文档_idea 大小写_06


other command line arguments,可以参考输入如下字符串: -encoding UTF-8 -charset UTF-8 -windowtitle “泡儿的文档” -link https://docs.oracle.com/en/java/javase/11/docs/api ---这里考虑一下你们的JDK版本,替换成相应的数字。加这一句link,是为了生成文档时,变量的定义是“string”而不是“java.lang.string”

第一个参数 -encoding UTF-8 表示告诉对方,你的源代码(包含JavaDoc注释的)是UTF-8编码的;

第二个参数 -charset UTF-8 表示,在对方处理生成JavaDoc的超文本时,使用的字符集也要是UTF-8。

目前所有浏览器都支持 UTF-8,这样最具有通用性,支持中文非常好。

3 关于智能提示

IDEA默认,是必须大小写也严格符合标准字库,才能智能提示出完整语句。但来回切换大小写,编码速度会下降。

Settings—General—Code Completion,取消勾选match case即可

调整代码匹配程度可以选择,是第一个字母匹和标准语句第一个字母匹配,显示出相关的(First letter only;?还是第一个字母匹配出标准语句中的某些字母,就提示(All letters)。


“泡泡的叨叨:用了某个云笔记软件,结果授权死活过不了..没事,还是word吧,老牌软件不用考虑网络稳定性,还是靠谱的。”


aidl 生成java idea生成api文档_idea 注释_07