エンティティークラスの作成

この課題では、新規エンティティークラスウィザードを使用して単純な持続性エンティティークラスを作成します。また、このウィザードを使用して、このアプリケーションで使用するデータソースとエンティティーマネージャーを定義する持続性ユニットも作成します。表のデータを表示するためのフィールドをクラスに 1 つ追加し、新規フィールド用の取得メソッドと設定メソッドを生成します。

エンティティークラスには主キーが必要です。ウィザードを使用してエンティティークラスを作成する場合、フィールドを主キーとして宣言するため、IDE ではデフォルトで id フィールドが生成され、@Id 注釈を使ってフィールドに注釈が付けられます。また、主 ID フィールドのキー生成方法を指定するための @GeneratedValue という注釈も追加されます。

プロジェクトで Java Persistence を使用すると、持続フィールドまたはプロパティー向けのオブジェクトリレーショナルマッピング情報を提供する配備記述子の設定が不要になり、アプリケーション開発が大幅に簡素化されます。代わりに、注釈を使用して、これらのプロパティーを簡単な Java クラス内で直接定義できます。

エンティティーの持続性は、EntityManager API によって管理されます。EntityManager API は持続性コンテキストを処理し、各持続性コンテキストはエンティティーインスタンスのグループです。アプリケーション開発時には、クラス内で注釈を使用して、エンティティーのインスタンスからなる持続性コンテキストのインスタンスを指定できます。そうすると、エンティティーのインスタンスのライフサイクルは、コンテナによって処理されます。

エンティティークラスを作成するには、次の手順に従います。

1. プロジェクトノードを右クリックし、「新規」>「その他」を選択します。
2. 「持続性」カテゴリから「エンティティークラス」を選択します。「次へ」をクリックします。
3. クラス名に「Message」と入力します。
4. パッケージに「entities」と入力します。
5. 「持続性ユニットの作成」を選択します。「次へ」をクリックします。

   注. NetBeans IDE 6.8 では、「持続性ユニットの作成」ボタンをクリックすると、持続性ユニットを作成するためのダイアログが開きます。

6. データソースを選択します (たとえば、JavaDB を使用する場合はjdbc/sample を選択)。

   データソース jdbc/sample は、IDE および GlassFish サーバーのインストール時に IDE にバンドルされますが、別のデータベースを使用する場合はほかのデータソースを指定することもできます。

   ほかのデフォルトオプション (持続性ユニット名、EclipseLink 持続性プロバイダ) はそのままでかまいません。持続性ユニットが「Java Transaction API を使用」になっていること、アプリケーション配備時にエンティティークラスに基づいた表が作成されるように「表生成の方針」が「作成」に設定されていることを確認します。

7. 新規エンティティークラスウィザードで「完了」をクリックします。

   「完了」をクリックするとエンティティークラスが作成され、そのクラスがエディタに表示されます。IDE によって ID フィールド private Long id; が作成され、フィールドに @Id および @GeneratedValue(strategy = GenerationType.AUTO) という注釈が付与されます。

8. エディタで、id フィールドの下に message フィールド (ボールドで表示) を追加します。

   private Long id;
   private String message;

9. エディタ内を右クリックして「コードを挿入」(Ctrl-I) を選択し、「取得メソッドおよび設定メソッド」を選択します。
10. 「取得メソッドおよび設定メソッドの生成」ダイアログで message フィールドを選択し、「生成」をクリックします。

    message に取得メソッドと設定メソッドが生成されます。

    
11. 変更を保存します。

エンティティークラスは、データベース内の表を表します。このアプリケーションを実行すると、Message のデータベース表が自動的に作成されます。この表には、id 列と message 列が含まれます。

XML エディタで持続性ユニットを見ると、アプリケーションが Java Transaction API (JTA) (transaction-type="JTA") を使用しています。これは、持続性コンテキストでのエンティティーのライフサイクルの管理義務がコンテナに割り当てられることを指定します。この結果、エンティティーのライフサイクルがアプリケーションではなくコードで管理されるため、コードが少なくてすみます。JTA を使用してトランザクションを管理する方法については、Java Transaction API のドキュメントを参照してください。

セッションファサードの作成

この課題では、ウィザードを使用して、Message エンティティーのステートレスセッションファサードを作成します。EJB 3.1 仕様で、セッション Bean のビジネスインタフェースが任意になったことが示されています。このアプリケーションでは、Bean にアクセスするクライアントがローカルクライアントであるため、Bean を公開する方法として、ローカルインタフェースを使用する方法と、インタフェースなしのビューを使用するオプションがあります。

セッション Bean を作成するには、次の手順に従います。

1. プロジェクトノードを右クリックし、「新規」>「その他」を選択します。
2. 「Java EE」カテゴリから「エンティティークラス」の「セッション Beans」を選択します。「次へ」をクリックします。
3. 「Message」エンティティーを選択し、「追加」をクリックします。「次へ」をクリックします。
4. パッケージに「boundary」と入力します。「完了」をクリックします。

   セッション Bean のビジネスインタフェースを作成する必要はありませんでした。代わりに、このアプリケーションでは、インタフェースなしのビューを使用して、Bean がローカルの管理対象 Bean に公開されます。

   

「完了」をクリックすると、セッションファサードクラス MessageFacade.java と AbstractFacade.java が生成され、エディタでこれらのファイルが開かれます。生成されたコードでわかるように、MessageFacade.java は注釈 @Stateless によってステートレスセッション Bean コンポーネントとして宣言されます。MessageFacade.java は AbstractFacade.java を拡張したもので、ビジネスロジックとトランザクション管理が含まれます。

@Stateless
public class MessageFacade extends AbstractFacade<Message> {
    @PersistenceContext(unitName = "SimpleEE6AppPU")
    private EntityManager em;
            

ウィザードを使用してエンティティーのファサードを作成すると、エンティティーマネージャーリソースをセッション Bean コンポーネントに注入し、持続性ユニットの名前を指定するため、デフォルトで PersistenceContext 注釈 (@PersistenceContext(unitName = "SimpleEE6AppPU")) が追加されます。この例では、持続性ユニットの名前が明示的に宣言されますが、アプリケーションに持続性ユニットが 1 つしかない場合、この名前は省略可能です。

IDE では、AbstractFacade.java に、エンティティーを作成、編集、削除、および検索するためのメソッドも生成されます。EntityManager API では、持続性コンテキストと連携するために使用されるメソッドが定義されます。IDE によって、エンティティーオブジェクトの検索に使用可能な、一般的に使用されるデフォルトのクエリーメソッドがいくつか生成されます。findAll メソッド、findRange メソッド、および count メソッドは、クエリーを作成するため、Criteria API で定義されたメソッドを使用します。Criteria API は、Java EE 6 仕様に含まれる JPA 2.0 仕様の一部です。

管理対象 Bean の作成

この課題では、セッションファサードへのアクセスに使用される、単純な JSF 管理対象 Bean を作成します。Java EE 6 の一部である JSF 2.0 仕様により、Bean クラスで注釈を使用して、クラスを JSF 管理対象 Bean として識別したり、範囲を指定したり、Bean の名前を指定したりすることができます。

管理対象 Bean を作成するには、次の手順に従います。

1. プロジェクトノードを右クリックし、「新規」>「その他」を選択します。
2. JavaServer Faces カテゴリから JSF 管理対象 Bean を選択します。「次へ」をクリックします。
3. クラス名に「MessageView」と入力します。

   Bean でメソッドを呼び出すときに、管理対象 Bean 名の MessageView を、JSF ページ index.xhtml の inputText および commandButton の値として使用します。

4. パッケージに「my.presentation」と入力します。
5. 管理対象 Bean に使用する名前に「MessageView」と入力します。

   注: ウィザードを使用して管理対象 Bean を作成すると、デフォルトでは、Bean クラスの名前を基にして先頭を小文字にした名前が Bean に割り当てられます。このチュートリアルおよびデモの目的上、ここでは大文字で始まる名前を Bean に明示的に割り当てています。JSF ページでこの Bean を参照するときは、messageView ではなく MessageView を使用します。名前を明示的に割り当てなかった場合は、JSF ページでデフォルトの messageView を使用します。

6. 「スコープ」を「要求」に設定します。「完了」をクリックします。

「完了」をクリックすると Bean クラスが作成され、そのクラスがエディタに表示されます。「プロジェクト」ウィンドウに次のファイルが表示されます。

エディタで、@ManagedBean 注釈、@RequestScoped 注釈、および Bean の名前が追加されたことがわかります。

@ManagedBean(name="MessageView")
@RequestScoped
public class MessageView {

    /** MessageView の新しいインスタンスを作成*/
    public MessageView() {
    }

}

ここで、依存関係の注入を使用して MessageFacade セッション Bean への参照を取得するための @EJB 注釈を追加します。ファサードに公開された findAll メソッドと create メソッドも呼び出します。IDE のコード補完は、メソッドを入力するときに役立ちます。

1. エディタ内を右クリックし、「コードを挿入」(Ctrl+I) を選択してポップアップメニューを開きます。
2. ポップアップメニューで「エンタープライズ Bean を呼び出し」を選択します。
3. 「エンタープライズ Bean を呼び出し」ダイアログで「MessageFacade」を選択します。「了解」をクリックします。
   

   「了解」をクリックすると、次のコード (ボールドで表示) が追加され、Bean が注入されます。

   public class MessageView {
   
       /** MessageView の新しいインスタンスを作成 */
       public MessageView() {
       }
   
       // @EJB 注釈を使用して MessageFacade セッション Bean を注入
       @EJB
       private MessageFacade messageFacade;
   }
   

4. 次のコードを追加して新しいインスタンスを作成します。

   /** MessageView の新しいインスタンスを作成*/
       public MessageView() {
          this.message = new Message();
       }

5. クラスに次のコードを追加します。

       // 新しいフィールドを作成
       private Message message;
   
   
       // getMessage を呼び出してメッセージを取得
       public Message getMessage() {
          return message;
       }
   
       // メッセージの合計数を返す
       public int getNumberOfMessages(){
          return messageFacade.findAll().size();
       }
   
       // メッセージを保存し、文字列 "theend" を返す
       public String postMessage(){
          this.messageFacade.create(message);
          return "theend";
       }
   

6. インポートを修正して (Ctrl-Shift-I) 変更内容を保存します。

エディタでコード補完を使用すると、コードの入力に役立ちます。

postMessage メソッドが文字列「theend」を返します。JSF 2.0 仕様では、Facelets テクノロジを使用するアプリケーションで暗黙ナビゲーション規則を使用できます。このアプリケーションは、faces-config.xml にナビゲーション規則が構成されていません。代わりに、ナビゲーションハンドラが、アプリケーション内で適切なページを検索しようとします。この場合、ナビゲーションハンドラは、postMessage メソッドが呼び出されると、theend.xhtml という名前のページを検索しようとします。

インデックスページの変更

この課題では、index.xhtml ページに簡単な変更を加えて、いくつかの UI コンポーネントを追加します。入力テキストフィールドとボタンのあるフォームを追加します。

1. エディタで index.xhtml を開きます。
2. 次の簡単なフォームを <h:body> タグの間に追加するようにファイルを変更します。

   <h:body>
       <f:view>
           <h:form>
               <h:outputLabel value="Message:"/><h:inputText value="#{MessageView.message.message}"/>
               <h:commandButton action="#{MessageView.postMessage}" value="Post Message"/>
           </h:form>
       </f:view>
   </h:body>

   JSF のコード補完は、コードを入力するときに役立ちます。

   
3. 変更を保存します。

inputText コンポーネントと commandButton コンポーネントが、名前付きの JSF 管理対象 Bean MessageView でメソッドを呼び出します。postMessage メソッドが「theend」を返し、ナビゲーションハンドラが theend.xhtml という名前のページを検索します。

結果ページの作成

この課題では、JSF ページ theend.xhtml を作成します。このページは、ユーザーが index.xhtml の Post Message ボタンをクリックし、JSF 管理対象 Bean の postMessage メソッドを呼び出したときに表示されます。

1. プロジェクトノードを右クリックし、「新規」>「その他」を選択します。
2. 「JavaServer Faces」カテゴリから「JSF ページ」を選択します。「次へ」をクリックします。
3. ファイル名に「theend」と入力します。
4. Facelets オプションが選択されていることを確認します。「完了」をクリックします。
5. 次のコードを <h:body> タグの間に入力してファイルを変更します。

   <h:body>
       <h:outputLabel value="Thanks! There are "/>
       <h:outputText value="#{MessageView.numberOfMessages}"/>
       <h:outputLabel value=" messages!"/>
   </h:body>

入力を始めると、xmlns:h="http://java.sun.com/jsf/html タグライブラリ定義が JSF 要素のファイルに自動的に追加されます。