開発ガイド

1. https://access.redhat.com/ にアクセスします。
2. ページの上部にあるメニューから Downloads を選択します。
3. リストから Red Hat Developer Studio を見つけて、クリックします。
4. 適切なバージョンを選択し、Download をクリックします。

手順1.1 Install Red Hat JBoss Developer Studio

1. Open a terminal.
2. ダウンロードした .jar ファイルを含むディレクトリーに移動します。
3. 次のコマンドを実行して、GUI インストーラーを起動します。

   java -jar jbdevstudio-build_version.jar

   Copy to Clipboard Toggle word wrap
4. Next をクリックして、インストールプロセスを開始します。
5. I accept the terms of this license agreement を選択し、Next をクリックします。
6. インストールパスを調整し、Next をクリックします。
   注記
   インストールパスフォルダーが存在しない場合は、プロンプトが表示されます。OK をクリックしてフォルダーを作成します。
7. JVM を選択するか、デフォルトの JVM を選択したままにして、Next をクリックします。
8. 使用可能なアプリケーションプラットフォームを追加し、Next をクリックします。
9. インストールの詳細を確認し、Next をクリックします。
10. インストールプロセスが完了したら、Next をクリックします。
11. Red Hat JBoss Developer Studio のデスクトップショートカットを設定し、Next をクリックします。
12. 完了 をクリックします。

手順1.2 Red Hat JBoss Developer Studio を起動するコマンド

1. Open a terminal.
2. インストールディレクトリーに移動します。
3. 次のコマンドを実行して、Red Hat JBoss Developer Studio を起動します。

   [localhost]$ ./jbdevstudio

   Copy to Clipboard Toggle word wrap

手順1.3 サーバーを追加します

1. Servers タブを開きます。Servers タブがない場合は、次のようにパネルに追加します。
   1. Window → Show View → Other...をクリックします。
   2. Server フォルダーから Servers を選択し、OK をクリックします。
2. 以下をクリックします、No servers are available。このリンクをクリックして、新しいサーバーを作成します。または、必要に応じて、空白のサーバーパネル内を右クリックし、New → Server を選択します。

   図1.1 新しいサーバーを追加する - No servers available

   

   View larger image

   

   
   [D]
3. JBoss Enterprise Middleware を展開し、JBoss Enterprise Application Platform 6.1+ を選択します。JBoss Enterprise Application Platform 6.4 などのサーバー名を入力し、Next をクリックして JBoss ランタイムを作成し、サーバーを定義します。次回新しいサーバーを定義するとき、このダイアログには、新しいランタイム定義を含む Server runtime environment の選択が表示されます。

   図1.2 新しいサーバーを定義する

   

   View larger image

   

   
   [D]
4. サーバーの起動と停止を管理するサーバーアダプターを作成します。デフォルトのままにして、Next をクリックします。

   図1.3 新しいサーバーアダプターを作成する

   

   View larger image

   

   
   [D]
5. JBoss EAP 6.4 Runtime などの名前を入力します。Home Directory で、Browse をクリックして、JBoss EAP のインストール場所に移動します。Next をクリックします。

   図1.4 新しいサーバーランタイム環境を追加する

   

   View larger image

   

   
   [D]
   注記
   一部のクイックスタートでは、別のプロファイルまたは追加の引数を使用してサーバーを実行する必要があります。full プロファイルを必要とするクイックスタートをデプロイするには、新しいサーバーを定義し、Configuration file に standalone-full.xml を指定する Server Runtime Environment を追加する必要があります。新しいサーバーにはわかりやすい名前を付けてください。
6. 新しいサーバー用に既存のプロジェクトを設定します。この時点ではプロジェクトがないため、Finish をクリックします。

   図1.5 新しい JBoss サーバーのリソースを変更します

   

   View larger image

   

   
   [D]

手順1.4 クイックスタートのダウンロード

1. Web ブラウザーを開き、次の URL にアクセスします。https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=appplatform。
2. リストからクイックスタートを見つけます。
3. Download ボタンをクリックして、例を含む Zip アーカイブをダウンロードします。
4. 選択したディレクトリーでアーカイブを解凍します。

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

1. まだ行っていない場合は、 「Maven 設定を使用した JBoss EAP 6 Maven リポジトリーの設定」。

2. Red Hat JBoss Developer Studio を起動します。

3. メニューから File → Import を選択します。

4. 選択リストで、Maven → Existing Maven Projects を選択し、Next をクリックします。

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

   

   View larger image

   

   
   [D]

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

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

   

   View larger image

   

   
   [D]

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

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

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

   図1.9 Run As - Run on Server

   

   View larger image

   

   
   [D]
3. サーバーリストから JBoss EAP 6.1+ Runtime Server を選択し、Next をクリックします。

   図1.10 Run on Server

   

   View larger image

   

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

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

   

   View larger image

   

   
   [D]
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")
     

     Copy to Clipboard Toggle word wrap

     登録された Web コンテキストは http://localhost:8080 に追加され、デプロイされたアプリケーションへのアクセスに使用される URL を提供します。
6. JBoss サーバーに正常にデプロイされた helloworld クイックスタートを確認するには、Web ブラウザーを開き、次の URL でアプリケーションにアクセスします。http://localhost:8080/jboss-helloworld

手順1.7 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 をクリックします。

   図1.12 設定の編集

   

   View larger image

   

   
   [D]
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] ------------------------------------------------------------------------
   

   Copy to Clipboard Toggle word wrap

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

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

手順1.9 ディレクトリー構造の確認

1. Beans.xml ファイルは、クイックスタートの src/main/webapp/ ディレクトリーの WEB-INF/ フォルダーにあります。
2. src/main/webapp/ ディレクトリーには、シンプルなメタリフレッシュを使用してユーザーのブラウザーをサーブレットにリダイレクトする index.html ファイルも含まれており、これはhttp://localhost:8080/jboss-helloworld/HelloWorldに配置されています。
3. この例のすべての設定ファイルは、WEB-INF/ にあります。これは、例の src/main/webapp/ ディレクトリーにあります。
4. クイックスタートには web.xml ファイルも必要ないことに注意してください。

手順1.10 コードの確認

1. HelloWorldServlet コードを確認します。

   HelloWorldServlet.java ファイルは src/main/java/org/jboss/as/quickstarts/helloworld/ ディレクトリーにあります。このサーブレットが情報をブラウザーに送ります。

   42.  @SuppressWarnings("serial")
   43.  @WebServlet("/HelloWorld")
   44.  public class HelloWorldServlet extends HttpServlet {
   45.  
   46.      static String PAGE_HEADER = "<html><head><title>helloworld</title></head><body>";
   47.  
   48.      static String PAGE_FOOTER = "</body></html>";
   49.  
   50.      @Inject
   51.      HelloService helloService;
   52.  
   53.      @Override
   54.      protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
   55.          resp.setContentType("text/html");
   56.          PrintWriter writer = resp.getWriter();
   57.          writer.println(PAGE_HEADER);
   58.          writer.println("<h1>" + helloService.createHelloMessage("World") + "</h1>");
   59.          writer.println(PAGE_FOOTER);
   60.          writer.close();
   61.      }
   62.  
   63.  }
   

   Copy to Clipboard Toggle word wrap
   Expand

   表1.1 HelloWorldServlet の詳細

   行	注記
   43	Java EE 6 より前は、XML ファイルを使用してサーブレットを登録していました。よりきれいになりました。必要な作業は @WebServlet アノテーションを追加し、サーブレットにアクセスするために使用する URL にマッピングを提供するだけです。
   46〜48	各 Web ページには適切な形式の HTML が必要になります。本クイックスタートは静的な文字列を使用して最低限のヘッダーとフッターの出力を書き出します。
   50〜51	これらの行は、実際のメッセージを生成する HelloService CDI Bean を挿入します。HelloService の API を変更しない限り、ビューレイヤーを変更せずに HelloService の実装を後で変更することが可能です。
   58	この行はサービスを呼び出し、「Hello World」というメッセージを生成して HTTP 要求へ書き出します。

   Show more

2. HelloService コードを確認します

   HelloService.java ファイルは src/main/java/org/jboss/as/quickstarts/helloworld/ ディレクトリーにあります。このサービスはとてもシンプルです。メッセージを返します。XML やアノテーションの登録は必要ありません。

   public class HelloService {
   
       String createHelloMessage(String name) {
           return "Hello " + name + "!"; 
       }
   }
   

   Copy to Clipboard Toggle word wrap

手順1.11 設定ファイルの確認

1. faces-config.xml ファイルを確認します。
   本クイックスタートは faces-config.xml ファイル名の JSF 2.0 バージョンを使用します。Facelets の標準化されたバージョンは JSF 2.0 のデフォルトのビューハンドラーであるため、実際に設定する必要はありません。JBoss EAP 6 は、ここで JavaEE を超えています。この設定ファイルを含めると、JSF が自動的に設定されます。その結果、設定はルート要素のみで設定されます。

   19. <faces-config version="2.0"
   20.    xmlns="http://java.sun.com/xml/ns/javaee"
   21.    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   22.    xsi:schemaLocation="
   23.       http://java.sun.com/xml/ns/javaee>
   24.       http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd">
   25.      
   26. </faces-config>
   

   Copy to Clipboard Toggle word wrap
2. beans.xml ファイルを確認します。
   空の beans.xml ファイルもあります。これは、JBoss EAP 6 にこのアプリケーションで Bean を検索し、CDI をアクティブ化するように指示します。
3. web.xml ファイルはありません
   クイックスタートには web.xml ファイルも必要ないことに注意してください。

手順1.12 JSF コードの確認

• home.xhtml コードを調べます。
  home.xhtml ファイルは src/main/webapp/ ディレクトリーにあります。

  19. <html xmlns="http://www.w3.org/1999/xhtml"
  20.    xmlns:ui="http://java.sun.com/jsf/facelets"
  21.    xmlns:h="http://java.sun.com/jsf/html"
  22.    xmlns:f="http://java.sun.com/jsf/core">
  23.
  24. <head>
  25. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  26. <title>Numberguess</title>
  27. </head>
  28.
  29. <body>
  30.    <div id="content">
  31.       <h1>Guess a number...</h1>
  32.       <h:form id="numberGuess">
  33.
  34.          <!-- Feedback for the user on their guess -->
  35.          <div style="color: red">
  36.             <h:messages id="messages" globalOnly="false" />
  37.             <h:outputText id="Higher" value="Higher!"
  38.                rendered="#{game.number gt game.guess and game.guess ne 0}" />
  39.             <h:outputText id="Lower" value="Lower!"
  40.                rendered="#{game.number lt game.guess and game.guess ne 0}" />
  41.          </div>
  42.
  43.          <!-- Instructions for the user -->
  44.          <div>
  45.             I'm thinking of a number between <span
  46.                id="numberGuess:smallest">#{game.smallest}</span> and <span
  47.                id="numberGuess:biggest">#{game.biggest}</span>. You have
  48.             #{game.remainingGuesses} guesses remaining.
  49.          </div>
  50.
  51.          <!-- Input box for the users guess, plus a button to submit, and reset -->
  52.          <!-- These are bound using EL to our CDI beans -->
  53.          <div>
  54.             Your guess:
  55.             <h:inputText id="inputGuess" value="#{game.guess}"
  56.                required="true" size="3"
  57.                disabled="#{game.number eq game.guess}"
  58.                validator="#{game.validateNumberRange}" />
  59.             <h:commandButton id="guessButton" value="Guess"
  60.                action="#{game.check}"
  61.                disabled="#{game.number eq game.guess}" />
  62.          </div>
  63.          <div>
  64.             <h:commandButton id="restartButton" value="Reset"
  65.                action="#{game.reset}" immediate="true" />
  66.          </div>
  67.       </h:form>
  68.
  69.    </div>
  70.
  71.    <br style="clear: both" />
  72.
  73. </body>
  74. </html>
  

  Copy to Clipboard Toggle word wrap
  Expand

  表1.2 JSF の詳細

  行	注記
  36〜40	これらはユーザーに送信できるメッセージ、「Higher」(より大きい) と「Lower」(より小さい) です。
  45〜48	ユーザーが数を選択するごとに数字の範囲が狭まります。有効な数の範囲が分かるようにこの文章は変更されます。
  55〜58	この入力フィールドは値式を使用して Bean プロパティーにバインドされます。
  58	ユーザーが誤って範囲外の数字を入力しないようにバリデーターのバインディングが使用されます。バリデーターがないと、ユーザーが範囲外の数字を使用する可能性があります。
  59〜61	ユーザーの選択した数字をサーバーに送る方法がなければなりません。ここでは、Bean 上のアクションメソッドをバインドします。

  Show more

手順1.13 クラスファイルの確認

1. Random.java 修飾子コードの検証
   修飾子は、型を基にしたインジェクションの対象となる 2 つの bean 間のあいまいさを取り除くために使用されます。修飾語の詳細については、以下を参照してください。 「修飾子を使用したあいまいなインジェクションの解決」
   @Random 修飾子は乱数のインジェクトに使用されます。

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

   Copy to Clipboard Toggle word wrap
2. MaxNumber.java 修飾子コードの検証
   @MaxNumber qualifier は最大許可数の挿入に使用されます。

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

   Copy to Clipboard Toggle word wrap
3. Generator.java コードの検証
   Generator クラスは、プロデューサーメソッドを介して乱数を作成するロールを果たします。また、プロデューサーメソッドを介して可能な最大数を公開します。このクラスはアプリケーションスコープであるため、毎回異なる乱数になることはありません。

   @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;
       }
   }

   Copy to Clipboard Toggle word wrap
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);
           }
       }
   }

   Copy to Clipboard Toggle word wrap

手順6.1 国際化されたログメッセージバンドルを作成する

1. メッセージロガーインターフェイスを作成する

   プロジェクトに Java インターフェイスを追加して、ログメッセージ定義を含めます。インターフェイスに定義されるログメッセージの説明的な名前を付けます。
   ログメッセージインターフェースの要件は次のとおりです。
   • 注釈を付ける必要があります@org.jboss.logging.MessageLogger。
   • 延長する必要がありますorg.jboss.logging.BasicLogger。
   • インターフェイスは、このインターフェイスを実装する型付きロガーであるフィールドを定義する必要があります。でこれを行うgetMessageLogger()の方法org.jboss.logging.Logger。

   package com.company.accounts.loggers;
   
   import org.jboss.logging.BasicLogger;
   import org.jboss.logging.Logger;
   import org.jboss.logging.MessageLogger;
   
   @MessageLogger(projectCode="")
   interface AccountsLogger extends BasicLogger
   {
      AccountsLogger LOGGER = Logger.getMessageLogger(
            AccountsLogger.class,
            AccountsLogger.class.getPackage().getName() );
   }

   Copy to Clipboard Toggle word wrap

2. メソッド定義を追加する

   各ログメッセージのインターフェースにメソッド定義を追加します。ログメッセージの各メソッドにその内容を表す名前を付けます。
   各メソッドの要件は次のとおりです。
   • メソッドは返す必要がありますvoid。
   • 注釈を付ける必要があります@org.jboss.logging.LogMessage注釈。
   • 注釈を付ける必要があります@org.jboss.logging.Message注釈。
   • の値属性@org.jboss.logging.Messageデフォルトのログメッセージが含まれています。このメッセージは翻訳がない場合に使用されます。

   @LogMessage
   @Message(value = "Customer query failed, Database not available.")
   void customerQueryFailDBClosed();

   Copy to Clipboard Toggle word wrap
   デフォルトのログレベルは INFO です。

3. メソッドを呼び出します。

   メッセージをログに記録する必要があるコードのインターフェイスメソッドへの呼び出しを追加します。インターフェースの実装を作成する必要はありません。これは、プロジェクトがコンパイルされる時にアノテーションプロセッサーにより行われます。

   AccountsLogger.LOGGER.customerQueryFailDBClosed();

   Copy to Clipboard Toggle word wrap
   カスタムロガーは BasicLogger からサブクラス化されているため、BasicLogger((debug()、error()など) も使用できます。国際化されていないメッセージをログに記録するために他のロガーを作成する必要はありません。

   AccountsLogger.LOGGER.error("Invalid query syntax.");

   Copy to Clipboard Toggle word wrap

手順6.2 国際化されたメッセージの作成と使用

1. 例外のインターフェースを作成します。

   JBoss Logging Tools はインターフェースで国際化されたメッセージを定義します。各インターフェイスに、そのインターフェイスで定義されるメッセージの説明的な名前を付けます。
   インターフェースの要件は以下のとおりです。
   • public として宣言する必要があります。
   • 注釈を付ける必要があります@org.jboss.logging.MessageBundle。
   • インターフェースと同じ型のメッセージバンドルであるフィールドをインターフェースが定義する必要があります。

   @MessageBundle(projectCode="")
   public interface GreetingMessageBundle 
   {
      GreetingMessageBundle MESSAGES = Messages.getBundle(GreetingMessageBundle.class);
   }

   Copy to Clipboard Toggle word wrap

2. メソッド定義を追加する

   各メッセージのインターフェースにメソッド定義を追加します。メッセージに対する各メソッドにその内容を表す名前を付けます。
   各メソッドの要件は次のとおりです。
   • タイプのオブジェクトを返す必要がありますString。
   • 注釈を付ける必要があります@org.jboss.logging.Message注釈。
   • の値属性@org.jboss.logging.Messageデフォルトのメッセージに設定する必要があります。このメッセージは翻訳がない場合に使用されます。

   @Message(value = "Hello world.")
      String helloworldString();

   Copy to Clipboard Toggle word wrap

3. invoke メソッド

   メッセージを取得する必要があるアプリケーションでインターフェースメソッドを呼び出します。

   System.console.out.println(helloworldString());

   Copy to Clipboard Toggle word wrap