Google Git
Sign in
apache / netbeans-website-cleanup / refs/heads/asciidoc-features / . / src / content / kb / docs / javaee / ecommerce / entity-session_ja.html
blob: e91fd4c1f88a97ebf9576f01c9166233e32f211c [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="author" content="troy.giunipero@sun.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="description" content="This tutorial unit demonstrates how to use the IDE to create JPA entity classes from a database, and EJB session beans from entity classes.">
<meta name="keywords" content="NetBeans, IDE, integrated development environment,
Java, Java EE, open source, web technology, e-commerce">
<link rel="stylesheet" type="text/css" href="../../../../netbeans.css">
<link rel="stylesheet" type="text/css" href="../../../../print.css" media="print">
<link rel="stylesheet" type="text/css" href="../../../../lytebox.css" media="screen">
<script type="text/javascript" src="../../../../images_www/js/lytebox-compressed.js"></script>
<title>NetBeans Eコマースのチュートリアル - エンティティ・クラスおよびセッションBeanの追加</title>
</head>
<body>
<!-- Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. -->
<h1>NetBeans Eコマースのチュートリアル - エンティティ・クラスおよびセッションBeanの追加</h1>
<div style="margin-left:-3px">
<div class="feedback-box margin-around float-left" style="margin-right:15px">
<h4>チュートリアルの目次</h4>
<ol>
<li><a href="intro.html">概要</a></li>
<li><a href="design.html">アプリケーションの設計</a></li>
<li><a href="setup-dev-environ.html">開発環境の設定</a></li>
<li><a href="data-model.html">データ・モデルの設計</a></li>
<li><a href="page-views-controller.html">ページ・ビューおよびコントローラ・サーブレットの準備</a></li>
<li><a href="connect-db.html">データベースへのアプリケーションの接続</a></li>
<li><strong>エンティティ・クラスおよびセッションBeanの追加</strong>
<ul style="margin: 5px 0 0 -2em">
<li><a href="#whatEJB">EJBおよびJPAテクノロジとは</a></li>
<li><a href="#whatSession">セッションBeanとは</a></li>
<li><a href="#specification">仕様および実装について</a></li>
<li><a href="#addEntity">エンティティ・クラスの追加</a></li>
<li><a href="#addSession">セッションBeanの追加</a></li>
<li><a href="#access">EJBによるデータへのアクセス</a></li>
<li><a href="#seeAlso">関連項目</a></li>
</ul></li>
<li><a href="manage-sessions.html">セッションの管理</a></li>
<li><a href="transaction.html">トランザクション・ビジネス・ロジックの統合</a></li>
<li><a href="language.html">言語サポートの追加</a></li>
<li><a href="security.html">アプリケーションの保護</a></li>
<li><a href="test-profile.html">テストとプロファイリング</a></li>
<li><a href="conclusion.html">まとめ</a></li>
</ol>
</div>
</div>
<p><img alt="このページの内容は、NetBeans IDEバージョン6.8および6.9に適用されます" class="stamp" src="../../../../images_www/articles/68/netbeans-stamp-68-69.png" title="このページの内容は、NetBeans IDEバージョン6.8および6.9に適用されます"></p>
<p>このチュートリアル・ユニットでは、EJB (<a href="http://java.sun.com/products/ejb/" target="_blank">Enterprise JavaBeans</a>)およびJPA (<a href="http://java.sun.com/javaee/technologies/persistence.jsp" target="_blank">Java Persistence</a>)テクノロジを紹介します。この中で、Java EE開発に不可欠な2つのIDEのウィザードを使用します。これらを次に示します。</p>
<ul style="margin-left: 320px">
<li><strong>データベースからのエンティティ・クラス・ウィザード:</strong> 選択したデータベースの表ごとに、名前付き問合せ注釈、各列を表すフィールド、および外部キーを表す関係を備えたJava Persistence APIエンティティ・クラスを作成します。</li>
<li><strong>エンティティ・クラスのセッションBean・ウィザード:</strong> エンティティ・クラスごとに、基本的なアクセス・メソッドを備えたEJBセッション・ファサードを作成します。</li>
</ul>
<p>これらの2つのウィザードは、アプリケーションのモデルをすばやく設定するための効率的な方法を提供します。ビルドしているアプリケーションの<a href="design.html#mvcDiagram">MVC図</a>をもう一度参照してください。MVCの構成内で、EJBセッションBeanおよびJPAエンティティ・クラスが対応する場所を確認できます。</p>
<div class="indent" style="text-align: center">
<img alt="AffableBeanアプリケーションのMVC図" src="../../../../images_www/articles/73/javaee/ecommerce/design/mvc-diagram.png" style=" margin-top:10px; margin-bottom:10px" title="AffableBeanアプリケーションのMVC図">
</div>
<p>このユニットでは、エンティティ・クラスを作成して、Java上で<code>affablebean</code>データベースを表します。各エンティティ・クラスがデータベースの表を表す一方で、エンティティ・クラスのインスタンスは、データベースに保存(つまり<em>持続</em>)可能なレコードに対応します。アプリケーションのビジネス・ロジックはセッションBeanによってカプセル化され、(ここで示すように)エンティティへのCRUD (Create-Read-Update-Delete)アクセスを可能にする<em>ファサード</em>・クラスとして使用したり、アプリケーション固有のアクションを実装するコードを含めたりできます。(この例は、<a href="transaction.html">ユニット9: トランザクション・ビジネス・ロジックの統合</a>に記載)。</p>
<p>このチュートリアルでビルドするアプリケーションのライブ・デモを、<a href="http://dot.netbeans.org:8080/AffableBean/" target="_blank">NetBeans Eコマースのチュートリアルのデモ・アプリケーション</a>で表示できます。</p>
<br style="clear:left;">
<br>
<table>
<tbody>
<tr>
<th class="tblheader" scope="col">ソフトウェアまたはリソース</th>
<th class="tblheader" scope="col">必須バージョン</th>
</tr>
<tr>
<td class="tbltd1"><a href="https://netbeans.org/downloads/index.html" target="_blank">NetBeans IDE</a></td>
<td class="tbltd1">Javaバンドル版、6.8または6.9</td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html" target="_blank">Java Development Kit (JDK)</a></td>
<td class="tbltd1">バージョン6</td>
</tr>
<tr>
<td class="tbltd1"><a href="#glassFish">GlassFishサーバー</a></td>
<td class="tbltd1">v3またはOpen Source Edition 3.0.1</td>
</tr>
<tr>
<td class="tbltd1"><a href="http://dev.mysql.com/downloads/mysql/" target="_blank">MySQLデータベース・サーバー</a></td>
<td class="tbltd1">バージョン5.1</td>
</tr>
<tr>
<td class="tbltd1"><a href="https://netbeans.org/projects/samples/downloads/download/Samples%252FJavaEE%252Fecommerce%252FAffableBean_snapshot3.zip">AffableBeanプロジェクト</a></td>
<td class="tbltd1">スナップショット3</td>
</tr>
</tbody>
</table>
<p><strong class="notes">注意: </strong></p>
<ul>
<li>NetBeans IDEが正常に動作するには、JDK (Java Development Kit)が必要です。上記に一覧表示されているいずれのリソースもインストールされていない場合は、最初にJDKをダウンロードしてインストールするようにしてください。</li>
<li>NetBeans IDEのJavaバンドル版には、このチュートリアルでビルドするアプリケーションに必要なJava WebおよびEEテクノロジが含まれています。</li>
<li id="glassFish">NetBeans IDEのJavaバンドル版には、このチュートリアルに必要なGlassFishサーバーも含まれています。<a href="https://glassfish.dev.java.net/public/downloadsindex.html" target="_blank">GlassFishサーバーを別個にダウンロードする</a>こともできますが、NetBeansダウンロードに付属するバージョンを使用すると、IDEに自動的に登録されるので便利です。</li>
<li>このチュートリアル・ユニットは、以前のユニットを完了させていなくても進めることができます。そのために、データベースの準備や、IDE、GlassFishおよびMySQL間の接続の確立について説明した<a href="setup.html">設定手順</a>を参照してください。</li>
<li><code>AffableBean</code>プロジェクトの<a href="https://netbeans.org/projects/samples/downloads/download/Samples%252FJavaEE%252Fecommerce%252FAffableBean_snapshot4.zip">スナップショット4</a>をダウンロードでき、これはNetBeans IDE 6.9を使用してこのユニットを完了させた後の状態のプロジェクトに対応しています。</li>
</ul>
<br>
<h2 id="whatEJB">EJBおよびJPAテクノロジとは</h2>
<p>このチュートリアルで今まで開発してきたプロジェクトは、Apache Tomcatなどのサーブレット・コンテナを使用して、Webブラウザで実行できました。結局のところ、ここまではJSTLおよびサーブレット・テクノロジを利用したのみで、JDBCを使用して直接データベースに接続しています。実際、アプリケーションのすべての側面(スレッドの安全性、トランザクション、セキュリティなど)のために手動でコーディングしながら、これらのテクノロジのみを使用してアプリケーションの開発を続けることも理論的には可能です。しかし、エンタープライズBeanとJPAエンティティ・クラスを使用すると、すでに十分に試行された信頼できるソリューションを使用しながら、アプリケーションのビジネス・ロジックに集中できるようになります。後続の各項ではこの2つのテクノロジを紹介し、EE開発でこれらが担う役割を説明します。</p>
<ul>
<li><a href="#ejb">エンタープライズJavaBeans</a></li>
<li><a href="#jpa">Java Persistence</a></li>
</ul>
<div class="indent">
<h3 id="ejb">エンタープライズJavaBeans</h3>
<p><a href="http://java.sun.com/products/ejb/" target="_blank">EJB製品の公式ページ</a>では、エンタープライズJavaBeansテクノロジを「分散型の、トランザクション可能な、セキュリティ保護された、可搬性があるアプリケーションの開発をすばやく簡単に行うことができるサーバー側コンポーネント・アーキテクチャ」と説明しています。EJB (エンタープライズBean)をプロジェクトに適用しても、このテクノロジが提供するサービスは開発者にとって透過的なままであり、EJBを使用しない場合に必要になる、大量のボイラープレート・コードを追加する退屈で間違えやすい作業を取り除くことができます。EE開発の経験が少ない場合、作成するJava WebアプリケーションでのEJBの必要性を疑問に思うかもしれません。Debu Panda氏、Reza Rahman氏およびDerek Lane氏による『<a href="http://www.manning.com/panda/" target="_blank">EJB 3 In Action</a>』の本では、EJBテクノロジの役割を次のようにうまく言い換えています。</p>
<blockquote style="margin-top: 0">
<em>中規模の、比較的単純なWebアプリケーションの開発のためにEJBを使用することは大げさであると多くの人が考えていますが、これは大きな誤りです。家を建設するとき、すべてを一から造るわけではありません。かわりに資材を買ったり、必要に応じて請負業者のサービスを申し込んだりもします。同様に、エンタープライズ・アプリケーションを一からビルドすることはあまり現実的ではありません。ほとんどのサーバー側アプリケーションには、変動するビジネス・ロジック、アプリケーション状態の管理、リレーショナル・データベースに対する情報の格納および取得、トランザクションの管理、セキュリティの実装、非同期処理の実行、システムの統合など、多くの共通点があります。<br><br>フレームワークとして、EJBコンテナはこの種の共通の機能をすぐに使用できるサービスとして提供しており、EJBコンポーネントが車輪を再発明することなくアプリケーション内でこれらのサービスを使用できるようになっています。たとえば、Webアプリケーションでクレジット・カード・モジュールをビルドするときに、トランザクションやセキュリティ・アクセス制御の管理のために複雑で間違えやすい大量のコードを書いているとします。これは、EJBコンテナが提供する宣言型のトランザクションやセキュリティ・サービスを使用すれば避けられるはずです。EJBコンポーネントがEJBコンテナへデプロイされると、これらのサービスの他にも数々のサービスを使用できるようになります。これにより、高品質で豊富な機能を持つアプリケーションが、想像を大きく上回るほどの速さで書けるようになります。</em><sup><a href="#footnote1" id="1" style="text-decoration:none">[1]</a></sup>
</blockquote>
<p>EJBは、プロジェクトに組み込まれたコンポーネントまたはJavaクラスと考えることも、多数のエンタープライズ関連のサービスを提供する<em>フレームワーク</em>と考えることもできます。このチュートリアルで利用するサービスのいくつかについては、『<a href="http://www.manning.com/panda/" target="_blank">EJB 3 In Action</a>』で次のように説明されています。</p>
<ul>
<li><strong>プール:</strong> EJBプラットフォームは、EJBコンポーネントごとに、クライアントで共有されるコンポーネント・インスタンスのプールを作成します。どの時点でも、プールされた各インスタンスを使用できるのは単一のクライアントのみです。インスタンスがクライアントへのサービスを終了すると、再生用にガベージ・コレクタによって破棄されるのではなく、再利用のためにプールに返されます。</li>
<li><strong>スレッドの安全性:</strong> EJBは、完全に見えない方法で、すべてのコンポーネントをスレッド・セーフおよび高性能にします。これは、シングル・スレッドのデスクトップ・アプリケーションのようにサーバー・コンポーネントを記述できることを意味します。コンポーネント自体がどれほど複雑であっても、EJBによって確実にスレッド・セーフになります。</li>
<li><strong>トランザクション:</strong> EJBは宣言型のトランザクション管理をサポートします。宣言型のトランザクション管理では、コードのかわりに単純な構成を使用してコンポーネントにトランザクション可能な動作を追加できます。実質的に、どのようなコンポーネント・メソッドもトランザクション可能として指定できます。メソッドが正常に完了すると、EJBはトランザクションを確定して、メソッドによるデータの変更を永続的なものにします。それ以外の場合は、トランザクションがロール・バックされます。コンテナ管理対象EJBトランザクションについては、ユニット9の<a href="transaction.html">トランザクション・ビジネス・ロジックの統合</a>で説明します。</li>
<li><strong>セキュリティ: </strong>EJBは、JAAS (Java Authentication and Authorization Service) APIとの統合をサポートしているため、アプリケーションをセキュリティ・コードで複雑にするかわりに、セキュリティを完全に外部に切り離して単純な構成でアプリケーションをセキュリティ保護できます。<sup><a href="#footnote2" id="2" style="text-decoration:none">[2]</a></sup>ユニット11の<a href="security.html#secureEJB">アプリケーションの保護</a>では、EJBの&lt;a href="http://download.oracle.com/javaee/6/api/javax/annotation/security/RolesAllowed.html" target="_blank"<code>@RolesAllowed</code></a>注釈を示します。</li>
</ul>
<h3 id="jpa">Java Persistence</h3>
<p>Javaエンタープライズの文脈での「<em>持続性</em>」とは、Javaオブジェクトに含まれるデータを自動的にリレーショナル・データベースに格納する動作を指します。JPA (<a href="http://java.sun.com/javaee/technologies/persistence.jsp" target="_blank">Java Persistence API</a>)は、開発者にとって透過的な方法で、アプリケーションがJavaオブジェクトとリレーショナル・データベース間でデータを管理できるようにするORM (Object-Relational Mapping: オブジェクト関係マッピング)テクノロジです。これは、データ・モデルをミラー化する一連のJavaクラス(<em>エンティティ</em>)を作成および構成することで、JPAをプロジェクトに適用できることを意味します。そうすると、アプリケーションがデータベースに直接アクセスしているようにこれらのエンティティにアクセスできます。</p>
<p>プロジェクトでJPAを使用すると、次のような様々なメリットがあります。</p>
<ul>
<li>JPAには、静的および動的な問合せのための、固有の充実したSQLのような問合せ言語があります。JPQL (Java Persistence Query Language)を使用することで、アプリケーションが異なるデータベース・ベンダー間の可搬性を維持できます。</li>
<li>低レベル、冗長、そして間違えやすいJDBC/SQLコードを書く作業を避けることができます。</li>
<li>JPAは、データのキャッシュおよびパフォーマンスの最適化のサービスを透過的に提供します。</li>
</ul>
</div>
<br>
<h2 id="whatSession">セッションBeanとは</h2>
<p>エンタープライズ・セッションBeanは、特定のビジネス操作を実行するためにクライアントによって呼び出されます。「<em>セッション</em>」という名前には、Beanインスタンスが「仕事の単位」の期間使用できるという意味が含まれています。<a href="http://jcp.org/aboutJava/communityprocess/final/jsr318/index.html" target="_blank">EJB 3.1仕様</a>では、一般的なセッション・オブジェクトを、次のような特長を持つものとして説明しています。</p>
<ul class="toc">
<li>単一のクライアントのかわりに実行</li>
<li>トランザクション対応可能</li>
<li>配下のデータベースの共有データを更新</li>
<li>データベースの共有データを直接示すわけではないが、アクセスおよび更新ができる</li>
<li>比較的存在期間が短い</li>
<li>EJBコンテナがクラッシュすると除去される。処理を続けるには、クライアントは新しいセッション・オブジェクトを再確立する必要があります。</li>
</ul>
<p>EJBは、<em>ステートフル</em>、<em>ステートレス</em>および<em>シングルトン</em>の3タイプのセッションBeanを提供します。次の説明は、<a href="http://download.oracle.com/docs/cd/E17410_01/javaee/6/tutorial/doc/index.html" target="_blank">Java EE 6チュートリアル</a>の内容を元にしたものです。</p>
<ul>
<li><strong>ステートフル:</strong> Beanの状態は、複数のメソッド・コールにわたって維持されます。「状態」とは、そのインスタンス変数の値を示します。クライアントがBeanと対話するため、この状態はよく「<em>対話形式の</em>」状態と呼ばれます。</li>
<li><strong>ステートレス:</strong> ステートレスBeanは、単一のメソッド・コールで発生する可能性のある操作に使用されます。メソッドが処理を終了すると、クライアント固有のBeanの状態は保持されません。したがって、ステートレス・セッションBeanは、クライアントと対話形式の状態を維持しません。</li>
<li><strong>シングルトン:</strong> シングルトン・セッションBeanは、アプリケーションごとに1度インスタンス化され、アプリケーションのライフサイクルの間存在します。シングルトン・セッションBeanは、単一のエンタープライズBeanインスタンスがクライアント間で共有され、並行してアクセスされる場合用に設計されています。</li>
</ul>
<p class="tips">EJBセッションBeanの詳細は、<a href="http://download.oracle.com/docs/cd/E17410_01/javaee/6/tutorial/doc/gipjg.html" target="_blank">Java EE 6チュートリアル: セッションBeanとは</a>を参照してください。</p>
<p>このチュートリアルのEコマース・アプリケーション開発で使用するのは、ステートレス・セッションBeanのみです。</p>
<br>
<h2 id="specification">仕様および実装について</h2>
<p>EJBおよびJPAテクノロジは、次の仕様によって定義されています。</p>
<ul>
<li><a href="http://jcp.org/en/jsr/summary?id=317" target="_blank">JSR 317: Java Persistence 2.0</a></li>
<li><a href="http://jcp.org/en/jsr/summary?id=318" target="_blank">JSR 318: Enterprise JavaBeans 3.1</a></li>
</ul>
<p>これらの仕様はテクノロジを定義しています。しかし、テクノロジをプロジェクトに適用するには、仕様の<em>実装</em>を使用する必要があります。仕様が確定すると、テクノロジの無償の実装であるリファレンス実装が含まれます。この概念がわかりにくい場合は、次のような例で考えてください。音楽作品(つまり、ページ上の音符)とは、1つの曲のことです。演奏者は、その曲を学んで演奏を録音するときに、曲の<em>解釈</em>を提供します。このように、音楽作品は技術仕様に対応し、演奏者の録音は仕様の実装に対応します。</p>
<p class="tips">Java技術仕様と、その正式な標準化定義については、<a href="intro.html#jcp">Javaコミュニティ・プロセスとは</a>を参照してください。</p>
<p>EJBおよびJPA仕様の最終リリースのダウンロード・ページを調べると、次のリファレンス実装へのリンクが見つかります。</p>
<ul>
<li><strong>JPA:</strong> <a href="http://www.eclipse.org/eclipselink/downloads/ri.php" target="_blank">http://www.eclipse.org/eclipselink/downloads/ri.php</a></li>
<li><strong>EJB:</strong> <a href="http://glassfish.dev.java.net/downloads/ri" target="_blank">http://glassfish.dev.java.net/downloads/ri</a></li>
</ul>
<p>JPA仕様の実装は<em>持続性プロバイダ</em>と呼ばれており、JPA 2.0仕様のリファレンス実装として選択された持続性プロバイダは<a href="http://www.eclipse.org/eclipselink/" target="_blank">EclipseLink</a>です。</p>
<p>EJBリファレンス実装のリンクを調べると、EJBの実装のみでなく、<a href="https://glassfish.dev.java.net/" target="_blank">プロジェクトGlassFish</a>が提供するすべてのリファレンス実装が一覧表示されたページに移動します。この理由は、プロジェクトGlassFishがJava EE 6プラットフォーム仕様(<a href="http://jcp.org/en/jsr/summary?id=316" target="_blank">JSR 316</a>)のリファレンス実装を形成しているためです。このチュートリアルでEコマース・プロジェクトをビルドするのに使用するGlassFish v3アプリケーション・サーバー(Open Source Edition)には、プロジェクトGlassFishの元で開発されたすべてのテクノロジのリファレンス実装が含まれています。このことから、これはJava EE 6<em>コンテナ</em>と呼ばれています。</p>
<p>Java EEコンテナには、Web (サーブレット)コンテナ、EJBコンテナおよび持続性プロバイダの3つの必須コンポーネントが含まれています。Eコマース・アプリケーションのデプロイメント・シナリオを次の図に示しています。このユニットで作成するエンティティ・クラスは、持続性プロバイダによって管理されます。このユニットで作成するセッションBeanは、EJBコンテナによって管理されます。ビューは、Webコンテナによって管理されるJSPページでレンダリングされます。</p>
<div id="gf-java-ee-container" class="indent">
<img alt="GlassFish v3 Java EEコンテナ" class="margin-around" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/java-ee-container.png" title="GlassFish v3には、Webコンテナ、EJBコンテナおよびEclipseLink (持続性プロバイダ)がJava EEコンテナとして格納される">
</div>
<br>
<h2 id="addEntity">エンティティ・クラスの追加</h2>
<p>まず、IDEのデータベースからのエンティティ・クラス・ウィザードを使用して、<code>affablebean</code>スキーマに基づくエンティティ・クラスを生成します。このウィザードは、配下の持続性プロバイダに依存してこの作業を行います。</p>
<ol>
<li>IDEで<a href="https://netbeans.org/projects/samples/downloads/download/Samples%252FJavaEE%252Fecommerce%252FAffableBean_snapshot3.zip">プロジェクト・スナップショット</a>を開きます。IDEで、[Ctrl]-[Shift]-[O] (Macの場合は[⌘]-[Shift]-[O])を押し、ダウンロードしたファイルを解凍したコンピュータ上の場所に移動します。</li>
<li>[Ctrl]-[N] (Macの場合は[⌘]-[N])を押して、ファイル・ウィザードを開きます。</li>
<li>「持続性」カテゴリから「データベースからのエンティティ・クラス」を選択します。「次」をクリックします。</li>
<li>ステップ2の「データベース表」で、「データ・ソース」ドロップダウン・リストから「<code>jdbc/affablebean</code>」を選択します。ドロップダウン・リストは、アプリケーション・サーバーに登録されたデータ・ソースによって生成されます。<br><br><code>jdbc/affablebean</code>データ・ソースを選択すると、IDEによってデータベースがスキャンされ、「使用可能な表」ペインにデータベースの表が一覧表示されます。<br><img alt="データベースからのエンティティ・クラス・ウィザード" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/entity-from-database.png" style="width: 688px" title="使用可能なデータ・ソースの選択し、IDEでデータベースの表を読み取らせる"></li>
<li>「すべてを追加」ボタンをクリックしてから「次」クリックします。</li>
<li>データベースからのエンティティ・クラス・ウィザードのステップ3は、NetBeans IDE 6.8と6.9で少し異なります。使用するIDEのバージョンに応じて、以下の手順を実行します。
<ul style="margin: 5px 0 0 -1em">
<li><a href="#68">NetBeans IDE 6.8</a></li>
<li><a href="#69">NetBeans IDE 6.9</a></li>
</ul>
<h4 id="68">NetBeans IDE 6.8</h4>
<img alt="データベースからのエンティティ・クラス・ウィザード、ステップ3: エンティティ・クラス" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/entity-classes-68.png" title="NetBeans 6.8 - データベースからのエンティティ・クラス・ウィザード、ステップ3: エンティティ・クラス" width="688px">
<ol style="list-style-type: lower-alpha">
<li>「パッケージ」フィールドに「<strong>entity</strong>」と入力します。ウィザードの完了時に、エンティティ・クラスの新しいパッケージが作成されます。</li>
<li>「持続性ユニットを作成」ボタンをクリックします。「持続性ユニットを作成」ダイアログが開きます。<br><img alt="「持続性ユニットを作成」ダイアログ" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/create-pu.png" title="「持続性ユニットを作成」ダイアログを使用したpersistence.xmlファイルの生成"><br><em>持続性ユニット</em>とは、アプリケーション内に存在するエンティティ・クラスのコレクションのことです。上のダイアログで、持続性プロバイダが持続性ユニットの構成設定を指定するために使用する<code>persistence.xml</code>ファイルが生成されます。このプロジェクトに関連付けられたサーバーには、「EclipseLink (JPA 2.0)」がデフォルトで選択されています。「表生成の方針」は「<code>なし</code>」のままにします。これにより、持続性プロバイダがデータベースに影響しないようになります。(たとえば、持続性プロバイダに、データベースを削除してから既存のエンティティ・クラスに基づいてデータベースを再作成させる場合は、方針を「<code>ドロップして作成</code>」に設定します。この場合、このアクションはプロジェクトがデプロイされるたびに行われます。)</li>
<li>「作成」をクリックします。</li>
<li>ステップ3の「エンティティ・クラス」に戻ると、エンティティのクラス名がデータベースの表に基づいたものになっています。たとえば、<code>CustomerOrder</code>エンティティは<code>customer_order</code>データベース表にマップされています。また、「持続フィールド用のNamedQuery注釈を生成」オプションがデフォルトで選択されています。このチュートリアルの後半で、様々な名前付き問合せを使用します。</li>
<li>下の<a href="#step7">ステップ7</a>に進みます。</li>
</ol>
<h4 id="69">NetBeans IDE 6.9</h4>
<img alt="データベースからのエンティティ・クラス・ウィザード、ステップ3: エンティティ・クラス" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/entity-classes-69.png" title="NetBeans 6.9 - データベースからのエンティティ・クラス・ウィザード、ステップ3: エンティティ・クラス" width="688px">
<ol style="list-style-type: lower-alpha">
<li>「パッケージ」フィールドに「<strong>entity</strong>」と入力します。ウィザードの完了時に、エンティティ・クラスの新しいパッケージが作成されます。</li>
<li>次の点に注意してください。
<ul style="margin: 5px 0 0 -2em">
<li>エンティティのクラス名は、データベース表に基づきます。たとえば、<code>CustomerOrder</code>エンティティは<code>customer_order</code>データベース表にマップされます。</li>
<li>「持続フィールド用のNamedQuery注釈を生成」オプションはデフォルトで選択されています。このチュートリアルの後半で、様々な名前付き問合せを使用します。</li>
<li>「持続性ユニットを作成」オプションはデフォルトで選択されています。<em>持続性ユニット</em>は、アプリケーション内に存在するエンティティ・クラスのコレクションです。持続性ユニットは、持続性プロバイダが読み取る<code>persistence.xml</code>構成ファイルで定義されます。したがって、このオプションを有効にすることは、ウィザードによって<code>persistence.xml</code>ファイルが生成されてデフォルト設定が割り当てられることにもなります。</li>
</ul>
</li>
</ol></li>
<li id="step7">「終了」をクリックします。JPAエンティティ・クラスが<code>affablebean</code>データベース表に基づいて生成されます。「プロジェクト」ウィンドウで新しく作成された<code>entity</code>パッケージを展開すると、エンティティ・クラスを調べることができます。また、「構成ファイル」ノードの下には新しい持続性ユニットがあります。<br><img alt="「プロジェクト」ウィンドウ - プロジェクトに表示されたエンティティ・クラス" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/entity-classes.png" title="「プロジェクト」ウィンドウでの新しいエンティティ・クラスの表示"><br><br>ウィザードによって、追加のエンティティ・クラス<code>OrderedProductPK</code>が生成されています。データ・モデルの<code>ordered_product</code>表は、<code>customer_order</code>および<code>product</code>の両方の表の主キーで構成される複合主キーを使用することを思い出してください。(<a href="data-model.html#manyToMany">データ・モデルの設計 - 多対多の関係の作成</a>を参照。)このため、持続性プロバイダは複合キーのための別個のエンティティ・クラスを作成して、<code>OrderedProduct</code>エンティティに<em>埋込みます</em>。<code>OrderedProduct</code>をエディタで開くと、これを調べることができます。JPAは、組込み可能なクラスが複合主キーであることを示すために、<code>@EmbeddedId</code>注釈を使用します。
<pre class="examplecode">
public class OrderedProduct implements Serializable {
private static final long serialVersionUID = 1L;
<strong>@EmbeddedId</strong>
protected OrderedProductPK orderedProductPK;</pre>
<p class="tips"><code>@EmbeddedId</code>注釈で[Ctrl]-[Space]を押してAPIドキュメントを呼び出します。</p>
<img alt="@EmbeddedIdで呼び出されたAPIドキュメント" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/embedded-id.png" title="[Ctrl]-[Space]の押下によるAPIドキュメントの呼出し"></li>
<li id="pu">エディタで持続性ユニット(<code>persistence.xml</code>)を開きます。IDEには「XML」ビューに加え、持続性ユニットのための「デザイン」ビューも用意されています。「デザイン」ビューは、プロジェクトの持続性プロバイダの管理構成を変更するための便利な方法を提供します。<br><img alt="AffableBeanPU持続性ユニットの「デザイン」ビュー" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/persistence-unit.png" style="width: 688px" title="AffableBeanPU持続性ユニットの「デザイン」ビュー"></li>
<li><code>AffableBeanPU</code>持続ユニットの最上部にある「XML」タブをクリックして、「XML」ビューを開きます。ファイルに次のプロパティを追加します。
<pre class="examplecode">
&lt;persistence-unit name=&quot;AffableBeanPU&quot; transaction-type=&quot;JTA&quot;&gt;
&lt;jta-data-source&gt;jdbc/affablebean&lt;/jta-data-source&gt;
<strong>&lt;properties&gt;
&lt;property name=&quot;eclipselink.logging.level&quot; value=&quot;FINEST&quot;/&gt;
&lt;/properties&gt;</strong>
&lt;/persistence-unit&gt;</pre>
アプリケーションを実行したときに持続性プロバイダによって生成される出力がすべて表示されるように、ロギング・レベルのプロパティを<code>FINEST</code>に設定しました。これによって、持続性プロバイダがデータベースで使用しているSQLが確認できるようになり、どのようなデバッグが必要になったとしても、デバッグが容易になります。<br><br>
<p class="tips">ロギングの説明およびすべてのロギング値の一覧については、公式のEclipseLinkドキュメント(<a href="http://wiki.eclipse.org/EclipseLink/Examples/JPA/Logging" target="_blank">ロギングの構成方法</a>)を参照してください。</p></li>
</ol>
<br>
<h2 id="addSession">セッションBeanの追加</h2>
<p>この項では、IDEのエンティティ・クラスのセッションBean・ウィザードを使用して、作成したばかりのエンティティ・クラスごとにEJB<em>セッション・ファサード</em>を生成します。各セッションBeanには、それぞれのエンティティ・クラスのための基本的なアクセス・メソッドが含まれます。</p>
<p><em>セッション・ファサード</em>とは、<a href="http://java.sun.com/blueprints/enterprise/index.html" target="_blank">エンタープライズ・ブループリント・プログラム</a>で公表されているデザイン・パターンです。<a href="http://java.sun.com/blueprints/corej2eepatterns/Patterns/SessionFacade.html" target="_blank">コアJ2EEパターン・カタログ</a>に記載されているように、これは多層アプリケーション環境で起こる次のような共通する問題の解決を図るものです。</p>
<ul class="toc">
<li>密結合による、クライアントとビジネス・オブジェクト間の直接の依存性</li>
<li>クライアントとサーバー間の過多のメソッド呼出しによる、ネットワーク・パフォーマンスの問題</li>
<li>クライアント・アクセス方針が一貫しないことによる、ビジネス・オブジェクトの誤用</li>
</ul>
<p>セッション・ファサードは、配下のビジネス・オブジェクトの相互作用を抽象化して、必要な機能のみを使用できるようにするサービス・レイヤーを提供します。これにより、参加者間の複雑な相互作用がクライアントに表示されなくなります。このようにして、セッションBean (セッション・ファサードを表します)はビジネス・オブジェクト間の関係を管理します。また、セッションBeanは、ワークフローの必要に応じて参加者を作成、配置、変更および削除することで、参加者のライフサイクルも管理します。</p>
<ol>
<li>[Ctrl]-[N] (Macの場合は[⌘]-[N])を押して、ファイル・ウィザードを開きます。</li>
<li>「持続性」カテゴリを選択してから「エンティティ・クラスのセッションBean」を選択します。<br><img alt="ファイル・ウィザード: 「持続性」カテゴリ、「エンティティ・クラスのセッションBean」のファイル・タイプ" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/session-beans-for-entity-classes.png" style="width: 688px" title="「エンティティ・クラスのセッションBean」を選択し、持続性モデルのセッション・ファサードを生成する"></li>
<li>「次」をクリックします。</li>
<li>ステップ2の「エンティティ・クラス」では、左側の「利用可能なエンティティ・クラス」の下に、プロジェクトに含まれているすべてのエンティティ・クラスが一覧表示されています。「すべてを追加」をクリックします。すべてのエンティティ・クラスが、右側の「選択されているエンティティ・クラス」の下に移動します。</li>
<li>「次」をクリックします。</li>
<li>ステップ3の「生成されるセッションBean」で、「パッケージ」フィールドに「<strong>session</strong>」と入力します。<br><img alt="エンティティ・クラスのセッションBean・ウィザード - ステップ3: 生成されるセッションBean" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/generated-session-beans.png" title="新しいセッションBeanの場所およびインタフェース作成の有無の指定"><br>
<p class="notes"><strong>注意:</strong> このウィザードを使用して、セッションBeanのローカルおよびリモート・インタフェースを生成できます。セッションBeanをインタフェースとしてプログラミングするメリットはありますが(たとえば、ビジネス・オブジェクトの相互作用をインタフェースの後ろに隠すと、クライアントをビジネス・ロジックからさらに切り離すことができます。これにより、必要に応じてアプリケーション用にインタフェースの複数の実装をコーディングできるようになります)、これについてはこのチュートリアルでは扱いません。3.1より前のバージョンのEJBでは、セッションBeanごとにインタフェースを実装する<em>必要があります</em>。</p></li>
<li>「終了」をクリックします。IDEによって、プロジェクトに含まれるエンティティ・クラスごとにセッションBeanが生成されます。「プロジェクト」ウィンドウで、新しい<code>session</code>パッケージを展開してセッションBeanを調べます。<br><br>
<table>
<tr class="align-left">
<th style="padding-left:10px">NetBeans 6.8</th>
<th style="padding-left:10px">NetBeans 6.9</th>
</tr>
<tr>
<td>
<img alt="「プロジェクト」ウィンドウ - プロジェクトに表示されたセッションBean" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/projects-window-session-beans.png" title="「プロジェクト」ウィンドウでの新しいセッションBeanの調査">
</td>
<td>
<img alt="「プロジェクト」ウィンドウ - プロジェクトに表示されたセッションBean" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/projects-window-session-beans-69.png" title="「プロジェクト」ウィンドウでの新しいセッションBeanの調査">
</td>
</tr>
</table>
<p class="notes"><strong>注意: </strong>上記のように、NetBeans IDE 6.9では、エンティティ・クラスのセッションBean・ウィザードがファサード・クラスを生成するようにわずかな改善が提供されます。つまり、すべてのクラスに共通するボイラープレート・コードが<code>AbstractFacade</code>という名前の抽象クラスに取り出されます。バージョン6.9を使用している場合は、生成されたいずれかのファサード・クラス(<code>AbstractFacade</code>を除く)を開いてください。そのクラスが<code>AbstractFacade</code>を継承していることがわかります。</p></li>
<li>エディタでセッション・ファサード(たとえば、<code>ProductFacade</code>)を開きます。生成されたすべてのセッション・ファサードは、<a href="http://download.oracle.com/javaee/6/api/javax/persistence/PersistenceContext.html" target="_blank"><code>@PersistenceContext</code></a>注釈を使用して<a href="http://java.sun.com/javaee/6/docs/api/javax/persistence/EntityManager.html" target="_blank"><code>EntityManager</code></a>をインスタンス化します。
<pre class="examplecode">
@PersistenceContext(unitName = "AffableBeanPU")
private EntityManager em;</pre>
<code>@PersistenceContext</code>注釈は、コンテナ管理対象<code>EntityManager</code>をクラスに注入するために使用されます。つまり、必要に応じてGlassFishのEJBコンテナを利用して<code>EntityManager</code>を開いたり閉じたりします。<code>unitName</code>要素には、アプリケーションの<code>persistence.xml</code>ファイルで定義されている<code>AffableBeanPU</code>持続性ユニットを指定します。<br><br><code>EntityManager</code>はJava Persistence APIの重要なコンポーネントであり、データベースで持続性アクションを実行する役割を果たします。『<a href="http://www.manning.com/panda/" target="_blank">EJB 3 In Action</a>』の本では、<code>EntityManager</code>を次のように説明しています。
<blockquote>
<em>JPA<code>EntityManager</code>インタフェースは、実際に持続性サービスを提供することでエンティティを管理します。エンティティは、JPAプロバイダに自身がデータベースにどのようにマップされているかを伝えますが、自身は持続しません。<code>EntityManager</code>インタフェースは、エンティティのORMメタデータを読み取って、持続性操作を実行します。</em>
</blockquote></li>
<!-- TEXT CURRENTLY NOT USED:
In the above example, the <code>EntityManager</code>'s <code>createQuery</code>
method is called to perform a query on the database. If you examine the
<code>createQuery</code> API documentation (press Ctrl-Space on the method
in the editor), you see that the method takes a Java Persistence Query Language
(JPQL) query string as an argument, and returns a <code>Query</code> object.
<br>
<img src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/create-query-api.png"
class="margin-around b-all" alt="API documentation for EntityManager's createQuery method"
style="width:688px" title="Press Ctrl-Space to view API documentation">
<br>
<p class="tips">For more information on the JPQL, including terminology, syntax,
and example queries, see the
<a href="http://download.oracle.com/docs/cd/E17410_01/javaee/6/tutorial/doc/bnbtg.html" target="_blank">Java
EE 6 Tutorial, Chapter 21: The Java Persistence Query Language</a>.</p>
The <code>Query</code> object in turn calls <code>setParameter</code> to
bind the <code>categoryId</code> parameter used in the query string with the
the <code>Category</code> object that is passed into the method. Finally,
<code>getResultList()</code> is called to execute a <code>SELECT</code> query
and return the query results as a <code>List</code> of <code>Product</code>s.
-->
</ol>
<p>アプリケーションに、JPAエンティティ・クラスの形式で<code>affablebean</code>データベースの持続性モデルが含まれるようになりました。また、エンティティ・クラスにアクセスするために使用できるエンタープライズBeanで構成されるセッション・ファサードも含まれています。次の項では、セッションBeanおよびエンティティ・クラスを使用してデータベースにアクセスする方法を示します。</p>
<br>
<h2 id="access">EJBによるデータへのアクセス</h2>
<p><a href="connect-db.html">前のチュートリアル・ユニット</a>で、アプリケーションからデータベースにアクセスする方法を学習しました。この方法では、GlassFishにデータ・ソースを構成し、アプリケーションのデプロイメント・ディスクリプタにリソース参照を追加してから、アプリケーションのJSPページでJSTLの<code>&lt;sql></code>タグを使用することで、データベースにアクセスしました。データベースのデータを含むプロトタイプをすばやく設定できるため、これは重要な手法です。しかし、この手法では維持管理や拡大縮小が難しくなるため、中規模から大規模のアプリケーションや、複数開発者のチームによって管理されるアプリケーションに使用することは現実的ではありません。その上、多層にわたるアプリケーションを開発している場合や、MVCパターンに従っている場合、データにアクセスするコードをフロント・エンドに保持することは望ましくありません。エンタープライズBeanと持続性モデルを使用すると、プレゼンテーション・コンポーネントとモデル・コンポーネントを効果的に切り離して、MVCパターンにより準拠できるようになります。</p>
<p>次の手順では、<code>AffableBean</code>プロジェクトでセッションおよびエンティティBeanの使用を開始するための方法を示します。以前にインデックス・ページおよびカテゴリ・ページのために設定したJSTLデータ・アクセス・ロジックは除去することになります。かわりに、セッションBeanによって提供されるデータ・アクセス・メソッドを利用して、スコープ指定された変数にデータを格納し、フロント・エンドのページ・ビューからデータを取り出せるようにします。まずインデックス・ページに取り組んでから、より複雑なカテゴリ・ページに進みます。</p>
<ul>
<li><a href="#index">インデックス・ページ</a></li>
<li><a href="#category">カテゴリ・ページ</a></li>
</ul>
<div class="indent">
<h3 id="index">インデックス・ページ</h3>
<p>インデックス・ページには、4つの製品カテゴリのデータが必要です。現時点の設定では、インデックス・ページがリクエストされるたびに、JSTLの<code>&lt;sql></code>タグがカテゴリの詳細をデータベースに問い合せます。この情報はほとんど変更されないため、パフォーマンスの観点からすると、アプリケーションがデプロイされた後に問合せを1回のみ実行して、アプリケーション・スコープ指定された属性にデータを格納する方が効果的です。このコードを<code>ControllerServlet</code>の<code>init</code>メソッドに追加することで、これを実現できます。</p>
<ol>
<li>「プロジェクト」ウィンドウで、「ソース・パッケージ」>「<code>controller</code>」>「<code>ControllerServlet</code>」ノードをダブルクリックしてエディタで開きます。</li>
<li><code>CategoryFacade</code>のインスタンスを宣言して、<code>@EJB</code>注釈をインスタンスに適用します。
<pre class="examplecode">
public class ControllerServlet extends HttpServlet {
<strong>@EJB
private CategoryFacade categoryFacade;</strong>
...
}</pre>
<code>@EJB</code>注釈は、<code>CategoryFacade</code>という名前のEJBで<code>categoryFacade</code>変数をインスタンス化するようにEJBコンテナに指示します。</li>
<li>IDEのヒントを使用して、次のインポート文を追加します。
<ul style="margin: 5px 0 0 -1em">
<li><code>javax.ejb.EJB</code></li>
<li><code>session.CategoryFacade</code></li>
</ul>
<p class="tips">[Ctrl]-[Shift]-[I] (Macの場合は[⌘]-[Shift]-[I])を押すと、必要なインポートが自動的にクラスに追加されます。</p></li>
<li>以下の<code>init</code>メソッドをクラスに追加します。Webコンテナは、その<code>init</code>メソッドをコールしてサーブレットを初期化します。これは、サーブレットがロードされてからサービス・リクエストを開始するまでの間に1回のみ発生します。
<pre class="examplecode">
public class ControllerServlet extends HttpServlet {
@EJB
private CategoryFacade categoryFacade;
<strong>public void init() throws ServletException {
// store category list in servlet context
getServletContext().setAttribute(&quot;categories&quot;, categoryFacade.findAll());
}</strong>
...
}</pre>
ここで、<code>Category</code>のすべてのレコードをデータベースに問い合せる、ファサード・クラスの<code>findAll</code>メソッドを適用します。その後、結果として得られた<code>Category</code>オブジェクトの<code>List</code>を、「<code>categories</code>」の文字列で参照できる属性として設定します。<code>ServletContext</code>に参照を置くと、その参照はアプリケーション全体のスコープで存在することになります。<br><br>
<p class="tips"><code>findAll</code>メソッドのメソッド署名をすばやく判定するには、[Ctrl]キー(Macの場合は[⌘])を押しながらカーソルをメソッドの上に移動します。(以下のイメージは、NetBeans IDE 6.8を使用して表示されるポップアップを示しています。)</p>
<img alt="ポップアップにメソッド署名が表示されたエディタ" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/method-signature.png" title="[Ctrl]キーを押しながらカーソルをメソッド上に移動して署名を表示する"><br>ハイパーリンクをクリックすると、メソッドに直接移動できます。</li>
<li>IDEのヒントを使用して、<code>@Overrides</code>注釈を追加します。<code>init</code>メソッドは、<code>HttpServlet</code>のスーパー・クラスである<code>GenericServlet</code>によって定義されます。<br><img alt="エディタに表示されたヒント" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/override.png" title="IDEのヒントを使用した、メソッドへの@Overrides注釈の追加"><br>注釈を追加することは必須ではありませんが、これを行うと次のようないくつかの利点が得られます。
<ul style="margin: 5px 0 0 -1em">
<li>本当にオーバーライドするつもりのメソッドをオーバーライドしているかどうかを確認するためのコンパイラ・チェックを使用できるようになります。</li>
<li>ソース・コードのメソッドがオーバーライドされている状態が明確になるため、読みやすさが向上します。</li>
</ul>
<p class="tips">注釈の詳細は、<a href="http://download.oracle.com/javase/tutorial/java/javaOO/annotations.html" target="_blank">Javaチュートリアル: 注釈</a>を参照してください。</p></li>
<li>これで、カテゴリの一覧を含むアプリケーション・スコープ指定された属性を設定したので、新しく作成した属性にアクセスするようにインデックス・ページを変更します。<br><br>「プロジェクト」ウィンドウで「Webページ」>「<code>index.jsp</code>」ノードをダブルクリックして、このファイルをエディタで開きます。</li>
<li>ファイルの最上部に一覧表示されている<code>&lt;sql:query></code>文をコメントアウト(または削除)します。エディタでコードをコメントアウトするには、コードを強調表示してから[Ctrl]-[/](Macの場合は[⌘]-[/])を押します。<br><img alt="エディタに表示されたコメントアウトしたスニペット" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/commented-out.png" title="エディタでの[Ctrl]-[/]の押下によるコード・スニペットのコメントアウト"></li>
<li><code>&lt;c:forEach></code>の開始タグを変更して、この<code>items</code>属性が、新しいアプリケーション・スコープ指定された<code>categories</code>属性を参照するようにします。
<pre class="examplecode">&lt;c:forEach var=&quot;category&quot; items=&quot;<strong>${categories}</strong>&quot;&gt;</pre></li>
<li>プロジェクトのWebデプロイメント・ディスクリプタを開きます。[Alt]-[Shift]-[O] (Macの場合は[Ctrl]-[Shift]-[O])を押して、「ファイルに移動」ダイアログで「<code>web</code>」と入力してから「OK」をクリックします。<br><img alt="「ファイルに移動」ダイアログ" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/common/go-to-file.png" title="「ファイルに移動」ダイアログを使用した、エディタへのファイルの速やかな表示"></li>
<li><code>&lt;resource-ref></code>エントリをコメントアウト(または削除)します。このエントリは、サーバーに登録されたデータ・ソースを<code>&lt;sql></code>タグで識別するために必要でした。現時点では、JPAに依存してデータベースにアクセスしており、持続性ユニットに<code>jdbc/affablebean</code>データ・ソースがすでに指定されています。(上記の<a href="#pu">プロジェクトの持続性ユニットの「デザイン」ビュー</a>を参照。)<br><br><code>&lt;resource-ref></code>エントリ全体を強調表示してから[Ctrl]-[/](Macの場合は[⌘]-[/])を押します。
<pre class="examplecode">
<strong>&lt;!-- </strong>&lt;resource-ref&gt;
&lt;description&gt;Connects to database for AffableBean application&lt;/description&gt;
&lt;res-ref-name&gt;jdbc/affablebean&lt;/res-ref-name&gt;
&lt;res-type&gt;javax.sql.ConnectionPoolDataSource&lt;/res-type&gt;
&lt;res-auth&gt;Container&lt;/res-auth&gt;
&lt;res-sharing-scope&gt;Shareable&lt;/res-sharing-scope&gt;
&lt;/resource-ref&gt; <strong>--&gt;</strong></pre></li>
<li>プロジェクトを実行します。「プロジェクトの実行」(<img alt="「プロジェクトの実行」ボタン" src="../../../../images_www/articles/73/javaee/ecommerce/common/run-project-btn.png">)ボタンをクリックします。プロジェクトのインデックス・ページがブラウザで開き、4つのすべてのカテゴリ名およびイメージが表示されるのが確認できます。<br><img alt="カテゴリの詳細が表示されたインデックス・ページ" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/index-page.png" style="width:688px" title="インデックス・ページにカテゴリの詳細を取得できることの確認"></li>
</ol>
<h3 id="category">カテゴリ・ページ</h3>
<p><a href="design.html#category">カテゴリ・ページ</a>が正しくレンダリングされるには、次の3つのデータが必要です。</p>
<ol style="margin: 5px 0 0 -1em" class="toc">
<li><strong>カテゴリ・データ:</strong> 左の列のカテゴリ・ボタン用</li>
<li><strong>選択されたカテゴリ:</strong> 選択されたカテゴリは左の列で強調表示され、選択されたカテゴリの名前は製品の表の上に表示される</li>
<li><strong>選択されたカテゴリの製品データ:</strong> 製品の表に表示された製品用</li>
</ol>
<p>3つのデータを1つずつ処理していきましょう。</p>
<ul style="margin: 5px 0 0 -1.5em">
<li><a href="#categoryData">カテゴリ・データ</a></li>
<li><a href="#selectedCategoryData">選択されたカテゴリ</a></li>
<li><a href="#productData">選択されたカテゴリの製品データ</a></li>
</ul>
<h4 id="categoryData">カテゴリ・データ</h4>
<p>インデックス・ページのために作成した、アプリケーション・スコープ指定された<code>categories</code>属性をカテゴリ・データ用に再利用します。</p>
<ol>
<li>エディタで<code>category.jsp</code>を開き、ファイルの最上部に一覧表示されているJSTLの<code>&lt;sql></code>文を([Ctrl]-[/]、Macの場合は[⌘]-[/]で)コメントアウトします。<br><img alt="エディタでコメントアウトされた<sql>文" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/comment-out-sql.png" title="カテゴリ・ページでのJSTLの<sql>文のコメントアウト"></li>
<li><code>&lt;c:forEach></code>の開始タグを変更して、この<code>items</code>属性が、アプリケーション・スコープ指定された<code>categories</code>属性を参照するようにします。(上記で<code>index.jsp</code>に対して実行した手順と同じです。)
<pre class="examplecode">&lt;c:forEach var=&quot;category&quot; items=&quot;<strong>${categories}</strong>&quot;&gt;</pre></li>
<li>プロジェクトを実行して、カテゴリ・ページの現在の状態を調べます。「プロジェクトの実行」(<img alt="「プロジェクトの実行」ボタン" src="../../../../images_www/articles/73/javaee/ecommerce/common/run-project-btn.png">)ボタンをクリックします。プロジェクトのインデックス・ページがブラウザで開いたら、4つのカテゴリのいずれかをクリックします。左の列にカテゴリ・ボタンが表示され、想定したとおりに機能します。<br><img alt="左の列にカテゴリのボタンが表示されたカテゴリ・ページ" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/category-page-left-column.png" style="width:688px" title="左の列にカテゴリのボタンが表示され、想定したとおりに機能する"></li>
</ol>
<h4 id="selectedCategoryData">選択されたカテゴリ</h4>
<p>選択されたカテゴリを取得するために、カテゴリIDとリクエスト問合せ文字列が一致する<code>Category</code>を見つけるためにすでに作成してある<code>categoryFacade</code>を使用できます。</p>
<ol>
<li>エディタで<code>ControllerServlet</code>を開きます。(すでに開いている場合は、[Ctrl]-[Tab]を押してポップアップ・リストから選択します。)</li>
<li>選択されたカテゴリを取得する機能の実装を開始します。<code>TODO: Implement category request</code>というコメントを見つけ、それを削除して以下の(<strong>太字の</strong>)コードを追加します。
<pre class="examplecode">
// if category page is requested
if (userPath.equals(&quot;/category&quot;)) {
<strong>// get categoryId from request
String categoryId = request.getQueryString();
if (categoryId != null) {
}</strong>
// if cart page is requested
} else if (userPath.equals(&quot;/viewCart&quot;)) {</pre>
リクエストで<code>getQueryString()</code>をコールすることで、リクエストされたカテゴリIDを取得します。<br><br>
<p class="notes"><strong>注意:</strong> 左の列のカテゴリ・ボタン内で選択されたカテゴリを判定するためのロジックは、EL式を使用する<code>category.jsp</code>ですでに実装されています。これは、サーブレットで<code>getQueryString()</code>をコールすることに相当します。このEL式は<code>pageContext.request.queryString</code>です。</p></li>
<li><code>if</code>文の中に、次のコード行を追加します。
<pre class="examplecode">
// get categoryId from request
String categoryId = request.getQueryString();
if (categoryId != null) {
<strong>// get selected category
selectedCategory = categoryFacade.find(Short.parseShort(categoryId));</strong>
}</pre>
<code>CategoryFacade</code>の<code>find</code>メソッドを使用して、リクエストされたカテゴリIDに基づく<code>Category</code>オブジェクトを取得します。<code>categoryId</code>を、<code>Category</code>エンティティ・クラスの<code>id</code>フィールドに使用される型である<code>Short</code>にキャストする必要があります。</li>
<li>左マージンにあるバッジ(<img alt="ヒント・バッジ" src="../../../../images_www/articles/73/javaee/ecommerce/common/editor-badge.png">)をクリックしてエディタのヒントを使用し、<code>selectedCategory</code>を<code>doGet</code>メソッド内のローカル変数として宣言します。<br><img alt="エディタのヒント" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/local-variable.png" title="エディタのヒントを使用してローカル変数を宣言する"><br><code>selectedCategory</code>はこのクラスにまだインポートされていない<code>Category</code>型であるため、IDEは<code>entity.Category</code>のインポート文をファイルの先頭に自動的に追加します。</li>
<li>取得した<code>Category</code>オブジェクトをリクエスト・スコープに置くために次の行を追加します。
<pre class="examplecode">
// get categoryId from request
String categoryId = request.getQueryString();
if (categoryId != null) {
// get selected category
selectedCategory = categoryFacade.find(Short.parseShort(categoryId));
<strong>// place selected category in request scope
request.setAttribute(&quot;selectedCategory&quot;, selectedCategory);</strong>
}</pre></li>
<li>エディタで<code>category.jsp</code>に切り替えます。([Ctrl]-[Tab]を押してポップアップ・リストから選択します。)</li>
<li><code>&lt;p id="categoryTitle"></code>を検索して、次のように変更します。
<pre class="examplecode">
&lt;p id=&quot;categoryTitle&quot;&gt;
&lt;span style=&quot;background-color: #f5eabe; padding: 7px;&quot;&gt;<strong>${selectedCategory.name}</strong>&lt;/span&gt;
&lt;/p&gt;</pre>
現時点で、<code>ControllerServlet</code>からリクエスト・スコープに置いたばかりの<code>selectedCategory</code>属性を使用しています。EL式の中で「<code>.name</code>」を使用すると、指定された<code>Category</code>オブジェクトで<code>getName</code>メソッドがコールされます。</li>
<li>ブラウザに戻ってカテゴリ・ページをリフレッシュします。選択されたカテゴリの名前がページに表示されるようになっています。<br><img alt="選択されたカテゴリの名前が表示されたカテゴリ・ページ" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/category-page-selected-category.png" style="width:688px" title="選択されたカテゴリの名前がカテゴリ・ページに表示される">
</li>
</ol>
<h4 id="productData">選択されたカテゴリの製品データ</h4>
<p>選択されたカテゴリのすべての製品を取得するために、<code>Category</code>エンティティの<code>getProductCollection()</code>を使用します。まず、<code>selectedCategory</code>上でこのメソッドをコールして、<code>selectedCategory</code>に関連付けられたすべての<code>Product</code>のコレクションを取得します。次に製品のコレクションをリクエスト・スコープ内の属性として格納し、最後にスコープ指定された属性を<code>category.jsp</code>ページ・ビューから参照します。</p>
<ol>
<li><code>ControllerServlet</code>では、カテゴリ・リクエストを管理する以下の文をコードに追加します。
<pre class="examplecode">
// if category page is requested
if (userPath.equals(&quot;/category&quot;)) {
// get categoryId from request
String categoryId = request.getQueryString();
if (categoryId != null) {
// get selected category
selectedCategory = categoryFacade.find(Short.parseShort(categoryId));
// place selected category in request scope
request.setAttribute(&quot;selectedCategory&quot;, selectedCategory);
<strong>// get all products for selected category
categoryProducts = selectedCategory.getProductCollection();</strong>
}</pre>
ここで<code>getProductCollection()</code>をコールして、<code>selectedCategory</code>に関連付けられたすべての<code>Product</code>のコレクションを取得できます。</li>
<li>エディタのヒントを使用して、<code>categoryProducts</code>を<code>doGet</code>メソッドのローカル変数として定義します。<br><img alt="エディタのヒント" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/local-variable2.png" title="エディタのヒントを使用してローカル変数を宣言する"></li>
<li>リクエスト・スコープに<code>Product</code>のコレクションを置いて、アプリケーションのフロント・エンドから取得できるようにします。
<pre class="examplecode">
// if category page is requested
if (userPath.equals(&quot;/category&quot;)) {
// get categoryId from request
String categoryId = request.getQueryString();
if (categoryId != null) {
// get selected category
selectedCategory = categoryFacade.find(Short.parseShort(categoryId));
// place selected category in request scope
request.setAttribute(&quot;selectedCategory&quot;, selectedCategory);
// get all products for selected category
categoryProducts = selectedCategory.getProductCollection();
<strong>// place category products in request scope
request.setAttribute(&quot;categoryProducts&quot;, categoryProducts);
}</strong></pre></li>
<li>エディタで<code>category.jsp</code>ファイルを開き、製品の表を次のように変更します。
<pre class="examplecode">
&lt;table id=&quot;productTable&quot;&gt;
&lt;c:forEach var=&quot;product&quot; items=&quot;<strong>${categoryProducts}</strong>&quot; varStatus=&quot;iter&quot;&gt;</pre>
<code>&lt;c:forEach></code>タグは<code>categoryProducts</code>のコレクションを参照するようになりました。<code>c:forEach</code>ループはコレクションに含まれる各<code>Product</code>オブジェクトに対して繰り返され、それに応じてデータを抽出するようになりました。</li>
<li>[F6] (Macの場合は[fn]-[F6])を押してプロジェクトを実行します。ブラウザでカテゴリ・ページに移動すると、各カテゴリですべての製品が表示されるようになっています。<br><img alt="表に製品が表示されているカテゴリ・ページ" class="margin-around b-all" src="../../../../images_www/articles/73/javaee/ecommerce/entity-session/category-page-product-table.png" style="width:688px" title="製品の表に指定のカテゴリの製品が表示される">
</li>
</ol>
</div>
<p>このチュートリアル・ユニットでは、JPAおよびEJBテクノロジを簡単に紹介しました。また、Java仕様の役割について、およびそのリファレンス実装をGlassFishアプリケーション・サーバーが使用する方法についても説明しました。その後、プロジェクト・データベースのJava実装を提供する一連のJPAエンティティ・クラスを作成する方法を示しました。さらに、<em>セッション・ファサード</em>・パターンに従って、エンティティ・クラス上に存在し、それらへの便利なアクセスを可能にする一連のEJBセッションBeanを作成する方法を示しました。最後に、<code>AffableBean</code>プロジェクトを変更して、インデックス・ページおよびカテゴリ・ページで必要なデータベースへのアクセスに、新しいセッションBeanおよびエンティティを利用するようにしました。</p>
<p><code>AffableBean</code>プロジェクトの<a href="https://netbeans.org/projects/samples/downloads/download/Samples%252FJavaEE%252Fecommerce%252FAffableBean_snapshot4.zip">スナップショット4</a>をダウンロードでき、これはNetBeans IDE 6.9を使用してこのユニットを完了させた後の状態のプロジェクトに対応しています。</p>
<p>次のユニットでは、セッション管理について学習し、ユーザーがサイトの中でクリックして実行したアクションをアプリケーションに覚えさせる方法について学習します。これは、Eコマース・アプリケーションでショッピング・カート機構を実装するためのキー・ポイントです。</p>
<div class="feedback-box">
<a href="/about/contact_form.html?to=3&amp;subject=Feedback: NetBeans E-commerce Tutorial - Adding Entity Classes and Session Beans">ご意見をお寄せください</a></div>
<br style="clear:both;">
<br>
<h2 id="seeAlso">関連項目</h2>
<div class="indent">
<h3>NetBeansリソース</h3>
<ul>
<li><a href="../../../trails/java-ee.html" target="_blank">Java EEおよびJava Webの学習</a></li>
<li><a href="../javaee-intro.html" target="_blank">Java EEテクノロジ入門</a></li>
<li><a href="../javaee-gettingstarted.html" target="_blank">Java EE 6アプリケーションの開始</a></li>
<li><a href="../secure-ejb.html" target="_blank">Java EEでのセキュリティ保護されたエンタープライズBeansのビルド</a></li>
<li><a href="../javaee-entapp-ejb.html" target="_blank">EJB 3.1を使用したエンタープライズ・アプリケーションの作成</a></li>
<li><a href="../jpa-eclipselink-screencast.html" target="_blank">EclipseLinkでJPAサポートを使用する</a> [スクリーンキャスト]</li>
<li><a href="../../screencasts.html" target="_blank">NetBeans IDE 6.xのビデオ・チュートリアルとデモ</a></li>
<li><a href="http://refcardz.dzone.com/refcardz/netbeans-java-editor-68" target="_blank">NetBeans Javaエディタ6.8リファレンス・カード</a></li>
</ul>
<h3>EJBリソース</h3>
<ul>
<li><strong>製品ページ:</strong> <a href="http://java.sun.com/products/ejb/" target="_blank">エンタープライズJavaBeansテクノロジ</a></li>
<li><strong>仕様のダウンロード:</strong><a href="http://jcp.org/aboutJava/communityprocess/final/jsr318/index.html" target="_blank"> JSR 318: EJB 3.1最終リリース</a></li>
<li><strong>リファレンス実装:</strong> <a href="http://glassfish.dev.java.net/downloads/ri" target="_blank">http://glassfish.dev.java.net/downloads/ri</a></li>
<li><strong>公式フォーラム:</strong> <a href="http://forums.sun.com/forum.jspa?forumID=13" target="_blank">エンタープライズ・テクノロジ - エンタープライズJavaBeans</a></li>
<li><strong>Java EE 6チュートリアル:</strong> <a href="http://download.oracle.com/docs/cd/E17410_01/javaee/6/tutorial/doc/bnblr.html" target="_blank">パートIV - エンタープライズBean</a></li>
</ul>
<h3>JPAリソース</h3>
<ul>
<li><strong>製品ページ:</strong> <a href="http://java.sun.com/javaee/technologies/persistence.jsp" target="_blank">Java Persistence API</a></li>
<li><strong>仕様のダウンロード:</strong> <a href="http://jcp.org/aboutJava/communityprocess/final/jsr317/index.html" target="_blank">JSR 317: Java Persistence 2.0最終リリース</a></li>
<li><strong>リファレンス実装:</strong> <a href="http://www.eclipse.org/eclipselink/downloads/ri.php" target="_blank">http://www.eclipse.org/eclipselink/downloads/ri.php</a></li>
<li><strong>Java EE 6チュートリアル:</strong> <a href="http://download.oracle.com/docs/cd/E17410_01/javaee/6/tutorial/doc/bnbpy.html" target="_blank">パートVI - 持続性</a></li>
</ul>
<h3>GlassFishリソース</h3>
<ul>
<li><a href="https://glassfish.dev.java.net/docs/index.html" target="_blank">GlassFish v3ドキュメント</a></li>
<li><a href="http://www.sun.com/offers/details/GlassFish_Tomcat.html" target="_blank">Tomcatユーザー向けGlassFishの学習</a></li>
<li><a href="https://glassfish.dev.java.net/javaee5/persistence/persistence-example.html" target="_blank">GlassFishプロジェクト - Java Persistenceの例</a></li>
<li><a href="http://docs.sun.com/app/docs/doc/820-7759" target="_blank">Your First Cup: Java EE Platformの紹介</a></li>
<li><a href="https://glassfish.dev.java.net/downloads/ri/" target="_blank">リファレンス実装のダウンロード</a></li>
</ul>
<h3>技術記事</h3>
<ul>
<li><a href="http://www.theserverside.com/news/1363656/New-Features-in-EJB-31" target="_blank">EJB 3.1の新機能</a></li>
<li><a href="http://www.ibm.com/developerworks/java/library/j-ejb1008.html" target="_blank">EJBのベスト・プラクティス: エンティティBeanの保護</a></li>
<li><a href="http://java.sun.com/blueprints/corej2eepatterns/Patterns/SessionFacade.html" target="_blank">コアJ2EEパターン - セッション・ファサード</a></li>
<li><a href="http://www.ibm.com/developerworks/websphere/library/techarticles/0106_brown/sessionfacades.html" target="_blank">セッション・ファサードのルールおよびパターン</a></li>
<li><a href="http://www.oracle.com/technology/sample_code/tech/java/j2ee/designpattern/businesstier/sessionfacade/readme.html" target="_blank">デザイン・パターン・サンプル・アプリケーション - セッション・ファサード</a></li>
<li><a href="http://www.ibm.com/developerworks/websphere/library/bestpractices/using_httpservlet_method.html" target="_blank">ベスト・プラクティス: HttpServlet <code>init</code>メソッドの使用</a></li>
</ul>
<h3>書籍</h3>
<ul>
<li><a href="http://www.amazon.com/Beginning-Java-EE-GlassFish-Second/dp/143022889X/ref=dp_ob_title_bk" target="_blank">Beginning Java EE 6 with GlassFish 3</a></li>
<li><a href="http://www.amazon.com/Java-EE-GlassFish-Application-Server/dp/1849510369/ref=sr_1_1?s=books&ie=UTF8&qid=1281888153&sr=1-1" target="_blank">Java EE 6 with GlassFish 3 Application Server</a></li>
<li><a href="http://www.apress.com/book/view/1590598954" target="_blank">Pro NetBeans IDE 6 Rich Client Platform Edition</a></li>
<li><a href="http://www.amazon.com/Real-World-Patterns-Rethinking-Practices/dp/0557078326/ref=pd_sim_b_4" target="_blank">Real World Java EE Patterns Rethinking Best Practices</a></li>
<li><a href="http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420/ref=sr_1_1?s=books&ie=UTF8&qid=1281985949&sr=1-1" target="_blank">Patterns of Enterprise Application Architecture</a></li>
<li><a href="http://www.amazon.com/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215/ref=sr_1_1?s=books&ie=UTF8&qid=1281985959&sr=1-1" target="_blank">Domain-Driven Design: Tackling Complexity in the Heart of Software</a></li>
</ul>
</div>
<br>
<h2>参考資料</h2>
<ol>
<li id="footnote1"><a href="#1" style="text-decoration:none">^</a>出典: 『<a href="http://www.manning.com/panda/" target="_blank">EJB 3 In Action</a>』の第1章、1.1.2項: EJB as a framework</li>
<li id="footnote2"><a href="#2" style="text-decoration:none">^</a>他にもEJBによって提供される多くのサービスがあります。より総合的な一覧については、『<a href="http://www.manning.com/panda/" target="_blank">EJB 3 In Action</a>』の第1章、1.3.3項: Gaining functionality with EJB servicesを参照してください。</li>
</ol>
</body>
</html>