[問題] Javadoc generator bug?
大家好,
這兩天再產 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://www.ptt.cc/bbs/java/M.1410856001.A.8F9.html
※ 編輯: cyclone350 (61.218.64.133), 09/17/2014 12:15:18