1. Red Hat カスタマーポータルにログインします。
2. ダウンロードをクリックします。
3. 製品のダウンロードリストで Red Hat JBoss Enterprise Application Platform をクリックします。
4. Version ドロップダウンメニューで 7.1 を選択します。
5. 表で Red Hat JBoss Enterprise Application Platform 7.1.0 Quickstarts を見つけ、Download をクリックします。
6. ZIP ファイルを希望の場所に保存します。
7. Zip ファイルを展開します。

1. JBoss Developer Studio を起動します。
2. File → Import と選択します。

3. Maven → Existing Maven Projects と選択し、Next をクリックします。

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

   

4. 希望のクイックスタートのディレクトリー (helloworld など) を参照し、OK をクリックします。Projects リストボックスに、選択したクイックスタートプロジェクトの pom.xml ファイルが示されます。

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

   
5. Finish をクリックします。

1. サーバーを定義していない場合は、JBoss EAP サーバーを JBoss Developer Studio に追加します。『Getting Started with JBoss Developer Studio Tools』の「Using Runtime Detection to Set Up JBoss EAP from within the IDE」を参照してください。

2. Project Explorer タブの helloworld プロジェクトを右クリックし、Run As → Run on Server と選択します。

   図3.3 Run As - Run on Server

   

3. サーバーリストから JBoss EAP 7.1 サーバーを選択し、Next をクリックします。

   図3.4 Run on Server

   

4. helloworld クイックスタートはすでにリストされ、サーバーで設定できる状態です。Finish をクリックしてクイックスタートをデプロイします。

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

   

5. 結果を検証します。

   • Server タブで、JBoss EAP 7.1 サーバーの状態が Started に変わります。

   • Console タブに、JBoss EAP サーバーの起動と helloworld クイックスタートのデプロイメントに関するメッセージが表示されます。

     WFLYUT0021: Registered web context: /helloworld
     WFLYSRV0010: Deployed "helloworld.war" (runtime-name : "helloworld.war")

   • helloworld アプリケーションは http://localhost:8080/helloworld で使用でき、Hello World! というテキストが表示されます。

1. bean-validation クイックスタートを JBoss Developer Studio にインポートします。
2. Servers タブでサーバーを右クリックし、Start を選択して JBoss EAP サーバーを起動します。Servers タブが表示されない場合またはサーバーが未定義の場合は、JBoss EAP サーバーを JBoss Developer Studio に追加します。『Getting Started with JBoss Developer Studio Tools』の「Using Runtime Detection to Set Up JBoss EAP from within the IDE」を参照してください。
3. Project Explorer タブの bean-validation プロジェクトを右クリックし、Run As → Maven Build と選択します。

4. 以下を Goals 入力フィールドに入力し、Run を実行します。

   clean verify -Parq-remote

   図3.6 設定の編集

   

5. 結果を検証します。

   Console タブに 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] ------------------------------------------------------------------------

コマンドラインでの helloworld クイックスタートの実行

1. helloworld クイックスタートのルートディレクトリーにある README.md ファイルを確認します。

2. JBoss EAP サーバーを起動します。

   $ EAP_HOME/bin/standalone.sh

3. helloworld クイックスタートディレクトリーへ移動します。

4. クイックスタートの README.md ファイルにある Maven コマンドを使用して、クイックスタートをビルドおよびデプロイします。

   $ mvn clean install wildfly:deploy

5. helloworld アプリケーションは http://localhost:8080/helloworld で使用でき、Hello World! というテキストが表示されます。

1. Random.java 修飾子コードの検証

   修飾子は、型を基にしたインジェクションの対象となる 2 つの bean 間のあいまいさを取り除くために使用されます。修飾子に関する情報は、 JBoss EAP『開発ガイド』の「修飾子を使用したあいまいなインジェクションの解決」を参照してください。@Random 修飾子は乱数のインジェクトに使用されます。

   @Target({ TYPE, METHOD, PARAMETER, FIELD })
   @Retention(RUNTIME)
   @Documented
   @Qualifier
   public @interface Random {
   
   }

2. MaxNumber.java 修飾子コードの検証

   @MaxNumber qualifier は最大許可数の挿入に使用されます。

   @Target({ TYPE, METHOD, PARAMETER, FIELD })
   @Retention(RUNTIME)
   @Documented
   @Qualifier
   public @interface MaxNumber {
   }

3. Generator.java コードの検証

   Generator クラスは、producer メソッドを介して乱数を作成し、producer メソッドを介して最大可能数を公開します。このクラスはアプリケーションスコープであるため、毎回異なる乱数になることはありません。

   @SuppressWarnings("serial")
   @ApplicationScoped
   public class Generator implements Serializable {
   
       private java.util.Random random = new java.util.Random(System.currentTimeMillis());
   
       private int maxNumber = 100;
   
       java.util.Random getRandom() {
           return random;
       }
   
       @Produces
       @Random
       int next() {
           // a number between 1 and 100
           return getRandom().nextInt(maxNumber - 1) + 1;
       }
   
       @Produces
       @MaxNumber
       int getMaxNumber() {
           return maxNumber;
       }
   }

4. Game.java コードの検証

   セッションスコープのクラス Game は、アプリケーションのプライマリーエントリーポイントであり、ゲームの設定や再設定、ユーザーが選択する数字のキャプチャーや検証、FacesMessage によるユーザーへのフィードバック提供を行います。コンストラクト後の lifecycle メソッドを使用し、@Random Instance<Integer> bean から乱数を取得することによりゲームを初期化します。

   このクラスの @Named アノテーションを見てください。このアノテーションは式言語 (EL) を使用して Bean が JSF ビューにアクセスできるようにしたい場合のみ必要です。この場合 #{game} が EL になります。

   @SuppressWarnings("serial")
   @Named
   @SessionScoped
   public class Game implements Serializable {
   
       /**
        * The number that the user needs to guess
        */
       private int number;
   
       /**
        * The users latest guess
        */
       private int guess;
   
       /**
        * The smallest number guessed so far (so we can track the valid guess range).
        */
       private int smallest;
   
       /**
        * The largest number guessed so far
        */
       private int biggest;
   
       /**
        * The number of guesses remaining
        */
       private int remainingGuesses;
   
       /**
        * The maximum number we should ask them to guess
        */
       @Inject
       @MaxNumber
       private int maxNumber;
   
       /**
        * The random number to guess
        */
       @Inject
       @Random
       Instance<Integer> randomNumber;
   
       public Game() {
       }
   
       public int getNumber() {
           return number;
       }
   
       public int getGuess() {
           return guess;
       }
   
       public void setGuess(int guess) {
           this.guess = guess;
       }
   
       public int getSmallest() {
           return smallest;
       }
   
       public int getBiggest() {
           return biggest;
       }
   
       public int getRemainingGuesses() {
           return remainingGuesses;
       }
   
       /**
        * Check whether the current guess is correct, and update the biggest/smallest guesses as needed. Give feedback to the user
        * if they are correct.
        */
       public void check() {
           if (guess > number) {
               biggest = guess - 1;
           } else if (guess < number) {
               smallest = guess + 1;
           } else if (guess == number) {
               FacesContext.getCurrentInstance().addMessage(null, new FacesMessage("Correct!"));
           }
           remainingGuesses--;
       }
   
       /**
        * Reset the game, by putting all values back to their defaults, and getting a new random number. We also call this method
        * when the user starts playing for the first time using {@linkplain PostConstruct @PostConstruct} to set the initial
        * values.
        */
       @PostConstruct
       public void reset() {
           this.smallest = 0;
           this.guess = 0;
           this.remainingGuesses = 10;
           this.biggest = maxNumber;
           this.number = randomNumber.get();
       }
   
       /**
        * A JSF validation method which checks whether the guess is valid. It might not be valid because there are no guesses left,
        * or because the guess is not in range.
        *
        */
       public void validateNumberRange(FacesContext context, UIComponent toValidate, Object value) {
           if (remainingGuesses <= 0) {
               FacesMessage message = new FacesMessage("No guesses left!");
               context.addMessage(toValidate.getClientId(context), message);
               ((UIInput) toValidate).setValid(false);
               return;
           }
           int input = (Integer) value;
   
           if (input < smallest || input > biggest) {
               ((UIInput) toValidate).setValid(false);
   
               FacesMessage message = new FacesMessage("Invalid guess");
               context.addMessage(toValidate.getClientId(context), message);
           }
       }
   }