同じテスト・ステップを繰り返し行う場合、自動テストがあると、時間と手間が節約できます。この記事では、Webアプリケーション用のテスト・ケース開発に利用できるJavaクラス・セット、jWebUnitを紹介します。jWebUnitはオープンソースのプロジェクトであり、BSDライセンスの下で、自由に使用することができます。この記事では、jWebUnitライブラリーのダウンロード方法やjWebUnitテスト・ケースを開発するためのEclipseプラットフォームの構成方法、サンプル・テスト・ケースの構築方法などを説明します。

jWebUnitの紹介

jWebUnitは、Webアプリケーション自動テスト用のJavaライブラリーであるHttpUnitと、JUnitユニット・テスト・フレームワークに基づいています（参考文献を見てください）。jWebUnitは、Webアプリケーションのナビゲーション用に高位レベルのAPIを備えており、また、ナビゲーションの正しさをリンク経由で検証するための一連のアサーション、フォーム入力や送信、テーブル内容その他、ビジネス用Webアプリケーションに通常必要とされる機能も備えています。jWebUnitはJARファイルの形で提供されるため、大部分のIDEに容易にプラグインできますが、その他にも、必要とされるライブラリーを含んでいます。

HttpUnitでテストする

Webアプリケーションを自動化するということは、Webブラウザーをバイパスし、プログラムを通してWebサイトを操作することを意味します。まず、JWebUnitの構成ブロックであるHttpUnitによって、これが単純にできることを示しましょう。HttpUnitは、フレームやJavaScript、ページ・リダイレクション・クッキーなどをエミュレートすることができます。HttpUnitはJUnitと組み合わされると、Webサイトが動作しているかどうかを素早く検証することができます。

リスト1は、HttpUnitホームページにある「Cookbook」リンクをクリックするための、HttpUnitで書いたサンプル・テスト・ケースです。

                
1 public class HttpUnitTest {
2  public static void main(String[] args) {
3    try {
4      WebConversation wc = new WebConversation();
5      WebRequest request = 
            new GetMethodWebRequest("http://httpunit.sourceforge.net/index.html");
6      wc.setProxyServer( "your.proxy.com", 80 );
7      WebResponse response = wc.getResponse(request);
8      WebLink httpunitLink = 
            response.getFirstMatchingLink(WebLink.MATCH_CONTAINED_TEXT,"Cookbook");
9      response = httpunitLink.click();
10      System.out.println("Test successful !!");
11    } catch (Exception e) {
12      System.err.println("Exception: " + e);
13    }
14  }
15 }                            

リスト1のコードは、your.proxy.com（6行目）を使ってインターネットに接続します。インターネットに直接接続できる場合には、このステートメントはコメント行にすることができます。8行目のステートメントは、Cookbook という文字列を含む、Webリンク用のページを検索します。9行目のステートメントは、そのリンクをクリックします。リンクが見つかると、Test Successful !!というメッセージが表示されます。

jWebUnitを使った、さらに簡単なテスト

リスト2のテスト・ケースは、jWebUnit APIを使って、リスト1と同じことを行います。

                
1 public class JWebUnitTest extends WebTestCase{
2  public static void main(String[] args){
3    junit.textui.TestRunner.run(new TestSuite(JWebUnitTest.class));
4  }
5  public void setUp(){
6    getTestContext().setBaseUrl("http://httpunit.sourceforge.net");
7    getTestContext().setProxyName("webproxy.watson.ibm.com");
8    getTestContext().setProxyPort(8080);
9  }
10  public void testSearch(){
11    beginAt("/index.html");
12    clickLinkWithText("Cookbook");
13  }
14 }

リスト2で、JUnit特有のコードを無視すれば、テスト・ケースが非常にきれいに、簡潔になっていることが分かるでしょう。注目すべき重要な行は、6行目、11行目、12行目です。6行目では、ベースURLがHttpUnitのホームページに設定されています。11行目は、相対パス/index.htmlにあるサイトに接続します。12行目は、そのページにある、文字列Cookbookを持つリンクをクリックします。クリックが動作すれば成功をレポートし、動作しない場合には、例外をレポートします。

上に戻る

jWebUnit APIを詳しく見る

どのjWebUnitテスト・ケースにも、その中心には、テスト・ケースを表すnet.sourceforge.jwebunit.WebTestCaseクラスがあります。テスト・ケースはすべて、このクラスから継承する必要があります。（net.sourceforge.jwebunit.WebTestCaseクラス自体は、JUnitでテスト・ケースを表現するjunit.framework.TestCaseから継承されています。）表1は、このクラスにあるメソッドのうち、一般的に使われるものを示しています。

もう1つ重要なクラスは、net.sourceforge.jwebunit.TestContextです。このクラスは、テスト用のコンテキストを確立します。このクラスを使って、クッキーやセッション、認証などの情報を操作することができます。表2は、このクラスにあるメソッドのうち、重要なものの幾つかを示しています。

上に戻る

EclipseでjWebUnitをダウンロードし、設定する

jWebUnitは純粋なJavaコードとして実装されているため、JARファイルとして入手できます（ダウンロード・リンクについては参考文献を見てください）。ダウンロードしたら、次のステップに従って、Eclipseプラットフォーム上でjWebUnitライブラリーを設定します。

1. ダウンロードしたファイル（jwebunit-1.2.zip）を、一時ディレクトリー（ここでは、C:\tempとします）で解凍します。
2. Eclipseで、jWebUnitという名前の新しいJavaプロジェクトを作ります。
3. Package ExplorerビューでjWebUnitプロジェクトを右クリックし、Propertiesを選択します。
4. Java Build Pathをクリックします。Librariesタブで、Add External JARsをクリックします。
5. C:\temp\jwebunit-1.2\libディレクトリーに行き、このディレクトリーにある、全てのJARファイルを選択します。
6. OKをクリックします。

これで、jWebUnitというプロジェクトの下に、EclipseでjWebUnitテスト・ケースの開発を開始することができます。

上に戻る

サンプル・アプリケーションを作る

今度は、jWebUnit APIの実際の動作を見る番です。jWebUnitの真の力をよく理解できるように、順を追ってサンプル・アプリケーションを説明しましょう。このアプリケーションは、Googleの検索ページを開き、文字列HttpUnitを検索するテスト・ケースです。このアプリケーションで、次のようなシナリオをテストします。

• Googleのホームページ、http://www.google.comを開きます。
• ページは名前qを持つフォーム要素を含む、とアサートします。（Googleのホームページでは、qという名前のテキスト・ボックスは、ユーザー・クエリーを入力とするものを意味します。）アプリケーションは、この要素を使って検索基準を入力します。
• 検索テキスト・ボックスに文字列HttpUnit Homeを入力し、フォームを送信します。
• 結果ページを取得し、そのページが文字列HttpUnit Homeを含むリンクを含んでいるとアサートします。
• 文字列HttpUnit Home上にあるリンクをクリックします。

テスト・シナリオの準備ができたので、jWebUnitを使ってこうした要求事項を実装する、Javaアプリケーションを書きます。

最初のステップは、リスト3に示すように、WebTestCaseから継承するクラスを宣言することです。

                
public class GoogleTest extends WebTestCase {
   static String searchLink = ";
}

先に触れたように、jWebUnitは、全てのテスト・ケースがWebTestCaseから継承するように要求します。searchLinkは、検索用に渡された引数を保管します。この値を、コマンドライン・パラメーターとして、テスト・ケースに渡します。

次のステップは、エントリー・ポイント、つまりmain()メソッド、を宣言します。これをリスト4に示します。

                
public static void main(String[] args) {
   searchLink = args[0];
   junit.textui.TestRunner.run(new TestSuite(GoogleTest.class));
}

main()メソッドは、junit.textui.TestRunner.run()を呼ぶことによって、JTestテスト・ケースを実行します。ここではGoogleTestテスト・ケースを実行する必要があるため、パラメーターとしてrun()メソッドに渡すテスト・スイートは、引数としてGoogleTest.classを取ります。

JTestは次にsetUp()メソッドを呼び、ベースURLとプロキシーを設定します。これをリスト5に示します。

                
public void setUp() {
   getTestContext().setBaseUrl("http://www.google.com");
   getTestContext().setProxyName("proxy.host.com");
   getTestContext().setProxyPort(80);
}

リスト5は、ベースURLをhttp://www.google.comに設定します。これによって、このURLを相対的な基準としてテスト・ケースが開始することになります。次の2つのステートメントは、インターネットに接続するためのプロキシー・ホストと、プロキシー・ポートを設定します。直接インターネットに接続している場合には、プロキシー設定のステートメントを省略することができます。

今度は、サイトのブラウズと、サーチ基準の入力を始めます。リスト6は、Webページにアクセスし、全てのシナリオをテストするためのコードです。

                
public void testSearch() {
   beginAt("/");
   assertFormElementPresent("q");
   setFormElement("q", "HttpUnit");
   submit("btnG");
   assertLinkPresentWithText(searchLink);
   clickLinkWithText(searchLink);
}

リスト6のコードは、ベースURLに接続し、/ を相対基準としてブラウズを開始します。次に、このページがqという名前のフォーム要素を含むことをアサートします（qは、Googleのホームページ上の、クエリー入力テキスト・ボックスの名前です）。次のステートメントは、qという名前を持つテキスト・ボックスを、値HttpUnitに設定します。その次のステートメントは、btnGという名前のフォーム送信ボタンを送信します。（Googleのホームページでは、btnGという名前のボタンは、Google Searchというラベルの付いたボタンです。）この会話でフォームは送信され、その次のページで検索結果がリストアップされます。結果ページでは、コードはまず、文字列HttpUnit Home を含むリンクがあるかどうかをチェックします。リンクがない場合には、テストはAssertionFailedErrorでフェールします。リンクがある場合には、テストはそのリンクをクリックします。

上に戻る

サンプル・アプリケーションを実行する

では、サンプル・アプリケーションを動かしてみましょう。

1. サンプル・アプリケーション、j-webunitsample.jarをダウンロードします（ダウンロードのセクションを見てください）。
2. どこかのディレクトリーでj-webunitsample.jarを解凍します。例えばC:\tempで解凍すると、ソースファイルとクラスファイルはC:\temp\com\jweb\testに置かれ、そしてsetclasspth.batがC:\tempに置かれます。
3. setclasspath.batを編集します。JAR_BASEを、必要なJAR全てを含むディレクトリーを指すように設定します。例えば、C:\tempの下でjwebunit-1.2.zipファイルを解凍した場合は、JAR_BASEをC:\temp\jwebunit-1.2\libに設定します。
4. コマンド・プロンプトを開き、ディレクトリーをC:\tempに変更します。
5. setclasspath.batを実行します。これによって、テスト・ケースを実行するために必要なCLASSPATHが設定されます。
6. アプリケーションを、コマンド、java com.jweb.test.GoogleTest "HttpUnit Home"で実行します。

サンプル出力

テスト・ケースを実行すると、コマンド・プロンプトにテスト・ケース・レポートが出力されます。テストが失敗すると、レポートはリスト7のようなものになります。

                
C:\temp>java com.jweb.test.GoogleTest "HttpUnit Hwee"
.F
Time: 5.338
There was 1 failure:
1) testSearch(com.jweb.test.GoogleTest)junit.framework.AssertionFailedError: Link 
  with text [HttpUnit Hwee] not found in response.
at net.sourceforge.jwebunit.WebTester.assertLinkPresentWithText(WebTester.java:618)
at net.sourceforge.jwebunit.WebTestCase.assertLinkPresentWithText(WebTestCase.java:244)
        at com.jweb.test.GoogleTest.testSearch(GoogleTest.java:36)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
        at com.jweb.test.GoogleTest.main(GoogleTest.java:19)

FAILURES!!!
Tests run: 1,  Failures: 1,  Errors: 0

リスト7を見ると分かる通り、テスト・ケースはHttpUnit Hweeをパラメーターとして実行されています。このテスト・ケースはアサーションでフェールしますが、これは結果ページに、この文字列を持つリンクが無いためです。従ってjunit.framework.AssertionFailedErrorとなります。

リスト8は、HttpUnit Homeをパラメーターとして実行します。テスト・ケースは、この文字列を持つリンクを見つけるので、テストをパスし、次を出力します。

                
C:\temp>java com.jweb.test.GoogleTest "HttpUnit Home"
.
Time: 6.991

OK (1 test)

上に戻る

まとめ

この記事では、jWebUnitフレームワークの注目すべき機能や、最も重要なクラスなどを議論しながら、簡単なテスト・ケースの作り方を通して、jWebUnitフレームワークの一端を簡単に紹介しました。jWebUnitには、テスト・ケースで使えるような機能が、他にも数多くあります。例えば、Webページ上にあるリンクの数をカウントすることができます。Webページの中に文字列やテーブル、指定のラベルを持つフォーム入力要素などがあるかどうかをアサートすることができます。クッキーがあるとアサートしたりクッキーを削除したりするなど、クッキーをいじることもできます。あるいは、別の文字列の後に現れる特定な文字列に対するリンクを、テストにクリックさせることもできます。Webアプリケーション用のテスト・ケースを、素早く効率良く構築したい場合には、jWebUnitが最適だと言えるでしょう。

上に戻る

ダウンロード

ダウンロード形式について

参考文献

• この記事の先頭または最後にあるCodeアイコンをクリックして（またはダウンロードを見てください）、この記事で使用しているソースコードをダウンロードしてください。
  
  
• jWebUnitライブラリーをダウンロードしてください。
  
  
• jWebUnitのWebサイトには、jWebUnitに関する資料が豊富に用意されています。
  
  
• HttpUnitのWebサイトを見て、このプロジェクトについて学んでください。
  
  
• WebSphere StudioでのHttpUnitの使い方を学ぶために、「HttpUnit: A Civilized Way to Test Web Applications in WebSphere Studio」（developerWorks, 2003年3月）を読んでください。
  
  
• jWebUnitで使用されているJUnitは、Javaプラットフォーム用のユニット・テスト・フレームワークとしてデファクト標準となっています。
  
  
• 「StrutsTestCase simplifies the development process」（developerWorks, 2005年1月）を読んで、StrutsベースのWebアプリケーションをテストするための、オープンソース・フレームワークについて学んでください。
  
  
• developerWorksのJava technologyゾーンには、Javaプログラミングのあらゆる面に関する記事が豊富に用意されています。
  
  
• Developer Bookstoreには、Java関連の技術書を含めて、広範な話題を網羅した書籍が豊富に取り揃えられていますので、ぜひご覧ください。
  
  

著者について

この記事を評価する

コメント

上に戻る

目次

• jWebUnitの紹介
• jWebUnit APIを詳しく見る
• EclipseでjWebUnitをダウンロードし、設定する
• サンプル・アプリケーションを作る
• サンプル・アプリケーションを実行する
• まとめ
• ダウンロード
• 参考文献
• 著者について
• コメント