煩悩ログ

スポンサーサイト

上記の広告は１ヶ月以上更新のないブログに表示されています。新しい記事を書く事で広告が消せます。

--.--.--.--:-- /
スポンサー広告

[Java][Eclipse]EclEmmaのJaCoCoが気になる（C1カバレッジの巻）

前のエントリーの続きです。
JaCoCoについて、もう少し掘り下げ。

■C0に加えてC1の計測が可能
EMMAはC1が計測できませんので、これは非常にありがたい。
カバレッジは通れば良いって物ではないので、ラインカバレッジだけでは、テストの妥当性を検証するには不十分ですよね。

具体例です。例えば下記のような酷く単純なコード

boolean conditionA = true;
if(conditionA)
{
　 System.out.println("done!");
}

JaCoCo（EclEmma2.1.2）で実行すると以下のような結果になります。JaCoCoレポートで出しても同じ。

ちなみにEMMA(EclEmma1.5.3)だとこうなります。JaCoCoとEMMAの黄色ラインは意味合いが異なってますね。

で、黄色のラインにカーソルを合わせると、「1 of 2 branches missed.」と言われます。
条件がfalseのelse分岐（コード上にないけど）が実行されていないからですね。

と、ここで注意。
ドキュメントでも言及されていますが、JaCoCoはバイトコードに対して計測するため、コンパイラによって生成されたバイトコードが、ソースと大きく異なっている場合に、ぱっと見で分かりづらい結果になる可能性があります。
たとえば

boolean conditionA = true;
boolean conditionB = false;
conditionA = !conditionB;

を実行すると、このようになります。

「1 of 2 branches missed.」！！

あれ？っと思い、JaCoCoのOpen Discussionで質問してみたところ、「バイトコードに対して計測するのでそうなります」との回答。お手数おかけいたしました（^^;）
てことで自分でも調べてみたところ、Jadで逆コンパイルしてみるとバイトコードでは

0:iconst_1　　　　true（1）をスタックに入れる
1:istore_1 　　　　true取り出してローカル変数１に入れる
2:iconst_0 　　　　false（0）をスタックに入れる
3:istore_2 　　　　false取り出してローカル変数２に入れる
4:iload_1 　　　　　ローカル変数１をスタックに入れる
5:ifeq 　　18　　　ローカル変数１がfalse(0)なら、18へ→return
8:iload_2 　　　　　ローカル変数２をスタックに入れる
9:ifeq 　　16　　　ローカル変数２がfalse(0)なら、16へ
12:iconst_0 　　　　 falseをスタックに入れる
13:goto 　　 17 　　17へ
16:iconst_1 　　　　true(1)をスタックに入れる
17:istore_1 　　　　スタックから結果（trueかfalse）を取り出してローカル変数１に入れる
18:return　　　　　　終了

となっていました。（言葉はつたない自分翻訳）
条件文が二つに分かれている…、コンパイルするとこうなるなんて知りませんでした。。

コードにするとこんな感じみたい。

boolean conditionA = true;
boolean conditionB = false;

if(conditionA)
{
　　if(conditionB)
　　{
　　　　conditionA = false
　　}
　　else
　　{
　　　　conditionA = true;
　　}
}

てなわけで、こういったこともあるので気をつけましょう。
て、みんな知ってるのかな…
よくよく見たらEMMAもそうみたいですね。

more...

theme : ソフトウェア
genre : コンピュータ

2012.03.20.07:48 /
ソフトウェア

comment 0 :
trackback 0

Pagetop

[Java][Eclipse]EclEmmaのJaCoCoが気になる

EclEmmaに関連して書いたJaCoCoについて、少し分かってきたのでメモ的なまとめ。
使い方などは公式ドキュメントが詳しいのでいいとして、このエントリはどちらかというと自分なりの解釈込みの周辺情報です。
# 間違ってたらコメントいただけると助かります。

JaCoCo -Java Code Coverage Library
http://www.eclemma.org/jacoco/trunk/index.html

■JaCoCoってどんなの？
JaCoCoはEclEmmaの開発チームが、EMMAを置き換えるためのカバレッジライブラリとして
開発を進めてきたものです。
今までも単体で利用できましたが、EclEmma2.0で晴れて組み込まれました。

ドキュメントをつらつら読んでみたのですが。
既存のカバレッジライブラリは拡張性が乏しく、すでにメンテされていないEMMAを使い続けるよりは
自分たちで拡張や統合が容易な物を作っちゃお、という事になったようです。
JaCoCoは、Antタスクでの実行、Mavenプラグインなどのフレキシブルな運用を可能にし、
バックエンド技術として、もちろんEclipseプラグインとしてEclEmmaで使うことも目的としています。

■個人的に抜粋した特徴

C0に加えてC1（ブランチカバレッジ）の計測が可能
Javaバイトコードに対して計測（別エントリでもう少し詳しく）
サイクロマチック数の計測
HTML,XML,CSVでのレポート出力
Antタスクとしての実行
EPL（…これはいいか）

C1の計測とAntタスクは利用価値高いですねぇ。
サイクロマチック数は実装者への戒めでしょうか…

■計測方法（JaCoCoだけで）
EMMA同様、クラスファイルに計測用のコードを埋め込んで実行という形をとるようですが、
javaagentを利用したon-the-fly方式を採用することで、バイナリに直接埋め込むのではなく、メモリ上にクラスをロードする際に前処理を挟んでいるようです。（Pleiadesと同じ感じ。）
EclEmma1.5以前まで存在していた、In-place計測もなくなっていました。

実行データの出力は、リモートへの出力などいろいろな形式があるようですが
よくわからないので、今回は単純にローカルファイルに書き出します。

実行方引数に-javaagentを指定する形です。
こちらからjacocoagent.jarを入手して下さい、zipを解凍すると入っています。

実行例

java -javaagent:jacocoagent.jar %あとは実行クラスやらクラスパスやら%

引数はとりあえずナシで…^^

するとJVM終了と同時に以下のファイルが出てきます。

jacoco.exec

これが結果みたいです（EMMAでいうecもしくはesファイルかな）
でも中身は理解できる形のものではありません。

■レポート出力（JaCoCoだけではむりっぽい）
そこでレポート出力ですが、JaCoCo単体では出力が難しいみたいです。
Antタスクで出すか、EclEmmaに上記結果をインポートして出力するのが無難っぽいです。

一応、JaCoCoのソースも見てみましたがJaCoCo単体でレポートを出す方法はみつからず。
でもAPI Usage Examplesに、サンプルとしてこんな物がありました。
http://www.eclemma.org/jacoco/trunk/doc/examples/java/ReportGenerator.java
検証してないけど使えそう。
execファイルをプロジェクト直下にもってくる必要はありそうですね。

以上、とりあえず今回は概要と計測、レポートの出力について書きましたが
別エントリーでもう少し書いていきます。

☆余談
全然関係ないけど、最近きゃりーぱみゅぱみゅが気になってしょうがないです。
ぽーんぽーんうぇいうぇいうぇい♪ぽんぽんうぇいぽんうぇいぽんぽんっ♪

theme : ソフトウェア
genre : コンピュータ

2012.03.10.21:05 /
Eclipse

comment 0 :
trackback 0

Pagetop

[Java][Eclipse]EclEmmaフィルタ機能の誤解

#このエントリーはEclEmma1.5.3をベースにしております。
#2.0.0のリリースで大きく仕様が変わりましたのでご確認ください。

EclipseでEclEmmaを利用されている方は多いと思います。
自分も使っているのですが、ヘルプを見てもわからない設定がありました。
EclEmmaのフィルタリング設定です。

Emmaをオフラインモードで使用する場合は、まずclassまたはjarへの
インストール（metadataの生成）が必要です。（詳しくはコチラ）
そしてEmmaには、インストールの際カバレッジ計測対象クラスを
フィルタリングする機能があります。これですね→6.2. Coverage filters

フィルタ機能が地味に便利なのは、他のクラスの変更による影響を受けなくてすむ点です。
Emmaはクラスを変更すると、メタデータとカバレッジデータのTimeStampの違いから
すぐレポートが吐けなくなるのですが、スコープを絞ることでその可能性を極力減らすことができます。
（再計測すればいいジャンというのは、オフラインモードというところから察してください…）

でこの機能、当然EclEmmaもサポートしているはず…と信じて設定を見ると。
「ウィンドウ＞設定＞Java＞コード・カバレッジ」にこのような↓項目があります。（クリックして拡大）

EclEmmaのヘルプ~~（引用先（2.0で内容が変わりました））~~によると

Source folders only: Consider source based class path entries only. (Default: on)
Same project only: Pick only class path entries from the same project. This option works only for launch configurations that have a project associated, i.e. Java applications. (Default: off)
Only path entries matching: Comma separated list of strings, that must match with the class path entry. A class path entry matches the filter, if it contains one of the given strings. (e.g. "src/main/java", Default: no filter)

やった、Only path entries matchingでフィルタイングできるようです。ばんざーい。

しかし喜んだのもつかの間、ここでハマりました。どうやってもフィルタリングできない…
最終的にEclEmmaのソースとステップ実行で、やっと確認できたのですが。
これクラスパスに追加されているパスしかダメみたいです。
※確かにヘルプに書いてあるんですけど、先入観は怖い…てか例がおかしくない？

つまりクラス単位ではなく、まず%PROJECT_ROOT%/bin
あとはjarとかその他クラスパスに入っているものから、フィルタに
一致したもののみカバレッジを取得する…

って、それEmmaのフィルタと違うじゃぁーんヽ(●`Д´)ﾉ

おしまい

-----------------
■12/28追記
2011/12/18にEclEmma2.0.0がリリースされました。なんとタイムリー。。
2.0.0から、同チームが開発を進めていたJaCoCoという
カバレッジツールを使用しています。

また、設定でクラス単位でのフィルタが可能になっていました。Great!
http://www.eclemma.org/userdoc/preferences.html

機会があったら、また別のエントリで書きたいと思います。
残念ながらレポートの書式が変わってしまったため、EMMAベースで作っていた
独自の周辺ツールがついて行けてないので、すぐ実運用はできないかもしれません…

theme : ソフトウェア
genre : コンピュータ

2011.11.05.10:51 /
Eclipse

comment 0 :
trackback 0

Pagetop

[Flex][AS3]Papervision3Dを試してみる

Papervision3D
テクスチャ貼ったりしてみよっと。
目標はパラパラ時計の実装。

import flash.events.Event;
import org.papervision3d.objects.primitives.Sphere;
import org.papervision3d.view.BasicView;

/**
* 最も簡単なサンプル
* @author bonno
*/
public class MyView extends BasicView
{
    private var object:Sphere;

    public function MyView()
    {
      object = new Sphere(null, 200, 10, 10);
        scene.addChild(object);

      startRendering();

        addEventListener(Event.ENTER_FRAME, doEnterFrame);
    }

    private function doEnterFrame(event:Event):void
    {
      object.rotationX += 2;
    }
}

＜実行結果＞

theme : ソフトウェア
genre : コンピュータ

2011.09.27.23:56 /
Flex

comment 0 :
trackback 0

Pagetop

[Java][PDFBox]Apache PDFBoxでPDFからイメージ生成

JavaでPDFを操作するためのライブラリは…あまり数がありませんが
個人的に一番オススメなのが、Apache PDFBoxです。

■Apache PDFBox - Java PDF Library
http://pdfbox.apache.org/

実装の感じはPOIとも似ているし、扱いやすい。

以前1.4で試していたころ、日本語PDFをイメージに変換すると
Exceptionが出たのですが。この度1.5.0で試してみたら、
「結構」うまくいきました。

#「結構」というのがミソで、相変わらず警告でまくりです。
# 埋め込まれていないフォント、一部レイアウトや縦書きなどが再現出来ないようです。

試したのは、PDFからイメージを作るPDFToImage機能です。

jar単体でも実行できるので、以下を参考にお試しアレ～

■PDFToImage
http://pdfbox.apache.org/commandlineutilities/PDFToImage.html

-コマンド

java -jar pdfbox-app-x.y.z.jar PDFToImage [OPTIONS]

オプションは指定しなくても、基本的な出力は出来るのでお気軽にどぞ。
たぶん警告がバンバン出ますが、それなりにイメージ変換できます。

ライブラリとして使う場合は。。。

①pdfをパースしてPDDocumentを取得
②PDDocumentからPDPageを取得
③PDPageのconvertToImageでBufferedImage取得

という流れです。コード無しでスミマセン…

そんなわけで、私はPDFBoxを応援します。頑張れコミッター

theme : ソフトウェア
genre : コンピュータ

2011.06.10.23:38 /
Java

comment 0 :
trackback 0

Pagetop

home prev »

Pagetop