Mojoを作成する
Last updated
Last updated
Mavenプラグインの実体は、Mojo（Maven plain Old Java Object）と呼ばれるクラスです。Mavenプラグインは含まれるゴールの数だけMojoを保有します。 このクラスに必要なメソッドとMojoアノテーションを追加することでプラグインを実装します。
MojoはAbstractMojoを継承し、@Mojoアノテーションで修飾される必要があります。 また@Executeアノテーションや@Parameterアノテーション、@Componentアノテーションなどに用意されたアノテーションを使用できます。
次にシンプルなMojoの実装を記載します。
順を追って見ていきましょう。
Mavenプラグインが実行されると、Mojoのexecuteメソッドが実行されます。 プラグインの実際の処理はここに記載します。
@MojoアノテーションのdefaultPhaseオプションによって、実行するフェーズを指定できます。 この設定はユーザの設定によって上書くことが可能ですが、デフォルト設定で多くの環境で問題なく動作することが望ましいでしょう。
プラグインはさまざまなプロジェクトに対応するため、しばしば設定を提供します。 設定はpom.xmlに記載できるため、同じ設定を複数の環境で容易に共有できます。 一般的な設定としては以下があります。
<skip> ... trueならプラグインを実行しません。プロジェクト固有のプロパティで指定できることもあります。
<encoding> ... ファイルの読み書きに利用するエンコードです。project.build.sourceEncodingプロパティをデフォルト値として使用できます。
Mavenプラグインを実装する場合、ログの出力は標準出力や標準エラー出力ではなく、親クラスが提供するロガーを利用します。 これによって、Mavenの-qオプション（エラーのみ出力）や-Xオプション（デバッグログ出力）準拠でき、ログに適切な接頭辞が付くためログの可読性が向上します。
処理を高速化するため、デバッグ時にのみ情報を取得・計算できます。
なお引数に渡す文字列には、改行コードを含めないことをお勧めします。接頭辞のつかない行ができてしまい、 機械的に処理することが難しくなるためです。複数行を出力したい場合は、メソッドを複数回に分けて 呼び出してください。
もし作成したプラグインがスレッドセーフである場合は、それを明示することが望ましいといえます。 Maven{{book.version.maven}}時点でのマルチスレッドサポートは限定的ですが、これが改善されたときのために用意しておきましょう。
2015年4月時点での公式チェックリストの訳を次に記載します。
staticなフィールドや変数を使っている場合、その値がスレッドセーフであることを確認すること。
特に "java.text.Format" のサブクラス （NumberFormat, DateFormat など） はスレッドセーフでないので、staticなフィールドを介して複数のスレッドから利用されるようなことがないように注意する。
components.xmlにシングルトンとして定義されているPlexusコンポーネントを使っている場合、そのコンポーネントはスレッドセーフでなければならない。
依存ライブラリに既知の問題が存在しないか確認すること。
サードパーティ製ライブラリがスレッドセーフであることを確認すること。
つまり、単一JVM内で複数のMojoインスタンスが並列に作成・実行される可能性があるので、それに備える必要があるということです。
ここまで来たら、作ったプラグインが正常に動作することを確認してみましょう。 ローカルリポジトリにプラグインをインストールしてから、作成したMojoを実行してみてください。
<outputDirectory> ... 成果物の出力先ディレクトリです。project.build.directoryプロパティが示すディレクトリ、あるいはそのサブディレクトリをデフォルト値として使用するべきです。
@MojoアノテーションのthreadSafeプロパティによってスレッドセーフか否かを表現できます。 を確認し、スレッドセーフであるといえる場合は、trueを指定しましょう。