Struts XJavadoc 1.1(XDoclet 1.2.3) の Java 5 対応

2024-04-202024
30.2% (110.8/366)
April
66% (19.8/30)
Week 16
83% (5.8/7)
Day 20 Sat
81.2% (19.5/24)

total: 10515
today: 3
yesterday: 8
now: 5

XDoclet 1.2.3 に付属している XJavadoc 1.1 は、解析するソースコード中に Java 5 から導入された Annotation や Generic を見つけると、Parse Error を起こして処理をやめてしまう。
- Annotation : @Override など
- Generic : List<String> strList = new ArrayList?<String>(); など
公式なものではないが、Anton Adamansky さんが、パッチを作ってくれたようだ
- http://opensource.atlassian.com/projects/xdoclet/browse/XJD-41
- このサイトにある、xjavadoc-1.1-j5.zip に入っている、xjavadoc-1.1-j5.jar をXDoclet 1.2.3 に付属している xjavadoc-1.1.jar とおきかえれば、とりあえず Java 5 でXDoclet を使える。
付記(ソースコードが UTF-8 のときの留意事項)
```
<webdoclet
  destdir="${web.module.webinf}"
  mergedir="${xdoclet.merge.dir}"
  excludedtags="@version,@author,@todo"
  addedtags="@wtp generated"
  force="${xdoclet.force}"
  verbose="true"
  encoding="UTF-8">
```
最近では、ソースコードは UTF-8 で記述するのが普通。ant の webdoclet タスクの encoding 属性を忘れずに
- webdoclet タスクのマニュアルには、encoding 属性が載っていないが、webdoclet タスクは doclet タスクを継承したもの。