Javadoc ツールは、アクセシビリティ修飾子に基づいてドキュメントを生成します。デフォルトでは、すべてpublic
のprotected
クラス、フィールド、およびメソッドが文書化されます。これは、次のオプションで変更できます。
-public
public クラスとメンバーだけを表示します。-protected 保護
された public クラスとメンバーのみを表示します。これがデフォルトです。-package
パッケージ、保護、およびパブリック クラスとメンバーのみを表示します。-private
すべてのクラスとメンバーを表示します。
Java 9 はモジュールの概念を導入し、プロジェクト Jigsaw はそれを既存の JDK に適用します。Mark Reinholdによる講演(モジュールに関する一連の講演の 3 番目) は、モジュールの可視性 ( 経由)に応じて、モディファイヤがどのようpublic
に異なるレベルのアクセシビリティを持っているかを示しています。exports
- みんなに公開
- パブリックだが特定のモジュールのみ
- モジュール内でのみ公開
現在、すべてのパブリック メンバーにアクセスできるわけではないため、同じ Javadoc 生成スキームを使用し続けることはあまり意味がありません。「十分な」レベルで公開されているメンバーのみを文書化する必要があります。
Javadoc モジュールは認識されますか? 追加の露出レイヤーを処理するために、上記のものに加えてコマンド オプションはありますか? 特定のモジュールにのみ公開されているパブリック メンバーの場合、Javadoc には次のようにリストされていますか?
public <module1, module2> static void getDefaultThing()
?