Maven2 - たまにっき。
2008-05-13 Tue
■ assembly:assembly で tar.gz するとき，中の特定のファイルのパーミッションを 0755 にしたい．
少し悩んだので，メモ．
assembly の定義をする assembly.xml の fileSet タグの中に 中身を0755のようにfileModeタグを入れれば良いようだ．アーカイブ方法が tar.gz じゃなく，zip だとパーミッションを記録しないのでできないかも．試してないのでわかんない．
アーカイブ方法に dmg なんて選べるのかな？
サンプルは以下を参照のこと．
《続きを読む》
]
2007-09-28 Fri
■ maven-dependency-plugin
[2006-06-07-1] ではスコープを見てくれないと書いていたが，最新のものでは見てくれるようになったようだ．codehaus から maven 本家に移っているし．
で，だ．今回やりたいことは test:test が実行される前に依存jarファイルを指定ディレクトリにコピーしたいということだ．テストの中で依存jarファイルを覗いて，なんとかかんとかやりたいためだ．そのためには， executions/execution/phase を変更すれば良いようだ．package だとプロジェクトのjarファイルが作成されたあとに，compile だとコンパイルが終わってから，test だとテストが実行されてから，というようになるらしい．
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<executions>
<execution>
<id>copy-dependencies</id>
<phase>compile</phase>
<goals>
<goal>copy-dependencies</goal>
</goals>
<configuration>
<outputDirectory>${project.build.directory}</outputDirectory>
<includeScope>runtime</includeScope>
</configuration>
</execution>
</executions>
</plugin>
]
2007-03-29 Thu
■ Maven2 で JUnit4 を使う方法．
pom.xml の plugins の中身に以下のタグを追加するだけでOKらしい．
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.3</version>
</plugin>
実際にはこれだけじゃなくて，アノテーションが使えるようにJavaのソースコードのバージョンを 1.5 に指定したり，dependencies の JUnit のバージョンを 4.1 にすることも必要．
]
2007-02-05 Mon
■ Maven2 で JUnit4
Junit4 で書いたテストを Maven2 で動かしてもどうも @Before アノテーションとか，@Test アノテーションを理解してくれてないっぽい．
なぜだーと検索してみると，何のことはない，Maven2 が Junit4 に対応していなかっただけっぽい．
しかも，Maven2 の surefire を最新のものに更新するといけるっぽい．
早速やってみた．いけた．
]
2007-01-09 Tue
■ Wagon protocol 'ftp' doesn't support directory copying
Maven2 を使って apt フォーマットで作ったドキュメントを ftp でデプロイしようとしたところ，上記のエラーでビルドが失敗する．
困った．パッチ当てるのも面倒くさいし．．．
]
2007-01-08 Mon
■ webstart-maven-plugin
How to にあるようにインストールしようとして
mvn install webstart:jnlp
とするとビルドエラー．
仕方ないので，手動でインストールしようと Source Repository を参考にチェックアウトしようとするが，404 page not found．
調べてみると，https://svn.codehaus.org/mojo/trunk/mojo/mojo-sandbox/webstart-maven-plugin/plugin ではなく，https://svn.codehaus.org/mojo/trunk/mojo/webstart-maven-plugin/plugin だった．mojo-sandbox がいらないのか．
svn co https://svn.codehaus.org/mojo/trunk/mojo/webstart-maven-plugin/
でチェックアウト，
mvn install
でインストールしようとするが，テストで引っかかる．試しに使ってみたいだけなのでテストをスキップさせて無理やりインストールする．
mvn install -Dmaven.test.skip=true
で，インストールできたはいいけど，使い方がよくわからん．
]
2006-10-06 Fri
■ Maven2 で作成される jar の MANIFEST.MF に Premain-Class を加える
Maven2 で jar ファイルを作るときに使われる maven-jar-plugin が対応している MANIFEST.MF のエントリは mainClass, addClassPath, addExtentions, classpathPrefix, packageName の 5 だけ なのだが，そこに Premain-Class やら Boot-Class-Path エントリなど自由にエントリを追加したい．
そのためには自前で MANIFEST.MF を用意しておく．pom.xml に書いてある mainClass などととマージできるので，必要なものだけを書いた MANIFEST.MF があればよい．
MANIFEST.MF の内容は以下の通り．置く場所は下の pom.xml と合わせる必要があるが，下の通りだと $basedir/src/main/resources/META-INF/ 以下に置いておく．
Premain-Class: your.package.name.PremainClass Boot-Class-Path: bootClasspath.jar
pom.xml の plugin の設定のところに以下のようなタグを加える．premain は Java 5 以降なので，コンパイル後のクラスファイルのバージョンも 1.5 用にしてるけど，いらないかも．・・・いや，うーん，いるかも．まぁ試していない．
:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.5</source>
<target>1.5</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<configuration>
<archive>
<manifestFile>${basedir}/src/main/resources/META-INF/MANIFEST.MF</manifestFile>
<manifest>
<mainClass>your.MainClass</mainClass>
<addClasspath>true</addClasspath>
</manifest>
</archive>
</configuration>
</plugin>
:
</plugins>
<build>
:
これで mvn package すると MANIFEST.MF に Premain-Class が含まれた jar ファイルが出来上がる．
上のようなものだと作成される MANIFEST.MF は以下のようなもの．
Manifest-Version: 1.0 Archiver-Version: Plexus Archiver Created-By: Apache Maven Built-By: tamada Build-Jdk: 1.5.0_08 Extension-Name: artifactId Specification-Vendor: organization Implementation-Vendor: organization Implementation-Title: artifactId Implementation-Version: 2.1-SNAPSHOT Main-Class: your.MainClass Class-Path: dependencies-version.jar dependencies1-version.jar Premain-Class: your.package.name.PremainClass Boot-Class-Path: bootClasspath.jar
実行するときはこんな感じ．
$ java -javaagent:hoge.jar SomeClass
]
2006-10-02 Mon
■ release プラグインの使い方がよくわからん．
scm は svn，そして cygwin (Windows) 上で mvn release:prepare すると commit に失敗する．
ログを見ると
svn --username username --non-interactive commit --file C:\DOCUME~1\tamada\LOCALS~1\Temp\maven-scm-23802345.commit <カレントディレクトリの Windowsパス>
なのだが，エラーメッセージとしては「<cygwinでのパス表現>/<Windowsでのパス表現>」と同じパスを違う表現で繋げられるのでそんなパスは知らねぇと svn に怒られている．．．
内部で呼び出している svn には引数を付けていらんのだが・・・
]
2006-10-02 Mon
■ Bash completion for Maven 2
bash_completion を使って mvn の引数を補完しようというもの．
なかなか便利・・・なのかも．
archetype:create で packaging が jar 以外のものを作るときは重宝しそうだ．
]
2006-09-13 Wed
■ maven-resources-plugin に native2ascii 機能を加えるパッチ
A patch of maven-resources-plugin 2.2 for executing native2ascii.
これは何?
このパッチは maven-resources-plugin に native2ascii と同等の機能を追加します．
何でこんなのがいるの?
- Maven2 は native2ascii を実行するためのプラグインやら機能やらが標準では提供されていません．
- 有志が maven native2ascii plugin を提供していますが，これには一つの問題があります．それは native2ascii に渡されるプロパティファイルはフィルタリングされないというものです．プロパティファイルに ${pom.version} と書くとその部分を pom.xml の version タグの中身に置き換えてくれる機能が使えないのです．これはイタイ．
そのため，フィルタリングしつつ native2ascii もやってくれるようなプラグインが必要なのです．
このパッチを使う上での制限は
このパッチ自体に著作権を主張するつもりはありません．パッチを当てるプロダクト(maven-resources-plugin)のライセンスを確認して使ってください（多分 apache ライセンスだと思います）．
パッチの使い方
1. このリンク からパッチをダウンロードします．
2. maven2 の subversion リポジトリから maven-resources-plugin バージョン 2.2 をダウンロードします．詳細は このページ を参照してください．
3. チェックアウトにより作成されたディレクトリに移動します．
4. patch コマンドを実行し，パッチを当てます．
$ patch -p1 < ../maven-resources-plugin-native2ascii.patch
5. maven2 を install ゴールで実行し，パッチを当てた maven-resources-plugin をローカルリポジトリにインストールします．
$ mvn install
パッチが適用されたプラグインの使い方
pom.xml に以下のような xml タグを追加してください．
<build>
<plugins>
:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<configuration>
<native2ascii>true</native2ascii>
</configuration>
</plugin>
:
</plugins>
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
</resource>
</resources>
</build>
src/main/resources に含まれているプロパティファイルがフィルタリングされた後，native2ascii 機能が実行されます．もし，native2ascii を実行しないならば，native2ascii タグを消すか，native2ascii タグの中身を false にしてください．フィルタリングしたくなければ，同じく filtering タグを消すか，filtering タグの中身を false にしてください．
以下は英語での説明．Following link described above description in English.
《続きを読む》
]
2006-09-11 Mon
■ Maven2 native2ascii plugin
Maven2 で native2ascii コマンドを実行するプラグイン．
<plugins>
<plugin>
<groupId>com.jakubpawlowicz.maven.plugins</groupId>
<artifactId>maven-ant-plugins</artifactId>
<executions>
<execution>
<phase>compile</phase>
<goals>
<goal>native2ascii</goal>
</goals>
<configuration>
<encoding>shift_jis</encoding>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
みたいなのを pom.xml に追加すれば native2ascii がかけられる．ただし，tools.jar にクラスパスを通しておく必要がある．
困った点
- filter を見事に無視してくれる．
- 拡張子が properties なものが全て対象になるようだ．
filter が無視されるのはイタイ．properties ファイル中に ${pom.version}とか ${pom.artifactId} などを参照することが多いと思うんだが．これさえ OK ならある拡張子を全て処理の対象になっても良いんだがなぁ．ただし，拡張子が properties 決めうちはイマイチだ．
ついカッとなって作ってしまった．拡張子についてはまだ未対応だけど，まぁ，よしなに．ライセンスは 無償・無保証・著作権放棄 です．
《続きを読む》
]
2006-08-10 Thu
■ Better Builds with Maven
via Articles on Maven
281 ページの PDF が無料でダウンロードできる．ただし，登録が必要．
ダウンロードして，目次を見てみると，「Developing Custom Maven Plugins」とか，「Assessing Project Health with Maven」とか，「Team Collaboration with Maven」などの章があり，便利そうな予感がする．
continuumの章もあってステキ．
]
2006-08-08 Tue
■ issue tracking system
Maven 1 には issue tracking system との連携があってこんな感じで使うことができる．
で，Maven 2 ではどうするのかなと調べてみた．
Project Descriptor によると，以下のようなタグを pom.xml に加えればよいらしい．
<issueManagement>
<system>mantis</system>
<url>http://example.com/mantis/</url>
</issueManagement>
system タグの中身は issue tracking システムの名前．Bugzilla とか，影舞とか，mantisなどを指定すればよいみたい．そして，url はその issue tracking システムが動作しているページへの URL なんだろう．
それで，どのように連携されるか確認すると，単にリンクが張られただけでした．orz
まぁいいや．
]
2006-06-07 Wed
■ APT format
Maven2 の標準のドキュメントフォーマットがこの APT (Almost Plain Text) である．簡単に覚えられ，かつ簡単なテキストなので，流石に便利なのだが，一点問題がある．
ページの一部を動的にするため，JavaScript を埋め込むことや，SSI，また，HTML タグを直接書くことができないのである．外部ファイルを読み込むこともできないので，困っている．
やりたいことは，ページの一部の表示を javascript で行いたいだけ．しかも，その javascript は document.write のみの 1 行程度のスクリプトだ．これを apt フォーマットのファイルに埋め込みたい．これが無理なら，この部分だけを xdoc フォーマットで書くかなぁ．
]
2006-06-07 Wed
■ dependency-maven-plugin 2
dependency:copy-dependencies ゴールを使えば dependencies の jar ファイルを全てを指定したディレクトリに置くことができる．しかし，scope は見てくれないようだ．scope が provided であろうが，test であろうが，指定したディレクトリにコピーされる．scope が compile のものだけをコピーして欲しいんだけどなぁ．まぁ仕方ないか．
ref. [2006-06-05-2], [2006-03-10-7]
]
2006-06-05 Mon
■ dependency-maven-plugin
使ってみる．How to use にある xml を pom.xml の plugins タグの下にコピーして，mvn package するとイケるみたい．
ただし，executions の閉じタグが exections のように u が抜けているので，注意．また，copy ゴールの例の xml の中で，outputDirectory で始まり，location で閉じられたものがあるが，これは outputDirectory が正解みたい．
出力先は plugins/plugin/executions/execution/configuration/outputDirectory で変えられるようだ．
www.ibiblio.org/maven2 が重すぎてイライラするぅ．3 回くらいタイムアウトになった．
ref. [2006-03-10-7]
]
2006-05-10 Wed
■ jfreechart
JFreeChart を使ったシステムを Maven2 でコンパイルするためには以下の dependency を書かなくてはならない．
<dependency>
<groupId>jfree</groupId>
<artifactId>jfreechart</artifactId>
<version>1.0.1</version>
<scope>compile</scope>
</dependency>
こうすると自動的にダウンロードされ，コンパイルされる．
はずなのだが，jfree.jfreechart:jfreechart-1.0.1 は jfree.jcommon:jcommon-1.0.0 に依存する．そして，jcommon-1.0.0 は gnujaxp-1.0.0 に依存すると pom ファイルに書いてある．この gnujaxp は ibiblio に存在しないので，コンパイルできない．困った．
jcommon の各バージョンの pom ファイルを調べてみると，jcommon-1.0.4 では，gnujaxp に依存しないため，jfreechart のローカルの pom ファイルを編集し，jfree.jcommon:jcommon-1.0.4 に依存するように変更した．
]
2006-04-12 Wed
■ 最新の maven-site-plugins
ついさっき，maven-site-plugins を SVN から取ってきて，mvn site をごにょごにょやると，文字化けする．AbstractSiteRenderingMojo を見ると，inputEncoding なるフィールドができている．もしやと思い，pom.xml の
:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<configuration>
<outputEncoding>utf-8</outputEncoding>
<inputEncoding>euc-jp</inputEncoding>
<locales>ja</locales>
</configuration>
</plugin>
:
と inputEncoding タグを加えてみると，見事解釈してくれました．
]
Powered by 
