Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

第5章 やってみよう

5.1. クイックスタートを実行する

5.1.1. Red Hat JBoss Developer Studio でクイックスタートを実行します

このセクションでは、Red Hat JBoss Developer Studio を使用してクイックスタートをデプロイし、Arquillian テストを実行する方法について説明します。

手順5.1 クイックスタートを Red Hat JBoss Developer Studio にインポートします

各クイックスタートには、クイックスタートのプロジェクトおよび設定情報を含む POM(プロジェクトオブジェクトモデル) ファイルが付属しています。この POM ファイルを使用すると、クイックスタートを Red Hat JBoss Developer Studio に簡単にインポートできます。
重要
Red Hat JBoss Developer Studio へのインポート時にクイックスタートプロジェクトフォルダーが IDE ワークスペース内にある場合、IDE は無効なプロジェクト名と WAR アーカイブ名を生成します。作業を開始する前に、クイックスタートプロジェクトフォルダーが IDE ワークスペースの外部にあることを確認してください。
  1. Red Hat JBoss Developer Studio を起動します。
  2. メニューから FileImport を選択します。
  3. 選択リストで、MavenExisting Maven Projects を選択し、Next をクリックします。

    図5.1 既存の Maven プロジェクトのインポート

    既存の Maven プロジェクトのインポート
  4. テストする予定のクイックスタートのディレクトリー (たとえば、helloworld クイックスタート) を参照し、OK をクリックします。Projects リストボックスに、選択したクイックスタートプロジェクトの pom.xml ファイルが示されます。

    図5.2 Maven プロジェクトの選択

    Maven プロジェクトの選択
  5. Finish をクリックします。

手順5.2 helloworld クイックスタートをビルドしてデプロイする

helloworld クイックスタートは最もシンプルなクイックスタートの 1 つであり、JBoss サーバーが正しく設定され実行されていることを確認するための良い方法です。
  1. Servers タブが表示されない場合、またはサーバーをまだ定義していない場合は、次の手順に従ってください。「Define New Server を使用して JBossEAP サーバーを追加します」full プロファイルまたは追加のスタートアップ引数を必要とするクイックスタートをデプロイする場合は、クイックスタートの手順に記載されているように、必ずサーバーランタイム環境を作成してください。
  2. Project Explorer タブで jboss-helloworld プロジェクトを右クリックし、Run As を選択します。選択肢のリストが提供されます。Run on Server を選択します。

    図5.3 Run As - Run on Server

    Run As - Run on Server
  3. サーバーリストから JBoss EAP 6.1+ Runtime Server を選択し、Next をクリックします。

    図5.4 Run on Server

    Run on Server
  4. 次の画面には、サーバーで設定されているリソースが表示されます。jboss-helloworld クイックスタートが設定されています。Finish をクリックしてクイックスタートをデプロイします。

    図5.5 サーバーで設定されたリソースの変更

    サーバーで設定されたリソースの変更
  5. 結果を表示します。
    • Server タブで、JBoss EAP 6.x ランタイムサーバーのステータスが [Started, Republish] に変わります。
    • サーバーの Console タブには、JBoss EAP 6.x サーバーの起動と helloworld クイックスタートのデプロイメントの詳細を示すメッセージが表示されます。
    • URL (http://localhost:8080/jboss-helloworld/HelloWorld) とテキスト Hello World! を示す helloworld タブが表示されます。
    • Console の次のメッセージは、jboss-helloworld.war ファイルのデプロイを確認します。
      JBAS018210: Register web context: /jboss-helloworld
      JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
      
      登録された Web コンテキストは http://localhost:8080 に追加され、デプロイされたアプリケーションへのアクセスに使用される URL を提供します。
  6. JBoss サーバーに正常にデプロイされた helloworld クイックスタートを確認するには、Web ブラウザーを開き、次の URL でアプリケーションにアクセスします。http://localhost:8080/jboss-helloworld

手順5.3 bean-validation クイックスタート Arquillian テストの実行

一部のクイックスタートは、ユーザーインターフェイスレイヤーを提供せず、代わりにコード例を示すための Arquillian テストを提供します。bean-validation クイックスタートは、Arquillian テストを提供するクイックスタートの例です。
  1. 上記の手順に従って、bean-validation クイックスタートを Red Hat JBoss Developer Studio にインポートします。
  2. Servers タブでサーバーを右クリックし、Start を選択して JBoss EAP サーバーを起動します。Servers タブが表示されない場合、またはサーバーをまだ定義していない場合は、次の手順に従ってください。「Define New Server を使用して JBossEAP サーバーを追加します」
  3. Project Explorer タブで jboss-bean-validation プロジェクトを右クリックし、Run As を選択します。選択肢のリストが提供されます。Maven Build を選択します。
  4. Edit Configuration ダイアログの Goals 入力フィールドに、次のように入力します clean test -Parq-jbossas-remote
    次に、Run をクリックします。

    図5.6 設定の編集

    設定の編集
  5. 結果を表示します。
    サーバーの Console タブには、JBoss EAP サーバーの起動と bean-validation クイックスタート Arquillian テストの出力の詳細を示すメッセージが表示されます。
    -------------------------------------------------------
     T E S T S
    -------------------------------------------------------
    Running org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
    Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.189 sec
    
    Results :
    
    Tests run: 5, Failures: 0, Errors: 0, Skipped: 0
    
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    

5.1.2. コマンドラインを使用してクイックスタートを実行する

手順5.4 コマンドラインを使用してクイックスタートをビルドおよびデプロイする

コマンドラインを使用して、クイックスタートを簡単にビルドおよびデプロイできます。コマンドラインを使用する場合、必要に応じて JBoss サーバーを起動する必要があることに注意してください。
  1. クイックスタートのルートディレクトリーにある README.html ファイルを確認します。
    このファイルには、システム要件、Maven の設定方法、ユーザーの追加方法、およびクイックスタートの実行方法に関する一般的な情報が含まれています。始める前に必ず読んでください。
    また、利用可能なクイックスタートを一覧表示する表も含まれています。この表には、各クイックスタート名とそれが示すテクノロジーがリストされています。各クイックスタートと、それを設定するために必要な経験のレベルについて簡単に説明します。クイックスタートの詳細は、クイックスタート名をクリックしてください。
    一部のクイック起動は、他のクイック起動を強化または拡張するように設計されています。これらは、Prerequisites の列に記載されています。クイックスタートに前提条件がリストされている場合は、クイックスタートを使用する前にまずそれらをインストールする必要があります。
    一部のクイックスタートでは、オプションのコンポーネントのインストールと設定が必要です。クイックスタートで必要な場合を除いて、これらのコンポーネントをインストールしないでください。
  2. helloworld クイックスタートを実行します。
    helloworld クイックスタートは最もシンプルなクイックスタートの 1 つであり、JBoss サーバーが正しく設定され実行されていることを確認するための良い方法です。helloworld クイックスタートのルートにある README.html ファイルを開きます。クイックスタートをビルドしてデプロイし、実行中のアプリケーションにアクセスする方法の詳細な手順が含まれています
  3. 他のクイックスタートを実行します。
    各クイックスタートのルートフォルダーにある README.html ファイルの指示に従って、例を実行します。