私の目標は、特定のパッケージの Java クラスを「読み取り」、そのパッケージ内のクラスとそれらのクラス内のメソッドで Javadoc と注釈を (できれば同時に) 処理することです。maven-compiler-plugin
ソリューションは Java 6 または 7 で実装する必要があります。ビルド ツールは Maven 3 です2.5.1
。
私が理解しているように、javax.annotation.processing
クラスの目的はこの種のことを行うことであり、この他のSO回答の行に沿ったJavaコードは私の目的のために機能するはずですが、実際に実行する方法の実際の詳細はまだです少しぼやけています。
そうは言っても、ここに私が必要だと思うものがあります:
- 必要な注釈と Javadoc 項目を選択し、それらの項目をカスタム ドキュメントの作成に必要なデータ モデルに変換する Java コード。
- このデータ モデルをドキュメント ファイルまたはファイルのディレクトリに書き出すための Java コード
- Maven 3 の構成:
- アノテーション プロセッサを適切なタイミングで 1 回実行する
- 生成された docs ディレクトリを出力された war ファイルに含めます
Maven のビットは、Java コードよりも私をつまずかせるので、半分しか答えない場合は、その半分にチェック マークを付けます。また、このアノテーション プロセッサは、使用しているいくつかのカスタム アノテーションと非常に密接に結合されるため、別のプラグインとして Maven リポジトリに配置しないことをお勧めします。
これは、私自身の答えを合成することができなかった関連として見つけた質問の簡単なリストです。