SpringプロジェクトでCheckstyleを実行すると、次のように表示されます。
- Missing package-info.Java file.
Javadocの説明を保存するために使用されます。 7.4.1。Named Packages の TheJava®Language Specification にあります:
package-info.Java
が存在する場合は、javadocおよび他の同様のドキュメント生成システムのpackage.html
の代わりにすることをお勧めします。このファイルが存在する場合、ドキュメント生成ツールは、package-info.Java
の(おそらく注釈付きの)パッケージ宣言の直前のパッケージドキュメントコメントを検索する必要があります。このようにして、package-info.Java
がパッケージレベルの注釈とドキュメントの唯一のリポジトリになります。将来、他のパッケージレベルの情報を追加することが望ましくなった場合、このファイルはこの情報の便利なホームとなるはずです。
例:
/**
* Info about this package doing something for package-info.Java file.
*/
package your.project.doSomething;
[〜#〜] update [〜#〜]ここから
Package-info.Javaファイルは手動でパッケージに追加できますが(Javaクラスを手動で作成できるように)、IDEにはpackage-infoを含めるオプションがよくあります。新しいパッケージを作成するたびにJavaファイルを作成するEclipse(以下に示す)では、新規Javaパッケージ作成ウィザード)に単純な(そして見過ごされがちな)チェックボックスがあります。