作者cyclone350 (老子我最神)
看板java
标题[问题] Javadoc generator bug?
时间Tue Sep 16 16:26:39 2014
大家好,
这两天再产 java doc 时发现一个问题,不知道算不算BUG
当我 method 有 annotation 时
如:
public String xxx(@RequestParam(value = "id", required = true) Integer
id, Model model)
产出来的 Javadoc, 此 method 会变成此种样式
public String xxx(@RequestParam(value = "id", required = true)
研判是程式读到右括号就停了
或是假设我参数有多个
如
public String xxx2(Integer id, Model model)
产出来的 javadoc, 此 method 会变成此种样式
public String xxx2(Integer id,
org.aaa.bbb.Model model)
本来以为是 css 问题,结果 html 原始码就是给他空了一大堆空格....
第一个问题想找有没有可以忽略Annotation的选项, 不过...没看到
第二个问题真的就无解了...
另外... 我是使用 jdk 1.8
因为 source 有用到 1.8 语法及 api, 所以产 javadoc 时无法选较低阶的版本
也无法确认是否为 1.8 的问题
请问有人遇过这两种问题吗?
有解吗?
谢谢
---------------
update
大概知道问题在哪
如问题二
程式码如果有 annotation 如
@ResponseBody
public String xxx2(Integer id, Model model)
就会产生跑板问题
可能是 javadoc 不会判断到换行
所以应该会判断产出
@ResponseBody public String xxx2(Integer id,
org.aaa.bbb.Model model)
但是实际产出 annotation 却会换行
@ResponseBody
public String xxx2(Integer id,
org.aaa.bbb.Model model)
就产出之类的跑版
这样算是 javadoc 的 bug 吗?
--
※ 发信站: 批踢踢实业坊(ptt.cc), 来自: 61.218.64.133
※ 文章网址: http://webptt.com/cn.aspx?n=bbs/java/M.1410856001.A.8F9.html
※ 编辑: cyclone350 (61.218.64.133), 09/17/2014 12:15:18