データベース構造の表示

表が正しく作成されたかどうかを確認するには、データベース接続ノードの下の「表」ノードを展開します。表のノードを展開すると、表の列、インデックス、および外部キーを確認できます。列を右クリックして「プロパティー」を選択すると、その列に関する追加情報が表示されます。

「表」ノードの下に表が表示されない場合は、「表」ノードを右クリックし、「再表示」を選択します。

consult データベースの構造を見ると、さまざまな関係とさまざまな型のフィールドを含む表があることがわかります。データベースからエンティティークラスを作成するときは、フィールドの型ごとに適したコードが自動的に生成されます。

次の表では、consult データベース内の表について説明します。

consult データベースには、さまざまな関係が含まれています。データベースからエンティティークラスを作成するときは、表間の関係を示す適切なコードが自動的に生成され、エンティティークラスのフィールドに適切な注釈が追加されます。次の表では、consult データベース内の表間の関係について説明します。逆方向の関係は示していません。

データベースが作成されたので、次に Web アプリケーションを作成し、「データベースからのエンティティークラス」ウィザードを使用して、データベースの表に基づいてエンティティークラスを生成できます。

Address.java の編集

Address エンティティークラスを開き、次の変更を行います。

1. 完全な住所を返すように toString メソッドの return 文を変更します。

   return line1 + ", " + line2 + ", " + city + ", " + region + ", " + country + ", " + postalCode;

   IDE のコード補完機能を使用すると、フィールドを追加するのに役立ちます。

   
2. 必要に応じてインポートを修正し、変更内容を保存します。

Billable.java の編集

Billable エンティティークラスを開き、次の変更を行います。

1. 説明、コンサルタント ID、およびプロジェクトを返すように toString メソッドの return 文を変更します。

   public String toString() {
           return description + ", " + consultantId + ", " + project;

2. 必要に応じてインポートを修正し、変更内容を保存します。

Client.java の編集

1. recruiterCollection フィールドの @OneToMany 注釈を変更して関係を 1 対 1 にし、フィールドをコレクションから Recruiter recruiter に変更します。

   @OneToOne(mappedBy = "client")
   private Recruiter recruiter;

2. フィールドの名前の変更に基づいて、Collection<Recruiter> recruiterCollection の取得メソッドと設定メソッドを変更します。新しい取得メソッドと設定メソッドは次のようになります。

   public Recruiter getRecruiter() {
       return recruiter;
   }
   
   public void setRecruiter(Recruiter recruiter) {
       this.recruiter = recruiter;
   }

   Collection<Recruiter> recruiterCollection の取得メソッドと設定メソッドを削除してから、「コードを挿入」ダイアログを使用して Recruiter recruiter の新しい取得メソッドと設定メソッドを生成したほうが簡単かもしれません。新しい取得メソッドと設定メソッドを作成するには、ソースコード内を右クリックして「コードを挿入」(Alt-Insert) を選択し、「取得メソッドおよび設定メソッド」を選択します。「取得メソッドと設定メソッドの生成」ダイアログで「recruiter」を選択し、「生成」をクリックします。

   
3. String.valueOf(clientPK) を返すように toString メソッドの return 文を変更します。

   public String toString() {
       return String.valueOf(clientPK);
   }

4. 必要に応じてインポートを修正し、変更内容を保存します。

ClientPK.java の編集

1. クライアント名と部門番号を返すように toString メソッドの return 文を変更します。

   public String toString() {
       return clientName + ", " + "Dept. " + clientDepartmentNumber;
   }

2. 必要に応じてインポートを修正し、変更内容を保存します。

Consultant.java の編集

1. 電子メールを返すように toString メソッドの return 文を変更します。

   public String toString() {
       return email;
   }

2. 必要に応じてインポートを修正し、変更内容を保存します。

ConsultantStatus.java の編集

1. ステータス ID と説明を返すように toString メソッドの return 文を変更します。

   public String toString() {
       return statusId + ", " + description;
   }

2. 必要に応じてインポートを修正し、変更内容を保存します。

Project.java の編集

1. 次に示す内容を返すように toString メソッドの return 文を変更します。

   public String toString() {
       return (projectPK == null ? "(unnamed project)" : projectPK.getProjectName()) + ", " + client;
   }

2. 必要に応じてインポートを修正し、変更内容を保存します。

Recruiter.java の編集

1. client フィールドの @ManyToOne 注釈を変更して関係を 1 対 1 にマークします。

   @OneToOne
   private Client client;

2. 電子メールを返すように toString メソッドの return 文を変更します。

   public String toString() {
       return email;
   }

3. 必要に応じてインポートを修正し、変更内容を保存します。

アプリケーションでの Ajax の有効化について

「エンティティーからの JSF ページクラス」ウィザードの最後の区画では、「Ajax が有効な生成済みページ」を選択することで、JSF フレームワークの Dynamic Faces 拡張機能を通じてアプリケーションで Ajax 機能を有効にできます。ウィザードによって、必要な JSF 拡張ライブラリがプロジェクトに追加され、Ajax ライフサイクルが有効になるようにアプリケーションの配備記述子が構成されます。JSF の Dynamic Faces 拡張機能については、JavaServer Faces テクノロジの拡張機能のサイトを参照してください。

このオプションを選択すると、ウィザードは次の処理を実行します。

• プロジェクトで Dynamic Faces テクノロジを使用するために必要な JSF 拡張ライブラリがプロジェクトに追加されます (jsf-extensions-common、jsf-extensions-dynamic-faces、commons-logging、および shale-remoting)。
  
• javax.faces.LIFECYCLE_ID 初期化パラメータのエントリが追加され、その値が com.sun.faces.lifecycle.PARTIAL に設定されることで、web.xml は変更され、Ajax ライフサイクルを使用するように FacesServlet が構成されます。
  
• 「WEB-INF/jspf」ディレクトリ内に JSP フラグメントファイル AjaxScripts.jspf が生成されます。AjaxScripts.jspf は、Dynamic Faces ライブラリに含まれる JavaScript ファイルを描画します。

アプリケーションは、「Web ページ」ディレクトリに JavaScript ファイル jsfcrud.js を含みます。jsfcrud.js ファイルは、Dynamic Faces の JavaScript ファイルが描画されたかどうかを確認して、Dynamic Faces が有効になっているかどうかを確認します。Dynamic Faces が有効になっている場合は、Ajax 要求を送信するようにフォームが構成されます。

Dynamic Faces 拡張機能を使ってアプリケーションで Ajax を有効にしたら、アプリケーションを変更して、Dynamic Faces 拡張機能をさらに追加できます。

エンティティークラスの JPA コントローラクラスの生成

生成された Web アプリケーションでは、JPA コントローラのメソッドは JSF コントローラクラスのメソッドによってアクセスされます。「エンティティーからの JSF ページクラス」ウィザードを使用するとき、選択した各エンティティーの JPA コントローラクラスが自動的に生成されます。ただし、JPA コントローラクラスの使用は JSF Web アプリケーションに限定されません。JPA コントローラクラスは、Java Persistence API を使ってエンティティークラスを操作し、エンティティーの持続性を管理するほかのアプリケーション (デスクトップアプリケーションなど) でも使用できます。

「エンティティークラスの JPA コントローラクラス」ウィザードを使用すれば、プロジェクトで JPA コントローラクラスを簡単に作成できます。JPA コントローラクラスを作成するには、「新規ファイル」ウィザードを開き、「持続性」カテゴリから「エンティティークラスの JPA コントローラクラス」を選択します。ウィザードで、JPA コントローラクラスを作成するエンティティークラスを指定し、次にファイルの作成場所を指定します。このウィザードでは、JPA コントローラクラスによって使用される例外クラスも自動的に作成されます。

JPA コントローラが生成されたら、ほかのファイルからそのコントローラのメソッドにアクセスできるようになります。データベーススキーマを更新する場合は、「データベースからのエンティティークラス」ウィザードと「エンティティークラスの JPA コントローラクラス」ウィザードをもう一度実行して、クラスを更新できます。必要な場合は、JPA コントローラクラスを作成したあとに「エンティティーからの JSF ページクラス」ウィザードを実行し、既存の JPA コントローラクラスのパッケージを指定できます。この場合、既存の JPA コントローラクラスは、再生成されるのではなく利用されます。

SQL スクリプトによるデータの追加

Web フォームを使用してデータを追加しない場合は、derby-consult.zip に含まれている derby_insert_data_consult.sql スクリプトを実行できます。

1. derby_insert_data_consult.sql を開くには、メインメニューから「ファイル」>「ファイルを開く」を選択します。

   ファイルが SQL エディタで自動的に開きます。

2. SQL エディタツールバーの「接続」ドロップダウンリストで consult データベースが選択されていることを確認し、ツールバーの「SQL を実行」ボタンをクリックします。
   

   スクリプトの実行結果は「出力」ウィンドウで確認できます。

注: MySQL データベースサーバーを使用している場合は、mysql-consult.zip に含まれている mysql_insert_data_consult.sql ファイルを開いてください。

Web インタフェースによるデータの追加

データベースにデータを追加するには、ブラウザでアプリケーションを起動して Web フォームを使用する方法もあります。

1. メインツールバーで「主プロジェクトを実行」をクリックします。

   変更したファイルがすべて保存され、アプリケーションが再構築され、サーバーに配備されます。デフォルトの Web ブラウザでローカルアドレス http://localhost:8080/ConsultingAgency/ が開きます。

   
2. 「Show All Address Item」をクリックし、「New Address」をクリックします。
3. 「New Address」フォームで次のデータを追加します。

   フィールド	値
   Line1	100 Data Street
   Line2	Suite 432
   City	San Francisco
   Region	California
   Country	USA
   PostalCode	94103

   「Create」をクリックします。
4. 「Index」をクリックして index ページに戻ります。
5. 「Show All Client Items」をクリックし、「New Client」をクリックします。
6. 「New Client」フォームで次のデータを追加します。

   フィールド	値
   ClientDepartmentNumber	2000
   Client Name	Big Data Corp.
   Contact Email
   Contact Password	accounting

7. 「BillingAddress」ドロップダウンリストで「Palm Spring Street」を選択します。
8. 「Create」をクリックし、次に「Index」をクリックして、index ページに戻ります。
9. 「Show All Project Items」をクリックし、「New Project」をクリックします。
10. 「New Project」フォームで次のデータを追加します。

    フィールド	値
    ProjectName	Secret Project
    ContactEmail
    ContactPassword	project.manager

    「Create」をクリックし、次に「Index」をクリックして、index ページに戻ります。
11. 「Show All Consultant Status Item」をクリックし、次に「New Consultant Status」をクリックします。
12. 「New ConsultantStatus」フォームで次のデータを追加します。

    フィールド	値
    StatusId	A
    Description	Active

    「Create」をクリックし、次に「Index」をクリックして、index ページに戻ります。
13. 「Show All Consultant Item」をクリックし、「New Consultant」をクリックします。
14. 「New Consultant」フォームで次のデータを追加します。

    フィールド	値
    Email
    Password	janet.smart
    HourlyRate	80
    BillableHourlyRate	120

15. 「ProjectCollection」フィールドで「Secret Project」を選択します。
16. 「StatusId」ドロップダウンリストで「A, Active」を選択します。
17. 「Create」をクリックし、次に「Index」をクリックして、index ページに戻ります。
18. 「Show All Billable Items」をクリックし、「New Billable」をクリックします。
19. 「New Billable」フォームで次のデータを追加します。

    フィールド	値
    StartDate	2008-10-13 00:00:00.0
    EndDate	2008-10-17 00:00:00.0
    Hours	40
    HourlyRate	80
    BillableHourlyRate	120
    Description	begin gathering requirements
    ConsultantId
    Project	Secret Project

    「Create」をクリックし、「New Billable」をクリックします。
20. 「New Billable」フォームで次のデータを追加します。

    今度は、「Description」フィールドに「finish gathering requirements」と入力します。

    フィールド	値
    StartDate	2008-10-20 00:00:00.0
    EndDate	2008-10-24 00:00:00.0
    Hours	40
    HourlyRate	80
    BillableHourlyRate	120
    Description	finish gathering requirements
    ConsultantId
    Project	Secret Project

    「Create」をクリックして index ページに戻ります。
21. 「Show All Recruiter Item」をクリックし、「New Recruiter」をクリックします。
22. 「New Recruiter」フォームで次のデータを追加します。

    フィールド	値
    Email
    Password	bob

23. 「ConsultantCollection」リストで「」を選択します。

    注: 「Client」ドロップダウンリストは空のままにします。

24. 「Create」をクリックし、次に「Index」をクリックして、index ページに戻ります。

データベースにデータを追加したら、生成された各ページに移動して、表間の関係を確認できます。

読み取り専用の主キーフィールド

データベース内のあるフィールドが主キーである場合は、生成されたフォーム内でユーザーがそのフィールドを編集できないようにするためのコードがウィザードによって生成されます。主キーフィールドが読み取り専用となっている場合の例を次に示します。

• 「New Client」ページに移動すると、「ProjectCollection」フィールドが読み取り専用であることがわかります。既存のプロジェクトに関連付けられているクライアントの変更をアプリケーションで許可したとしても、プロジェクトに関連付けられているクライアントがプロジェクトの主キーの一部であるため、操作は失敗します。これを SQL スクリプトで確認するには、consult_project_pk 主キーと consult_project_fk_client_name 外部キーを調べます。
• 「Editing Project」ページに移動すると、「Client」フィールドが読み取り専用であることがわかります。このフィールドも、プロジェクトに関連付けられているクライアントがプロジェクトの主キーの一部であるので、読み取り専用になっています。

生成されるエラーチェック機能

生成されたコードでは、ユーザーのアクションがエラーになるかどうかを確認できます。たとえば、null 可能ではない列が表にある場合は、アクションによってそのフィールドが null になるかどうかを確認し、null になる場合はエラーメッセージを表示できます。データベースにデータを入力したあと、フォームでデータを編集してみることで、生成されたチェック機能の例を確認できます。次のアクションを行うとエラーメッセージを受け取ります。

• 別の Project 項目を作成して、「ProjectName」にもう一度「Secret Project」を指定し、「ContactEmail」フィールドと「Client」フィールドに値を入力します。

  項目がすでに存在することを示すエラーメッセージが表示されます。

• 別の Address 項目を作成し、すべてのフィールドを空のままにします。

  必須フィールドを示すエラーメッセージが表示されます。

• 「BillableCollection」リストで「finish gathering requirements」を選択解除して、Consultant 項目「」を編集します。

  「consultantId」フィールドは null にできないため、選択解除した Billable 項目は保持する必要があることを示すエラーメッセージが表示されます。

• Project 項目「Secret Project, Big Data Corp., Dept. 2000」を破棄します。

  関連付けられている Billable 項目の「project」フィールドは null にできないため、この Project 項目は破棄できないことを示すエラーメッセージが表示されます。

• 別のユーザーによってすでに破棄されている項目を破棄します。

  この項目が存在しないことを示すエラーメッセージが表示され、項目がリストに表示されなくなります。

  これは、2 つのブラウザを使用して、各ブラウザから同じページ (「Listing Billable Items 」ページなど) に移動した場合に実行できます。一方のブラウザで Billable 項目を 1 つ破棄してから、もう一方のブラウザで同じ項目を破棄してみます。