開発ガイド

1. https://access.redhat.com/ へアクセスします。
2. Downloads → Red Hat JBoss Middleware → Downloads と選択します。
3. ドロップボックスより JBoss Developer Studio を選択します。
4. 正しいバージョンを選択し、Download をクリックします。

手順1.1 JBoss Developer Studio 5 のインストール

1. ターミナルを開きます。
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. JBoss Developer Studio のデスクトップショートカットを設定し、Next をクリックします。
12. Done をクリックします。

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

1. ターミナルを開きます。
2. インストールディレクトリーへ移動します。
3. 次のコマンドを実行して JBoss Developer Studio を起動します。

   [localhost]$ ./jbdevstudio

   Copy to Clipboard Toggle word wrap

手順1.3 サーバーの追加

1. Servers タブを開きます。Servers タブがない場合は次のようにパネルへ追加します。
   1. Window → Show View → Other... の順にクリックします。
   2. Servers フォルダーより Server を選択し、OK をクリックします。
2. new server wizard リンクをクリックするか、空のサーバーパネル内で右クリックし、New → Server と選択します。
   

   View larger image

   

   図1.1 新しいサーバーの追加 - 使用できるサーバーがない場合

3. JBoss Enterprise Middleware を展開し、 JBoss Enterprise Application Platform 6.x を選択します。その後、Next ボタンをクリックします。
   

   View larger image

   

   図1.2 サーバータイプの選択

4. Browse をクリックし、JBoss EAP 6 がインストールされている場所へ移動します。Next をクリックします。
   

   View larger image

   

   図1.3 サーバーインストールの閲覧

5. この画面でサーバーの動作を定義します。手作業でサーバーを起動するか、JBoss Developer Studio に管理を任せます。デプロイメントのリモートサーバーを定義し、そのサーバーの管理ポートを公開するかどうかを決定できます (たとえば、JMX を使用してこのサーバーに接続する必要がある場合)。この例では、サーバーがローカルサーバーであり、JBoss Developer Studio がサーバーを管理するため、何もチェックする必要がないことを前提とします。Next をクリックします。
   

   View larger image

   

   図1.4 新しい JBoss サーバーの挙動の定義

6. この画面により新しいサーバーに対して既存のプロジェクトを設定することが可能です。現時点ではプロジェクトがないため、 Finish をクリックします。
   

   View larger image

   

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

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

1. Web ブラウザーを開き、URL https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=appplatform にアクセスします。
2. リストで「Quickstarts」を見つけます。
3. Download ボタンをクリックし、サンプルが含まれる zip アーカイブをダウンロードします。
4. ディレクトリーにアーカイブを展開します。

手順1.6 JBoss Developer Studio にクイックスタートをインポートする

1. 「Maven 設定を使用した JBoss EAP 6 Maven リポジトリーの設定」 を行っていない場合は、記載されている手順に従って設定してください。

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

3. メニューより File → Import と選択します。

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

   View larger image

   

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

5. インポートするクイックスタートのディレクトリーを参照し、OK をクリックします。Projects リストボックスに、選択したクイックスタートプロジェクトの pom.xml ファイルが示されます。
   

   View larger image

   

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

6. Next をクリックした後、Finish をクリックします。

手順1.7 helloworld クイックスタートのビルドとデプロイ

1. Servers タブを開き、パネルにアプリケーションを追加します。
   1. Window → Show View → Other... の順にクリックします。
   2. Servers フォルダーから Server を選択し、Ok をクリックします。
2. Project Explorer タブで helloworld を右クリックし、Run As → Run on Server を選択します。
3. JBoss EAP 6.2 Runtime Server を選択し、Next をクリックします。これにより、helloworld クイックスタートが JBoss サーバーにデプロイされます。
4. サーバーコンソールを確認します。以下のメッセージが表示されているはずです。

   JBAS018210: Register web context: /jboss-helloworld
   JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
   

   Copy to Clipboard Toggle word wrap

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

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

1. クイックスタートのルートディレクトリーにある README ファイルを確認してください。

   このファイルにはシステム要件に関する一般的な情報、Maven の設定方法、ユーザーの追加方法、クイックスタートの実行方法が含まれています。クイックスタートを始める前に必ず読むようにしてください。
   このファイルには使用可能なクイックスタートの一覧表も含まれています。この表にはクイックスタート名と使用する技術が記載され、各クイックスタートの簡単な説明と設定するために必要な経験レベルが記載されています。クイックスタートの詳細情報はクイックスタート名をクリックしてください。
   他のクイックスタートを改良または拡張するために作成されたクイックスタートもあります。このようなクイックスタートは Prerequisites カラムに記載されています。クイックスタートに前提条件がある場合、クイックスタートを始める前にこれらをインストールする必要があります。
   オプションコンポーネントのインストールや設定が必要になるクイックスタートもあります。これらのコンポーネントは、クイックスタートが必要とする場合のみインストールしてください。

2. helloworld クイックスタートを実行します。

   helloworld クイックスタートは最も単純なクイックスタートの 1 つで、JBoss サーバーが適切に設定され実行されているかどうかを検証できます。helloworld クイックスタートのルートにある README ファイルを開きます。このファイルには、クイックスタートのビルドおよびデプロイ方法や、実行しているアプリケーションへのアクセス方法の詳細手順が含まれています。

3. 別のクイックスタートを実行します。

   各クイックスタートのルートフォルダーにある README ファイルの手順に従って例を実行します。

手順1.9 helloworld クイックスタートを JBoss Developer Studio にインポートします。

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

2. JBoss Developer Studio がインストールされていない場合は、 「JBoss Developer Studio 5 のインストール」の手順に従ってインストールします。

3. 「JBoss Developer Studio の起動」に従って JBoss Developer Studio を起動します。

4. メニューより File → Import と選択します。

5. 選択リストより Maven → Existing Maven Projects を選択し、Next をクリックします。
   

   View larger image

   

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

6. QUICKSTART_HOME/quickstart/helloworld/ ディレクトリーを閲覧し、OK をクリックします。Projects リストボックスに、helloworld クイックスタートプロジェクトから pom.xml ファイルが追加されます。
   

   View larger image

   

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

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

手順1.10 helloworld クイックスタートのビルドとデプロイ

1. JBoss EAP 6 向けの JBoss Developer Studio が設定されていない場合は、 「JBoss EAP 6 サーバーを JBoss Developer Studio へ追加」の手順に従って設定する必要があります。
2. Project Explorer タブの jboss-as-helloworld を右クリックし、Run As → Run on Server と選択します。
   

   View larger image

   

   図1.11 サーバー上での実行

3. JBoss EAP 6.0 Runtime Server を選択し、Next をクリックします。これにより、helloworld クイックスタートが JBoss サーバーにデプロイされます。
4. helloworld が JBoss サーバーに正しくデプロイされたことを確認するには、Web ブラウザーを開き、URL http://localhost:8080/jboss-as-helloworld を指定してアプリケーションにアクセスします。

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

1. beans.xml はクイックスタートの src/main/webapp/ ディレクトリーにある WEB-INF/ フォルダーにあります。

2. src/main/webapp/ ディレクトリーには、単純なメタリフレッシュを使用してユーザーのブラウザーを http://localhost:8080/jboss-as-helloworld/HelloWorld にあるサーブレットへリダイレクトする、index.html ファイルも含まれています。

3. この例の全設定は、例の src/main/webapp/ ディレクトリーにある WEB-INF/ に存在します。

4. クイックスタートには web.xml ファイルは必要ありません。

手順1.12 コードの確認

1. HelloWorldServlet コードの検証

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

   27. @WebServlet("/HelloWorld")
   28. public class HelloWorldServlet extends HttpServlet {
   29. 
   30.    static String PAGE_HEADER = "<html><head /><body>";
   31.
   32.    static String PAGE_FOOTER = "</body></html>";
   33.
   34.    @Inject
   35.    HelloService helloService;
   36.
   37.    @Override
   38.    protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
                                throws ServletException, IOException {
   39.       PrintWriter writer = resp.getWriter();
   40.       writer.println(PAGE_HEADER);
   41.       writer.println("<h1>" + helloService.createHelloMessage("World") + "</h1>");
   42.       writer.println(PAGE_FOOTER);
   43.       writer.close();
   44.     }
   45. 
   46. }
   

   Copy to Clipboard Toggle word wrap
   Expand

   表1.1 HelloWorldServlet の詳細

   行	注記
   27	Java EE 6 以前はサーブレットの登録に XML ファイルが使用されました。サーブレットの登録はかなり簡易化され、@WebServlet アノテーションを追加し、サーブレットへのアクセスに使用される URL へのマッピングを提供することのみが必要となります。
   30-32	各 Web ページには適切な形式の HTML が必要になります。本クイックスタートは静的な文字列を使用して最低限のヘッダーとフッターの出力を書き出します。
   34-35	これらの行は実際のメッセージを生成する HelloService CDI Bean をインジェクトします。HelloService の API を変更しない限り、ビューレイヤーを変更せずに HelloService の実装を後日変更することが可能です。
   41	この行はサービスへ呼び出し、「Hello World」というメッセージを生成して HTTP 要求へ書き出します。

   Show more

2. HelloService コードの検証

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

    9. public class HelloService {
   10. 
   11.    String createHelloMessage(String name) {
   12.       return "Hello " + name + "!"; 
   32.    }
   33. }
   34.
   

   Copy to Clipboard Toggle word wrap

手順1.13 numberguess クイックスタートを JBoss Developer Studio にインポートします。

1. JBoss Developer Studio がインストールされていない場合は、 「JBoss Developer Studio 5 のインストール」の手順に従ってインストールします。

2. 「JBoss Developer Studio の起動」に従って JBoss Developer Studio を起動します。

3. メニューより File → Import と選択します。

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

   View larger image

   

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

5. QUICKSTART_HOME/quickstart/numberguess/ ディレクトリーを閲覧し、OK をクリックします。 Projects リストボックスに、numberguess クイックスタートプロジェクトから pom.xml ファイルが追加されます。

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

手順1.14 numberguess クイックスタートのビルドとデプロイ

1. JBoss EAP 6 向けの JBoss Developer Studio が設定されていない場合は、 「JBoss EAP 6 サーバーを JBoss Developer Studio へ追加」の手順に従って設定する必要があります。
2. Project Explorer タブの jboss-as-numberguess を右クリックし、Run As → Run on Server と選択します。
3. JBoss EAP 6.0 Runtime Server を選択し、Next をクリックします。これにより numberguess クイックスタートが JBoss サーバーにデプロイされます。
4. numberguess が JBoss サーバーに正しくデプロイされたことを確認するには、Web ブラウザを開き、URL http://localhost:8080/jboss-as-numberguess を指定してアプリケーションにアクセスします。

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

1. faces-config ファイルの確認

   本クイックスタートは faces-config.xml ファイル名の JSF 2.0 バージョンを使用します。Facelets の標準的なバージョンが JSF 2.0 のデフォルトのビューハンドラーであるため、特に必要なものはありません。ここでは JBoss EAP 6 は Java EE の領域を越えます。この設定ファイルが含まれると JSF が自動的に設定されます。そのため、設定はルート要素のみで構成されます。

   03. <faces-config version="2.0"
   04.    xmlns="http://java.sun.com/xml/ns/javaee"
   05.    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   06.    xsi:schemaLocation="
   07.       http://java.sun.com/xml/ns/javaee>
   08.       http://java.sun.com/xml/ns/javaee/web-facesconfig_2_0.xsd">
   09.      
   10. </faces-config>
   

   Copy to Clipboard Toggle word wrap

2. beans.xml ファイルの確認

   空の beans.xml ファイルも存在します。このファイルは、このアプリケーションで Bean を検索し、CDI をアクティベートするよう JBoss EAP 6 に指示します。

3. web.xml ファイルはありません

   クイックスタートには web.xml ファイルは必要ありません。

手順1.16 JSF コードの確認

• home.xhtml コードの確認

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

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

  Copy to Clipboard Toggle word wrap
  Expand

  表1.2 JSF の詳細

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

  Show more

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

1. Random.java 限定子コードの検証

   型に基づきインジェクションの対象となる、2 つの Bean の間であいまいさをなくすために修飾子が使用されます。修飾子の詳細については、 「修飾子を使用したあいまいなインジェクションの解決」を参照してください。
   @Random 修飾子は乱数のインジェクションに使用されます。

   21. @Target({ TYPE, METHOD, PARAMETER, FIELD })
   22. @Retention(RUNTIME)
   23. @Documented
   24. @Qualifier
   25. public @interface Random {
   26.
   27. }
   

   Copy to Clipboard Toggle word wrap

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

   @MaxNumberqualifier は最大許可数のインジェクションに使用されます。

   21. @Target({ TYPE, METHOD, PARAMETER, FIELD })
   22. @Retention(RUNTIME)
   23. @Documented
   24. @Qualifier
   25. public @interface MaxNumber {
   26.
   27. }
   

   Copy to Clipboard Toggle word wrap

3. ジェネレーターコードの検証

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

   28. @ApplicationScoped
   29. public class Generator implements Serializable {
   30.    private static final long serialVersionUID = -7213673465118041882L;
   31.
   32.    private java.util.Random random = new java.util.Random(System.currentTimeMillis());
   33.
   34.    private int maxNumber = 100;
   35.
   36.    java.util.Random getRandom() {
   37.       return random;
   38.    }
   39.
   40.    @Produces
   41.    @Random
   42.    int next() {
   43.       // a number between 1 and 100
   44.       return getRandom().nextInt(maxNumber - 1) + 1;
   45.    }
   46.
   47.    @Produces
   48.    @MaxNumber
   49.    int getMaxNumber() {
   50.       return maxNumber;
   51.    }
   52. }
   

   Copy to Clipboard Toggle word wrap

4. ゲームコードの検証

   セッションスコープ指定クラス Game は、アプリケーションのプライマリーエントリーポイントです。ゲームの設定や再設定、ユーザーが選択する数字のキャプチャーや検証、FacesMessage によるユーザーへのフィードバック提供を行う役割があります。コンストラクト後の lifecycle メソッドを使用し、@Random Instance<Integer> Bean より乱数を読み出してゲームを初期化します。
   このクラスの @Named アノテーションを見てください。このアノテーションは式言語 (EL) より Bean を JSF ビューにアクセスできるようにしたい場合のみ必要です。この場合 #{game} が EL になります。

   035. @Named
   036. @SessionScoped
   037. public class Game implements Serializable {
   038.
   039.    private static final long serialVersionUID = 991300443278089016L;
   040.
   041.    /**
   042.     * The number that the user needs to guess
   043.     */
   044.    private int number;
   045.
   046.    /**
   047.     * The users latest guess
   048.     */
   049.    private int guess;
   050.
   051.    /**
   052.     * The smallest number guessed so far (so we can track the valid guess range).
   053.     */
   054.    private int smallest;
   055.
   056.    /**
   057.     * The largest number guessed so far
   058.     */
   059.    private int biggest;
   060.
   061.    /**
   062.     * The number of guesses remaining
   063.     */
   064.    private int remainingGuesses;
   065.
   066.    /**
   067.     * The maximum number we should ask them to guess
   068.     */
   069.    @Inject
   070.    @MaxNumber
   071.    private int maxNumber;
   072.
   073.    /**
   074.     * The random number to guess
   075.     */
   076.    @Inject
   077.    @Random
   078.    Instance<Integer> randomNumber;
   079.
   080.    public Game() {
   081.    }
   082.
   083.    public int getNumber() {
   084.       return number;
   085.    }
   086.
   087.    public int getGuess() {
   088.       return guess;
   089.    }
   090.
   091.    public void setGuess(int guess) {
   092.       this.guess = guess;
   093.    }
   094.
   095.    public int getSmallest() {
   096.       return smallest;
   097.    }
   098.
   099.    public int getBiggest() {
   100.       return biggest;
   101.    }
   102.
   103.    public int getRemainingGuesses() {
   104.       return remainingGuesses;
   105.    }
   106.
   107.    /**
   108.     * Check whether the current guess is correct, and update the biggest/smallest guesses as needed.
   109.     * Give feedback to the user if they are correct.
   110.     */
   111.    public void check() {
   112.       if (guess > number) {
   113.          biggest = guess - 1;
   114.       } else if (guess < number) {
   115.          smallest = guess + 1;
   116.       } else if (guess == number) {
   117.          FacesContext.getCurrentInstance().addMessage(null, new FacesMessage("Correct!"));
   118.       }
   119.       remainingGuesses--;
   120.    }
   121.
   122.    /**
   123.     * Reset the game, by putting all values back to their defaults, and getting a new random number.
   124.     * We also call this method when the user starts playing for the first time using
   125.     * {@linkplain PostConstruct @PostConstruct} to set the initial values.
   126.     */
   127.    @PostConstruct
   128.    public void reset() {
   129.       this.smallest = 0;
   130.       this.guess = 0;
   131.       this.remainingGuesses = 10;
   132.       this.biggest = maxNumber;
   133.       this.number = randomNumber.get();
   134.    }
   135.
   136.    /**
   137.     * A JSF validation method which checks whether the guess is valid. It might not be valid because
   138.     * there are no guesses left, or because the guess is not in range.
   139.     *
   140.     */
   141.    public void validateNumberRange(FacesContext context, UIComponent toValidate, Object value) {
   142.       if (remainingGuesses <= 0) {
   143.          FacesMessage message = new FacesMessage("No guesses left!");
   144.          context.addMessage(toValidate.getClientId(context), message);
   145.          ((UIInput) toValidate).setValid(false);
   146.          return;
   147.       }
   148.       int input = (Integer) value;
   149.
   150.       if (input < smallest || input > biggest) {
   151.          ((UIInput) toValidate).setValid(false);
   152.
   153.          FacesMessage message = new FacesMessage("Invalid guess");
   154.          context.addMessage(toValidate.getClientId(context), message);
   155.       }
   156.    }
   157. }
   

   Copy to Clipboard Toggle word wrap

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

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

   ログメッセージの定義が含まれるように Java インターフェースをプロジェクトに追加します。定義されるログメッセージに対し、インターフェースにその内容を表す名前を付けます。
   ログメッセージインターフェースの要件は次のとおりです。
   • @org.jboss.logging.MessageLogger アノテーションが付けられていなければなりません。
   • org.jboss.logging.BasicLogger を拡張しなければなりません。
   • このインターフェースを実装する型付きロガーのフィールドをインターフェースが定義する必要があります。org.jboss.logging.Logger の getMessageLogger() メソッドで定義します。

   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 はインターフェースで国際化されたメッセージを定義します。定義されるメッセージに対し、インターフェースに記述的な名前を付けます。
   インターフェースの要件は次のとおりです。
   • パブリックとして宣言される必要があります。
   • @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. 呼び出しメソッド

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

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

   Copy to Clipboard Toggle word wrap