Person Java クラスの作成

1. 「プロジェクト」ウィンドウの「ソースパッケージ」ノードを右クリックし、「新規」>「Java クラス」を選択して「新規 Java クラス」ウィザードを開きます。
2. このウィザードで、クラス名に「Person」と入力し、パッケージに「travel」と入力します。「完了」をクリックします。
3. 次のボールドで示される変更をクラスに加え、シリアライザブルインタフェースを実装して表の列のフィールドを追加します。

   public class Person implements Serializable {
       private int personId;
       private String name;
       private String jobTitle;
       private boolean frequentFlyer;
       private java.util.Set trips;
   }

4. フィールドの取得メソッドおよび設定メソッドを生成します。この操作は、ソースエディタ内を右クリックし、「コードを挿入」(Alt-Insert) を選択し、「取得メソッド」および「設定メソッド」を選択することで行います。
5. 「取得メソッドおよび設定メソッドの生成」ダイアログですべてのフィールドを選択し、「生成」をクリックします。
   

   「取得メソッドおよび設定メソッドの生成」ダイアログで、キーボードの上矢印を使用して選択済みの項目を Person 項目に移動し、スペースキーを押して Person 内のすべてのフィールドを選択します。

6. インポートを修正して変更内容を保存します。

Trip Java クラスの作成

1. 「プロジェクト」ウィンドウの「ソースパッケージ」ノードを右クリックし、「新規」>「Java クラス」を選択して「新規 Java クラス」ウィザードを開きます。
2. このウィザードで、クラス名に「Trip」と入力し、パッケージに「travel」と入力します。「完了」をクリックします。
3. 次のボールドで示される変更をクラスに加え、Serializable インタフェースを実装して表の列のフィールドを追加します。

   public class Trip implements Serializable {
       private int tripId;
       private int personId;
       private Date depDate;
       private String depCity;
       private String destCity;
       private int tripTypeId;
   }

4. フィールドの取得メソッドおよび設定メソッドを生成します。この操作は、ソースエディタ内を右クリックし、「コードを挿入」(Alt-Insert) を選択し、「取得メソッド」および「設定メソッド」を選択することで行います。
5. 「取得メソッドおよび設定メソッドの生成」ダイアログですべてのフィールドを選択し、「生成」をクリックします。
6. インポートを修正して変更内容を保存します。

Person.java および Trip.java ファイルは、このあとで再度編集する必要がないため閉じます。

PERSON 表への Person.java のマッピング

まず、Hibernate マッピングファイルである Person.hbm.xml を作成し、Person.java 内のフィールドを PERSON 表の列にマップします。

1. JavaDB データベースサーバーが開始されていない場合は開始します。
2. 「プロジェクト」ウィンドウで、「ソースパッケージ」ノードの「travel」ノードを右クリックし、ポップアップメニューの「新規」>「その他」を選択して「新規ファイル」ウィザードを開きます。
3. 「カテゴリ」の一覧から「Hibernate」を選択し、「ファイルの種類」の一覧から「Hibernate Mapping File」を選択します。「次へ」をクリックします。
4. ファイル名に「Person.hbm」と入力し、フォルダを「src/java/travel」に設定します。「次へ」をクリックします。
5. 「Class to Map」に「travel.Person」を入力します。

   注: または、参照ボタンをクリックし、「型を検索」ダイアログに「Person」と入力することもできます。

6. 「Database Table」ドロップダウンリストから「PERSON」を選択します。

   注: 「Database Table」ドロップダウンリストが空の場合、データベースが実行されていない可能性があります。表を指定せずに、ファイルの作成を続行することはできますが、表を XML に指定することを覚えておく必要があります。

7. 「完了」をクリックします。

   「完了」をクリックすると、IDE で Person.hbm.xml ファイルが Person.java と同じソースパッケージ内に作成され、このファイルがエディタで開きます。デフォルトでは、XML ファイルは次のようになります。

   <hibernate-mapping>
     <class dynamic-insert="false" dynamic-update="false" mutable="true"
     name="travel.Person" optimistic-lock="version" polymorphism="implicit"
     select-before-update="false" table="PERSON"/>
   </hibernate-mapping>

   注: PERSON 表をファイルの作成時にドロップダウンリストから選択できなかった場合、class 要素に table="PERSON" を忘れずに追加してください。

8. XML エディタで次のボールドの変更を加え、ID、プロパティー、および 1 対多関係をマップします。

   <hibernate-mapping>
     <class dynamic-insert="false" dynamic-update="false"
         mutable="true" name="travel.Person" optimistic-lock="version"
         polymorphism="implicit" select-before-update="false" table="PERSON">
           <id column="PERSONID" name="personId">
               <generator class="increment"/>
           </id>
           <property column="NAME" name="name"/>
           <property column="JOBTITLE" name="jobTitle"/>
           <property column="FREQUENTFLYER" name="frequentFlyer"/>
           <set cascade="all-delete-orphan" inverse="true" lazy="true" name="trips" table="TRIP">
               <key column="PERSONID"/>
               <one-to-many class="travel.Trip"/>
           </set>
       </class>
   </hibernate-mapping>

   XML エディタでコード補完を使用し、プロパティーと値の追加に役立てることができます。コード補完がこのスクリーンショットのように動作しない場合、次の「注」を参照してください。

   

   注: デフォルトでは、class 要素には終了タグがあります。開始と終了の class 要素の間に、プロパティー要素を追加する必要があるため、次のボールドの変更を加えます。変更後、コード補完を class 要素の間で使用できます。

   <hibernate-mapping>
     <class dynamic-insert="false" dynamic-update="false"
     mutable="true" name="travel.Person" optimistic-lock="version"
     polymorphism="implicit" select-before-update="false" table="PERSON">
   
     </class>
   </hibernate-mapping>

9. XML を検査し、検査エラーがあれば修正してファイルを保存します。

TRIP 表への Trip.java のマッピング

次に、Hibernate マッピングファイルである Trip.hbm.xml を作成し、Trip.java 内のフィールドを TRIP 表の列にマップします。

1. 「プロジェクト」ウィンドウで、「ソースパッケージ」ノードの「travel」ノードを右クリックし、ポップアップメニューの「新規」>「その他」を選択して「新規ファイル」ウィザードを開きます。
2. 「カテゴリ」の一覧から「Hibernate」を選択し、「ファイルの種類」の一覧から「Hibernate Mapping File」を選択します。「次へ」をクリックします。
3. ファイル名に「Trip.hbm」と入力し、フォルダを「src/java/travel」に設定します。「次へ」をクリックします。
4. 「Class to Map」に「travel.Trip」を入力します。

   注: または、参照ボタンをクリックし、「型を検索」ダイアログに「Trip」と入力することもできます。

5. 「Database Table」ドロップダウンリストから「TRIP」を選択します。

   注: 「Database Table」ドロップダウンリストが空の場合、ここを空欄のままにします。あとで XML エディタに表名を入力できます。

6. 「完了」をクリックします。

   「完了」をクリックすると、IDE で Trip.hbm.xml が Trip.java クラスと同じフォルダ内に作成され、このファイルがエディタで開きます。

7. XML エディタで、次のボールドの変更を加えます。

   <hibernate-mapping>
           <class dynamic-insert="false" dynamic-update="false" mutable="true"
               name="travel.Trip" optimistic-lock="version" polymorphism="implicit"
               select-before-update="false" table="TRIP">
   	<id column="TRIPID" name="tripId">
               <generator class="increment"/>
           </id>
           <property column="PERSONID" name="personId"/>
           <property column="DEPDATE" name="depDate" type="date"/>
           <property column="DEPCITY" name="depCity"/>
           <property column="DESTCITY" name="destCity"/>
           <property column="TRIPTYPEID" name="tripTypeId"/>
       </class>
   </hibernate-mapping>

   XML エディタでコード補完を使用し、プロパティーと値の追加に役立てることができます。

8. XML を検査し、検査エラーがあれば修正してファイルを保存します。

ページへの Visual Web JSF コンポーネントの追加

1. 「プロジェクト」ウィンドウの「Web ページ」フォルダを展開し、「Page1.jsp」をビジュアルデザイナで開きます。
2. パレットの「Woodstock 基本」コンポーネントセットから「ドロップダウンリスト」コンポーネントをドラッグし、Page1 の左上隅にドロップします。
3. 「ドロップダウンリスト」コンポーネントを右クリックし、ポップアップメニューから「変更時に自動送信」を選択します。

   この操作によって、ユーザーがドロップダウンリストから新しい値を選択すると、常にブラウザでページが送信されます。

4. 「ドロップダウンリスト」コンポーネントを再度右クリックし、「バインド属性を追加」を選択します。

   注: このチュートリアルのあとの手順で、プロパティーのバインドを指定します。NetBeans IDE 6.1 には、要求時バインド機能があります。コンポーネントに Java コーディングが必要な場合、Visual Web JSF アプリケーションのコンポーネントに手動でバインド属性を追加する必要があります。バインド属性を追加するには、各コンポーネントを右クリックし、「バインド属性を追加」を選択します。詳細は、「On-demand Binding Attribute Wiki」を参照してください。

5. 「表」コンポーネントをドラッグし、「ドロップダウンリスト」コンポーネントの下にドロップします。
6. 「メッセージグループ」コンポーネントをドラッグし、「表」コンポーネントの下にドロップします。

   「メッセージグループ」コンポーネントは、実行時の問題の診断に役立ちます。デフォルトで、「メッセージグループ」コンポーネントでは実行時エラー、検査エラー、および変換エラーに関するメッセージが表示されます。

7. 変更を保存します。

これで、Web ページに必要なコンポーネントが揃いました。このあとは、コンポーネントをデータソースにバインドする必要があります。

データソースへの SessionBean1 からのアクセス

ここで、データソースにアクセスするように SessionBean1 を編集する必要があります。この課題では、「プロパティーを追加」ダイアログを使用して SessionBean1 内にフィールドを指定し、それらのフィールドの取得メソッドと設定メソッドを生成します。セッション Bean でセッションコンテキストが開き、データが Java オブジェクトを介して取得されます。

1. 「hibernatetravelapp」ソースパッケージを「プロジェクト」ウィンドウで展開し、「SessionBean1.java」をダブルクリックしてこのファイルをエディタで開きます。
2. カーソルをソースコード内の空のスペース (たとえば、コンストラクタの直後など) に置き、「コードを挿入」>「プロパティーを追加」(Ctrl-I) を右クリックして選択し、「プロパティーを追加」ダイアログを開きます。
3. 「プロパティーを追加」ダイアログで、「名前」に「personOptions」と入力し、「型」に「Option[]」と入力し、「private」を選択します。
4. 「取得メソッドおよび設定メソッドの生成」が選択解除されている場合、選択します。「了解」をクリックします。
   
5. 上記の手順を繰り返して次のプロパティーを追加します。

   名前	型
   selectedPersonId	Integer
   trips4Person	Trip[]

   
6. 次のボールドのコードを getApplicationBean1 メソッドの下の SessionBean1 に追加することで、buildPersonOptions および updateTrips4Person メソッドをクラスに追加します。

   protected ApplicationBean1 getApplicationBean1() {
           return (ApplicationBean1) getBean("ApplicationBean1");
       }
   
   private void buildPersonOptions() {
       List<Person> personList = null;
       try{
           Session session = HibernateUtil.getSessionFactory().getCurrentSession();
           Transaction tx = session.beginTransaction();
           Query q = session.createQuery("from Person");
           personList = (List<Person>) q.list();
   
       } catch(Exception e) {
           e.printStackTrace();
       }
   
       personOptions = new Option[personList.size()];
       int i=0;
       for(Person person : personList) {
           Option opt = new Option(person.getPersonId(), person.getName());
           personOptions[i++] = opt;
       }
   }
   
   private void updateTrips4Person() {
       if(selectedPersonId == null ) {
           trips4Person = new Trip[1];
           trips4Person[0] = new Trip();
           return;
       }
   
       Set personTrips = null;
       try{
          Session session =
                   HibernateUtil.getSessionFactory().getCurrentSession();
           Transaction tx = session.beginTransaction();
           Person person = (Person)session.load(Person.class, selectedPersonId);
           personTrips = (PersistentSet)person.getTrips();
   
       } catch(Exception e) {
           e.printStackTrace();
       }
   
       trips4Person = (Trip[]) personTrips.toArray(new Trip[0]);
   }

   buildPersonOptions メソッドによって Person データソース上のクエリーが呼び出され、結果が personOptions 配列に格納されます。updateTrips4Person メソッドで選択された人物の旅行の値が更新されます。

7. インポートを修正します。
   

   注: インポートに対して完全修飾名を選択する場合、「org.hibernate」ライブラリおよび「com.sun.webui.jsf.model.Option」と「java.util.Set」を選択するようにしてください。

8. 次のボールドのコードを init() メソッドの最後に追加することで、buildPersonOptions メソッドを呼び出します。

   @Override
   public void init() {
       super.init();
   
       try {
           _init();
       } catch (Exception e) {
           log("SessionBean1 Initialization Failure", e);
           throw e instanceof FacesException ? (FacesException) e : new FacesException(e);
       }
       // Fill in the personOptions[]
       buildPersonOptions();
   
   }

9. 次のボールドのコードを setSelectedPersonId メソッドの最後に追加することで、updateTrips4Person メソッドを呼び出します。

   public void setSelectedPersonId(Integer selectedPersonId) {
       this.selectedPersonId = selectedPersonId;
       updateTrips4Person();
   }

10. 変更を保存します。
11. 「プロジェクト」ウィンドウでプロジェクトのノードを右クリックし、「構築」を選択します。

データへのコンポーネントのバインド

この節では、前の節で SessionBean1 に定義したプロパティーに、Web ページのドロップダウンリストコンポーネントおよび表コンポーネントをバインドします。

1. ビジュアルデザイナで Page1.jsp を開きます。
2. 「ドロップダウンリスト」コンポーネントを右クリックし、「プロパティーのバインド」を選択して「プロパティーのバインド」ダイアログを開きます。
3. バインド可能なプロパティーの一覧から「items」を選択し、バインド先の一覧から「personOptions」(SessionBean1 ノードの下) を選択します。「適用」をクリックします。
   
4. 同じダイアログで、バインド可能なプロパティーの一覧から「selected」を選択し、バインドターゲット先の一覧から「selectedPersonId」(SessionBean1 ノードの下) を選択します。「適用」をクリックします。
   
5. 「閉じる」をクリックしてダイアログを閉じます。
6. ビジュアルデザイナで、表コンポーネント上をクリックし、「表レイアウト」を選択します。
7. このダイアログで、「trips4Person (SessionBean1)」を「データの入手先」ドロップダウンリストから選択します。
   

   注: 「trips4Person (SessionBean1)」がドロップダウンリストに表示されない場合、前の節の最後でプロジェクトの構築を忘れた可能性が高いです。

8. 「personId」を「選択」の一覧から選択し、左矢印ボタンをクリックしてフィールドを「選択」の一覧から「使用可能」の一覧に移動します。
9. 上矢印および下矢印ボタンを使用し、そのほかのフィールドを次に示す順番で配置し直し、「了解」をクリックします。
   
10. 「編集」ツールバーで、「Java」をクリックし、「Page1.java」を Java エディタで開きます。
11. prerender メソッドに次のボールドのコードを追加します。

    public void prerender() {
        try {
            if (dropDown1.getSelected() == null ) {
                Option firstPerson = getSessionBean1().getPersonOptions()[0];
                getSessionBean1().setSelectedPersonId((Integer)firstPerson.getValue());
            }
        } catch (Exception ex) {
            log("Error Description", ex);
            error(ex.getMessage());
        }
    }

    prerender メソッドのコードは、Web ブラウザにページが表示される前に呼び出されます。prerender メソッドにコードを追加することで、ユーザーがページを最初に訪問したとき、ドロップダウンリストの最初の人物の情報がページに表示されます。

    ブラウザで最初にページが要求されるとき、アプリケーションによって Page1 のインスタンスが作成され、prerender メソッドが呼び出されます。サーバーによって応答 (HTML ページ) が送信され、Page1 のインスタンスが破棄されます。アプリケーションでは、ページの送信時にのみ値変更イベントが生成されるので (この例では新しい名前が選択されたとき)、値変更イベントハンドラは呼び出されません。

12. ソース内を右クリックし、「インポートを修正」をポップアップメニューから選択し、「インポートを修正」ダイアログを開きます。「完全修飾名」ドロップダウンリストで、次に示すように「com.sun.webui.jsf.model.Option」を選択します。
    
13. 変更を保存します。