| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml"> |
| <head> |
| <title>Maven を使用した NetBeans プラットフォーム CRUD アプリケーションの作成</title> |
| <link rel="stylesheet" type="text/css" href="https://netbeans.org/netbeans.css"/> |
| <meta name="AUDIENCE" content="NBUSER"/> |
| <meta name="TYPE" content="ARTICLE"/> |
| <meta name="EXPIRES" content="N"/> |
| <meta name="indexed" content="y"/> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <meta name="description" |
| content="This tutorial demonstrates how to use the the Maven build framework to create a simple |
| NetBeans Platform application that can read and write to a database."/> |
| <!-- Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. --> |
| <!-- Use is subject to license terms.--> |
| </head> |
| <body> |
| |
| <h1>Maven を使用した NetBeans プラットフォーム CRUD アプリケーションの作成</h1> |
| |
| <p><a href="https://platform.netbeans.org/"><b>NetBeans プラットフォーム</b></a>へようこそ!</p> |
| |
| <p>このドキュメントでは、データベースに対して読み書きを行う簡単な NetBeans プラットフォームアプリケーションを、Maven 構築フレームワークを使用して作成する方法を示します。このドキュメントでは、Maven 原型を使用して、NetBeans プラットフォームのアプリケーションおよびモジュールを作成します。また、Swing UI ツールキットおよび「Matisse」GUI ビルダーを使用して、ウィンドウコンポーネントを作成します。 |
| </p> |
| |
| <p>このドキュメントは、Ant ベースの「<a href="nbm-crud_ja.html">NetBeans プラットフォーム: NetBeans CRUD アプリケーションのチュートリアル</a>」に基づいており、NetBeans プラットフォームのアプリケーション開発において、Ant を使用する場合と Maven を使用する場合の違いについていくつか説明します。Maven と Ant との相違点を理解すれば、「<a href="https://netbeans.org/kb/trails/platform_ja.html">NetBeans プラットフォームの学習</a>」のチュートリアルを容易に理解できるようになります。 |
| </p> |
| |
| <p class="tips">CRUD サンプルアプリケーションは、「新規プロジェクト」ウィザードで利用できる Maven サンプルの 1 つです。</p> |
| |
| <p class="tips">NetBeans プラットフォームをはじめて使用する場合は、スクリーンキャストシリーズの「<a href="https://platform.netbeans.org/tutorials/nbm-10-top-apis.html">NetBeans API のトップ 10</a>」を視聴いただくことをお勧めします。</p> |
| |
| <p><b>目次</b></p> |
| <p><img src="../../images/articles/69/netbeans-stamp69.png" class="stamp" width="114" height="114" alt="このページの内容は NetBeans IDE 6.5、6.7、および 6.8 が対象です" title="このページの内容は NetBeans IDE 6.5、6.7、および 6.8 が対象です" /></p> |
| <ul class="toc"> |
| <li><a href="#config">Maven の構成</a></li> |
| <li><a href="#01">NetBeans プラットフォームアプリケーションプロジェクトの作成</a> |
| <ul> |
| <li><a href="#01b"> モジュールの作成</a></li> |
| <li><a href="#01c">モジュールの依存リソース設定</a></li> |
| <li><a href="#01d">アプリケーションのブランド設定</a></li> |
| </ul> |
| </li> |
| <li><a href="#02">エンティティークラスの作成</a> |
| <ul> |
| <li><a href="#02a">実行時依存リソースとしての DerbyClient の追加</a></li> |
| <li><a href="#02b">データベースからのエンティティークラスの生成</a></li> |
| </ul> |
| </li> |
| <li><a href="#03">READ: レコードの読み取りと表示</a> |
| <ul> |
| <li><a href="#03b">ウィンドウへのツリービューの追加</a></li> |
| <li><a href="#03c">ファクトリクラスの作成</a></li> |
| <li><a href="#03d">依存リソースの変更</a></li> |
| </ul> |
| </li> |
| <li><a href="#04">UPDATE: レコードの編集</a> |
| <ul> |
| <li><a href="#04b">LookupListener の使用</a></li> |
| <li><a href="#04c">元に戻すおよび再実行機能の追加</a></li> |
| <li><a href="#04d">保存機能の追加</a></li> |
| <li><a href="#04e">変更内容の持続</a></li> |
| <li><a href="#04f">更新機能の追加</a></li> |
| </ul> |
| </li> |
| <li><a href="#05">CREATE: 新規レコードの作成</a> |
| <ul> |
| <li><a href="#05b">新規オブジェクトの作成および保存</a></li> |
| </ul> |
| </li> |
| <li><a href="#06">アプリケーションの実行</a></li> |
| </ul> |
| |
| <p><b>このチュートリアルを行うには、次の表に示すソフトウェアおよびリソースが必要です。</b></p> |
| |
| <table> |
| <tbody> |
| <tr> |
| <th class="tblheader" scope="col">ソフトウェアまたはリソース</th> |
| <th class="tblheader" scope="col">必須バージョン</th> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://download.netbeans.org/netbeans/6.9/beta/">NetBeans IDE</a></td> |
| <td class="tbltd1">version 6.9 (Java)</td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://java.sun.com/javase/downloads/index.jsp">Java Developer Kit (JDK)</a></td> |
| <td class="tbltd1">version 6 or above</td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://maven.apache.org/">Maven</a></td> |
| <td class="tbltd1">version 2.0.9 以降</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">JavaDB またはほかのデータベースサーバーおよびデータベース</td> |
| <td class="tbltd1"> </td> |
| </tr> |
| </tbody> |
| </table> |
| |
| <p><strong class="notes">注:</strong></p> |
| <ul> |
| <li>JavaDB データベースサーバーおよびサンプルデータベースは、バンドルされている GlassFish Server Open Source Edition 3.0.1 に含まれています。</li> |
| <li>NetBeans プラットフォーム用のアプリケーション開発のために、別々のバージョンの NetBeans プラットフォームをダウンロードする必要はありません。通常、NetBeans IDE でアプリケーションおよびモジュールを開発し、NetBeans プラットフォームおよびアプリケーションを実行するのに必要なモジュールのみを追加します。</li> |
| </ul> |
| <p>このチュートリアルを開始する前に、必要に応じて次のドキュメントをお読みください。</p> |
| <ul> |
| <li><a href="http://wiki.netbeans.org/MavenBestPractices">NetBeans 6.x での Apache Maven のベストプラクティス</a></li> |
| <li><a href="http://www.sonatype.com/books/maven-book/reference/introduction.html">Chapter 1. Introducing Apache Maven</a> (『<a href="http://www.sonatype.com/books/maven-book/reference/public-book.html">Maven: The Definitive Guide</a>』)</li> |
| <li><a href="https://netbeans.org/kb/docs/java/gui-functionality_ja.html">GUI 構築入門</a></li> |
| </ul> |
| |
| |
| <!-- =================================================================== --> |
| <!-- +++++++++++++++ Configuring Maven +++++++++++++++++++++++++++++++++ --> |
| |
| <h2><a name="config"></a>Maven の構成</h2> |
| <p>これがはじめての Maven プロジェクトである場合は、「オプション」ウィンドウで Maven の構成設定を確認します。このチュートリアルを完了するには、ローカルシステムに Maven がインストールされている必要があります。インストーラは <a href="http://maven.apache.org/">Maven のサイト</a>からダウンロードできます。</p> |
| |
| <ol> |
| <li>「オプション」ウィンドウの「その他」カテゴリを選択して、「Maven」タブをクリックします。</li> |
| <li>Maven をインストールするローカルの場所を指定します (2.0.9 以降が必要)。</li> |
| <li>Maven のローカルリポジトリの場所が正しいことを確認します。</li> |
| <li>「了解」をクリックします。</li> |
| </ol> |
| <p>ほとんどの場合、Maven の設定が標準的であれば、「オプション」ウィンドウの情報はすでに正しいものになっています。</p> |
| |
| <p>IDE は、Maven SCM を使用して Maven アーティファクトのチェックアウトを行います。ソースのチェックアウトを行うために必要なすべてのクライアントが、ローカルマシンにインストールされていて正しく設定されているか確認することをお勧めします。</p> |
| <p class="tips">Maven SCM の詳細については、「<a href="http://maven.apache.org/scm/index.html">Maven SCM のページ</a>」を参照してください。</p> |
| |
| <div class="indent"> |
| <h3><a name="config1"></a>Maven リポジトリの表示</h3> |
| <p>Maven ですべてのプロジェクトを構築するために使用されるアーティファクトは、Maven のローカルリポジトリに格納されます。アーティファクトがプロジェクトの依存リソースとして宣言されると、そのアーティファクトは登録されたリモートリポジトリの 1 つからローカルリポジトリにダウンロードされます。</p> |
| |
| <p>デフォルトで、NetBeans リポジトリおよびよく知られているインデックス付きの Maven リポジトリがいくつか登録され、リポジトリブラウザウィンドウに一覧表示されます。NetBeans リポジトリには、プロジェクトの構築に必要な、ほとんどの公開アーティファクトが含まれています。Maven リポジトリブラウザを使用すると、ローカルリポジトリとリモートリポジトリの内容を確認することができます。「ローカルリポジトリ」ノードを展開すると、ローカルにあるアーティファクトを表示できます。NetBeans リポジトリノードの下に一覧表示されているアーティファクトは、プロジェクトの依存リソースとして追加できますが、すべてのアーティファクトがローカルにあるわけではありません。これらはプロジェクトの依存リソースとして宣言されたときにだけ、ローカルリポジトリに追加されます。</p> |
| |
| <p>Maven リポジトリブラウザを開くには、次の手順に従います。</p> |
| <ul> |
| <li>メインメニューから「ウィンドウ」>「その他」>「Maven リポジトリブラウザ」を選択します。<br/> |
| <img src="../../images/tutorials/maven-quickstart68/maven-nbm-netbeans-repo.png" alt="Maven リポジトリブラウザのスクリーンショット" title="Maven リポジトリブラウザのスクリーンショット" class="margin-around b-all" /> |
| </li> |
| </ul> |
| |
| |
| <p>カーソルをアーティファクトの上に置くと、アーティファクトのコーディネートとともにツールチップが表示されます。ブラウザで、アーティファクトの JAR ファイルをダブルクリックすると、アーティファクトについての追加の詳細情報を確認できます。</p> |
| |
| <p class="tips">Maven リポジトリブラウザのツールバーにある「検索」ボタンをクリックするか、メインツールバーにあるクイック検索のテキストフィールドを使用すると、アーティファクトを検索できます。</p> |
| <p class="tips">IDE での Maven のクラスパス依存リソースの管理と、Maven リポジトリの操作の詳細については、「<a href="http://wiki.netbeans.org/MavenBestPractices">NetBeans 6.x での Apache Maven のベストプラクティス</a>」の「<a href="http://wiki.netbeans.org/MavenBestPractices#Dependency_management">依存リソースの管理</a>」の節を参照してください。 |
| </p> |
| <p class="tips">Artifact Viewer の使用方法のデモンストレーションを確認するには、「<a href="https://netbeans.org/kb/docs/java/maven-dependencies-screencast.html">Maven 依存リソースの操作</a>」のスクリーンキャストを参照してください。</p> |
| |
| </div> |
| |
| <!-- =================================================================== --> |
| <!-- +++++++++++++++ Creating the Platform Application +++++++++++++++++ --> |
| |
| <h2><a name="01"></a>NetBeans プラットフォームアプリケーションプロジェクトの作成</h2> |
| |
| <p>この節では、「新規プロジェクト」ウィザードを使用して、Maven 原型から NetBeans プラットフォームアプリケーションを作成します。このウィザードにより、NetBeans プラットフォームアプリケーションを開発するために必要な Maven モジュールプロジェクトが作成されます。また、「新規プロジェクト」ウィザードを使用して、NetBeans モジュールも作成します。 |
| </p> |
| |
| <div class="indent"> |
| <h3><a name="01a"></a>プロジェクトの作成</h3> |
| |
| <p>「新規プロジェクト」ウィザードを使用して NetBeans プラットフォームアプリケーションを作成するには、次の手順を実行します。 |
| </p> |
| <ol> |
| <li>「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択し、「新規プロジェクト」ウィザードを開きます。</li> |
| <li>「Maven」カテゴリから「Maven NetBeans アプリケーション」を選択します。「次へ」をクリックします。</li> |
| <li>「プロジェクト名」に「<strong>MavenPlatformCRUDApp</strong>」と入力し、「プロジェクトの場所」を設定します。「完了」をクリックします。</li> |
| </ol> |
| |
| <p class="notes"><strong>注:</strong> このウィザードでは、プラットフォームアプリケーションを作成するときに「次へ」をクリックするとモジュールプロジェクトを作成できますが、このチュートリアルはデモンストレーションであるため、アプリケーションとモジュールを別々に作成します。</p> |
| |
| <img src="../../images/tutorials/maven-crud/mavencrud-new-project.png" alt="「新規プロジェクト」ウィザードのスクリーンショット" title="「新規プロジェクト」ウィザードのスクリーンショット" class="margin-around b-all" /> |
| |
| <p>「完了」をクリックすると、デフォルトで IDE が次のような Maven プロジェクトタイプを作成します。</p> |
| <ul> |
| <li><strong>NetBeans Platform Application。</strong>このプロジェクトはプラットフォームアプリケーションのコンテナプロジェクトです。このプロジェクトに、包含する各モジュールおよびプロジェクトのリポジトリの場所が一覧表示されます。このプロジェクトにソースは含まれません。IDE は、このプロジェクトのサブディレクトリに、ソースおよびリソースを含むモジュールを生成します。</li> |
| <li><strong>NetBeans Platform based application。</strong>このプロジェクトは、アプリケーションをコンパイルするために必要なアーティファクト (ソース) を指定します。必要な依存リソース (IDE アーティファクト、モジュールアーティファクト) は、このプロジェクトの <tt>pom.xml</tt> ファイルに指定されます。</li> |
| <li><strong>Platform application branding resources。</strong>このプロジェクトには、アプリケーションのブランド設定に使用されるリソースが含まれています。 </li> |
| </ul> |
| <img src="../../images/tutorials/maven-crud/mavencrud-projects-window1.png" alt="「プロジェクト」ウィンドウのプロジェクト構造のスクリーンショット" title="「プロジェクト」ウィンドウのプロジェクト構造" class="margin-around b-all" /> |
| |
| <p class="notes"><strong>注:</strong></p> |
| <ul> |
| <li>これが Maven を使用した最初の NetBeans プラットフォームアプリケーションである場合、IDE が必要なすべてのアーティファクトを NetBeans リポジトリからダウンロードする必要があるため、プロジェクト作成まで少し時間がかかることがあります。</li> |
| <li>プロジェクトを作成するとき、いくつかのプロジェクト (NetBeans Platform based application プロジェクトなど) にバッジが付いていますが、これは <tt>pom.xml</tt> ファイル (POM) で宣言されている依存リソースに使用できないものがあるためです。</li> |
| </ul> |
| |
| |
| |
| <h3><a name="01b"></a> モジュールの作成</h3> |
| <p>この課題では、「新規プロジェクト」ウィザードを使用して、NetBeans モジュールを作成します。 |
| </p> |
| |
| <ol> |
| <li>「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択し、「新規プロジェクト」ウィザードを開きます。</li> |
| <li>「Maven」カテゴリから「Maven NetBeans モジュール」を選択します。「次へ」をクリックします。</li> |
| <li>「プロジェクト名」に「<strong>MavenPlatformCRUDApp-dbaccess</strong>」と入力します。</li> |
| <li>「プロジェクトの場所」で「参照」をクリックして、<strong>MavenPlatformCRUDApp</strong> ディレクトリを指定します。「開く」をクリックします。<br/> |
| <img src="../../images/tutorials/maven-crud/mavencrud-select-location.png" alt="場所を示す「プロジェクトの場所を選択」ダイアログのスクリーンショット" title="プロジェクトディレクトリを示す「プロジェクトの場所を選択」ダイアログ" class="margin-around b-all" /> |
| </li> |
| <li>「完了」をクリックします。 </li> |
| </ol> |
| |
| <p>「完了」をクリックすると、ウィザードによって <strong>MavenPlatformCRUDApp-dbaccess</strong> という名前の NetBeans モジュールプロジェクトが作成されます。モジュールはサブディレクトリに保存されると、アプリケーションに含まれるように自動的に設定されます。このプロジェクトの POM を開くと、MavenPlatformCRUDApp が親プロジェクトとして宣言されているのが確認できます。 |
| </p> |
| <pre class="examplecode"><parent> |
| <artifactId>MavenPlatformCRUDApp</artifactId> |
| <groupId>com.mycompany</groupId> |
| <version>1.0-SNAPSHOT</version> |
| </parent> |
| <artifactId>MavenPlatformCRUDApp-dbaccess</artifactId> |
| <packaging>nbm</packaging> |
| <version>1.0-SNAPSHOT</version> |
| <name>MavenPlatformCRUDApp - dbaccess NetBeans Module</name> |
| </pre> |
| |
| <p class="tips">POM の <tt><name></tt> 要素を編集するか、プロジェクトの「プロパティー」ウィンドウで名前を変更すれば、モジュールの表示名を変更できます。デフォルトの表示名は、プロジェクトのアーティファクト ID <tt>MavenPlatformCRUDApp-dbaccess</tt> です。</p> |
| |
| <p>「プロジェクト」ウィンドウで「プロジェクトファイル」ノードの下にある NetBeans プラットフォームアプリケーションの POM を見ると、3 つのモジュールがアプリケーションのモジュールとして一覧表示されているのが確認できます。</p> |
| <pre class="examplecode"> |
| <modules> |
| <module>branding</module> |
| <module>application</module> |
| <module>MavenPlatformCRUDApp-dbaccess</module> |
| </modules> |
| </pre> |
| |
| |
| <h3><a name="01c"></a>モジュールの依存リソース設定</h3> |
| <p>ここで、モジュールを「NetBeans Platform based application」の依存リソースとして追加する必要があります。依存リソースの追加は、エディタで <tt>pom.xml</tt> を編集するか、「依存リソースを追加」ダイアログボックスを使用して行います。</p> |
| <ol> |
| <li>「プロジェクト」ウィンドウで「<strong>NetBeans Platform based application</strong>」ノードを展開します。</li> |
| <li>「ライブラリ」ノードを右クリックし、「依存リソースを追加」を選択します。</li> |
| <li>「開いているプロジェクト」タブをクリックして、「<strong>MavenPlatformCRUDApp - dbaccess</strong>」を選択します。「了解」をクリックします。<br/> |
| <img src="../../images/tutorials/maven-crud/mavencrud-add-dependency1.png" alt="「依存リソースを追加」ダイアログのスクリーンショット" title="「依存リソースを追加」ダイアログの「開いているプロジェクト」タブ" class="margin-around b-all" /> |
| </li> |
| </ol> |
| |
| |
| <p>「プロジェクト」ウィンドウで「NetBeans Platform based application」の「ライブラリ」ノードを展開すると、MavenPlatformCRUDApp-dbaccess が依存リソースとして表示されるようになっているのが確認できます。</p> |
| |
| <p>「NetBeans Platform based application」の POM を見ると、モジュールのアーティファクト <tt>MavenPlatformCRUDApp-dbaccess</tt> が、アプリケーションのコンパイルのための必須依存リソースとして表示されているのが確認できます。このアーティファクトは、モジュールプロジェクトを構築して、アーティファクトをローカルリポジトリにインストールしたあとで使用できます。</p> |
| |
| <pre class="examplecode"><dependency> |
| <groupId>${project.groupId}</groupId> |
| <artifactId><strong>MavenPlatformCRUDApp-dbaccess</strong></artifactId> |
| <version>${project.version}</version> |
| </dependency></pre> |
| |
| |
| |
| <h3><a name="01d"></a>アプリケーションのブランド設定</h3> |
| <p>ブランド設定モジュールは、プラットフォームアプリケーションの構築時に使用されるブランド設定リソースを指定します。ブランド設定ダイアログでは、アプリケーション名、スプラッシュ画面、およびアプリケーションアイコンの指定や、テキスト要素の値の変更が簡単に行えます。</p> |
| |
| <p>この課題では、デフォルトのスプラッシュ画像を置き換えます。デフォルトでは、IDE によって生成されるブランド設定モジュールには、プラットフォームアプリケーションの起動時に表示される画像が含まれています。次の手順を実行して、この画像を別の画像に置き換えられます。</p> |
| <ol> |
| <li>「プロジェクト」ウィンドウで「<strong>Platform application branding resources</strong>」モジュールを右クリックして、「ブランド設定」を選択します。</li> |
| <li>「スプラッシュ画面」タブで、デフォルトのスプラッシュ画面の画像の隣にある「参照」ボタンをクリックして、使用する画像の場所に移動し、スプラッシュ画面として使用する画像を指定します。「了解」をクリックします。</li> |
| </ol> |
| |
| <p>たとえば、次の画像をローカルシステムにコピーして、ブランド設定ダイアログでこの画像を指定することもできます。</p> |
| <img src="../../images/tutorials/maven-crud/splash-crud.gif" alt="デフォルトのスプラッシュ画像の例" title="デフォルトのスプラッシュ画像の例" class="margin-around b-all" /> |
| |
| <p>アプリケーションを起動すると、起動中に新しい画像が表示されます。</p> |
| </div> |
| |
| |
| <!-- =================================================================== --> |
| <!-- +++++++++++++++++++++++ Creating the Entity Classes +++++++++++++++++++ --> |
| |
| |
| <h2><a name="02"></a>エンティティークラスの作成</h2> |
| |
| <p>この節では、Java DB データベースの表からエンティティークラスをいくつか生成します。アプリケーションにエンティティークラスを作成して JPA (Java Persistence API) を使用するには、データベースサーバーおよび JPA 持続性プロバイダライブラリにアクセスできる必要があります。このチュートリアルでは JavaDB データベースサーバーを使用しますが、アプリケーションがほかのデータベースサーバーを使用するように設定することもできます。</p> |
| |
| <p>リソースを使用できるようにするもっとも簡単な方法は、IDE にバンドルされている GlassFish Server Open Source Edition 3.0.1 のインスタンスを登録することです。Java DB データベースサーバー、サンプルデータベース、および JPA 持続性プロバイダは、GlassFish サーバーに含まれています。エンティティークラスを作成する前に、次の手順を実行して Java DB を起動してください。</p> |
| |
| <ol> |
| <li>「サービス」ウィンドウで「サーバー」ノードを展開して、GlassFish インスタンスが登録されていることを確認してください。</li> |
| <li>「データベース」ノードを展開して、Java DB の <strong>app</strong> データベースのデータベース接続ノード (<tt>jdbc:derby://localhost:1527/sample [APP の app]</tt>) を右クリックし、「接続」を選択します。 </li> |
| </ol> |
| |
| <p>「接続」を選択すると、データベースが起動していない場合は IDE によって起動されます。</p> |
| <div class="indent"> |
| <h3><a name="02a"></a>実行時依存リソースとしての DerbyClient の追加</h3> |
| |
| <p>この課題では、依存リソースとして derbyclient-10.5.3.0_1 ライブラリを追加します。</p> |
| |
| <ol> |
| <li><strong>dbaccess</strong> モジュールの「ライブラリ」ノードを右クリックし、「依存リソースを追加」を選択します。</li> |
| <li>「グループ ID」に「<strong>org.apache.derby</strong>」、「アーティファクト ID」に「<strong>derbyclient</strong>」、そして「バージョン」に「<strong>10.5.3.0_1</strong>」と入力してライブラリを追加します。</li> |
| <li>「スコープ」ドロップダウンリストから「<strong>runtime</strong>」を選択します。「了解」をクリックします。<br/> |
| <img src="../../images/tutorials/maven-crud/mavencrud-add-dependency-derby.png" alt="「依存リソースを追加」ダイアログの例" title="「依存リソースを追加」ダイアログで derbyclient JAR を追加する" class="margin-around b-all" /> |
| </li> |
| </ol> |
| |
| <p>「プロジェクト」ウィンドウで「実行時ライブラリ」ノードを展開すると、<tt>derbyclient</tt> ライブラリが依存リソースとして表示されているのが確認できます。</p> |
| <p class="tips">エディタで POM を変更して、依存リソースの <tt><scope></tt> 要素の値を指定することもできます。</p> |
| |
| <pre class="examplecode"><dependency> |
| <groupId>org.apache.derby</groupId> |
| <artifactId>derbyclient</artifactId> |
| <version>10.5.3.0_1</version> |
| <scope>runtime</scope> |
| </dependency></pre> |
| |
| <h3><a name="02b"></a>データベースからのエンティティークラスの生成</h3> |
| <p>この節では、ウィザードを使用して <strong>dbaccess</strong> モジュールにエンティティークラスを生成します。 |
| </p> |
| |
| <ol> |
| <li><strong>dbaccess</strong> モジュールの「ソースパッケージ」を右クリックして、「新規」>「その他」を選択します。</li> |
| <li>「持続性」カテゴリから「データベースからのエンティティークラス」を選択します。「次へ」をクリックします。</li> |
| <li>「データベース接続」ドロップダウンリストから Java DB サンプルデータベースを選択します。</li> |
| <li>「使用可能な表」から「CUSTOMER」表を選択し、「追加」をクリックします。「追加」をクリックすると、関連する表である「DISCOUNT_CODE」も「選択した表」の一覧に追加されます。「次へ」をクリックします。</li> |
| <li>「パッケージ」の名前に「<strong>com.mycompany.mavenplatformcrudapp.dbaccess</strong>」と入力します。「持続フィールド用の NamedQuery 注釈を生成」および「持続性ユニットを作成」が選択されていることを確認してください。「完了」をクリックします。</li> |
| </ol> |
| <p>「完了」をクリックすると、IDE によって Customer および DiscountCode エンティティークラスが生成されます。また、IDE によって、<tt>src/main/resources</tt> ディレクトリの「その他のソース」ノードの下にある <tt>META-INF</tt> パッケージに <tt>persistence.xml</tt> ファイルも生成されます。</p> |
| |
| |
| |
| |
| |
| |
| |
| |
| </div> |
| |
| <!-- =================================================================== --> |
| <!-- +++++++++++++++++++ Implementing CRUD : READ ++++++++++++++++++++++ --> |
| |
| |
| <h2><a name="03"></a>READ: レコードの読み取りと表示</h2> |
| <p>この節では、ウィザードを使用して、<strong>dbaccess</strong> モジュールにウィンドウコンポーネントを追加します。ウィンドウコンポーネントでツリー表示を可能にして、オブジェクトをノードとして表示できるようにします。ノードのプロパティーウィンドウで、各レコードのデータを確認できます。</p> |
| |
| <div class="indent"> |
| |
| <h3><a name="03a"></a>ウィンドウコンポーネントの追加</h3> |
| <p>この課題では、ウィンドウコンポーネントを作成します。</p> |
| <ol> |
| <li>「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「新規」>「ウィンドウ」を選択します。</li> |
| <li>「ウィンドウの位置」ドロップダウンリストから「<strong>editor</strong>」を選択し、「<strong>アプリケーションの起動時に開く</strong>」を選択します。「次へ」をクリックします。<br/> |
| <img src="../../images/tutorials/maven-crud/mavencrud-new-window-customer.png" alt="「新規ウィンドウ」ウィザードのスクリーンショット" title="「新規ウィンドウ」ウィザードの「基本設定」ページ" class="margin-around b-all" /> |
| </li> |
| <li>「クラス名の接頭辞」に「<strong>Customer</strong>」と入力します。</li> |
| <li>「パッケージ」に「<strong>com.mycompany.mavenplatformcrudapp.viewer</strong>」と入力します。「完了」をクリックします。 |
| <p>ウィザードにより、作成されるファイルと変更されるファイルの一覧が表示されます。</p></li> |
| </ol> |
| <p>「完了」をクリックすると、IDE によって「ソースパッケージ」の下の「<tt>com.mycompany.mavenplatformcrudapp.viewer</tt>」に <tt>CustomerTopComponent.java</tt> クラスが生成されているのが「プロジェクト」ウィンドウで確認できます。プロジェクトの構造は、「ファイル」ウィンドウで確認できます。Maven プロジェクトをコンパイルするには、「ソースパッケージ」(「ファイル」ウィンドウの <tt>src/main/java</tt> ディレクトリ) の下にソースファイルだけを配置する必要があります。リソースファイル (XML ファイルなど) は、「その他のソース」(「ファイル」ウィンドウの <tt>src/main/resources</tt> ディレクトリ) の下に配置しなければいけません。</p> |
| |
| |
| <h3><a name="03b"></a>ツリー表示の追加</h3> |
| |
| <p>ここで、ウィンドウコンポーネントを変更して、データベースレコードをツリー表示できるようにします。コンストラクタにエンティティーマネージャーを追加して、Bean のツリー表示を可能にします。</p> |
| <ol> |
| <li><tt>CustomerTopComponent.java</tt> の「ソース」タブをクリックして、エディタでソースコードを表示します。</li> |
| <li>コンストラクタに次のコードを追加します。 |
| <pre class="examplecode">public CustomerTopComponent() { |
| initComponents(); |
| setName(NbBundle.getMessage(CustomerTopComponent.class, "CTL_CustomerTopComponent")); |
| setToolTipText(NbBundle.getMessage(CustomerTopComponent.class, "HINT_CustomerTopComponent")); |
| // setIcon(ImageUtilities.loadImage(ICON_PATH, true)); |
| |
| <strong>EntityManager entityManager = Persistence.createEntityManagerFactory("com.mycompany_MavenPlatformCRUDApp-dbaccess_nbm_1.0-SNAPSHOTPU").createEntityManager(); |
| Query query = entityManager.createQuery("SELECT c FROM Customer c"); |
| List<Customer> resultList = query.getResultList();</strong> |
| }</pre> |
| |
| <p class="tips">コードの持続性ユニットの名前を <tt>persistence.xml</tt> で指定されている名前と比較して、正しい名前になっているか確認してください。</p> |
| </li> |
| <li><tt>ExplorerManager.Provider</tt> を実装するように、クラスの署名を次のように変更します。 |
| <pre class="examplecode">public final class CustomerTopComponent extends TopComponent <strong>implements ExplorerManager.Provider</strong></pre> |
| </li> |
| <li><tt><strong>javax.persistence.Query</strong></tt> および <tt><strong>javax.util.List</strong></tt> をインポートするために、インポートを修正します。</li> |
| <li>次のようにして、ExplorerManager の宣言と初期化を行います。 |
| <pre class="examplecode">private static ExplorerManager em = new ExplorerManager();</pre> |
| </li> |
| <li>abstract メソッドを実装し、<tt>getExplorerManager</tt> メソッドを変更して、<tt>em</tt> を返すようにします。 |
| <pre class="examplecode">@Override |
| public ExplorerManager getExplorerManager() { |
| return em; |
| }</pre> |
| <p class="tips">クラスの署名に挿入カーソルを置いて Alt+Enter を押すと、abstract メソッドを実装できます。</p> |
| </li> |
| <li>コンストラクタに次のコードを追加して、ツリー表示を有効にします。 |
| <pre class="examplecode">BeanTreeView beanTreeView = new BeanTreeView(); |
| add(beanTreeView, BorderLayout.CENTER);</pre> |
| </li> |
| |
| <li>「デザイン」ビューでコンポーネントを右クリックして、「レイアウトを設定」>「ボーダーレイアウト」を選択します。変更を保存します。</li> |
| |
| </ol> |
| |
| <h3><a name="03c"></a>ファクトリクラスの作成</h3> |
| |
| <p>ここで、<tt>com.mycompany.mavenplatformcrudapp.viewer</tt> パッケージに、データベース内の各顧客に新しい BeanNode を作成する新しいクラス <strong>CustomerChildFactory</strong> を作成します。</p> |
| <ol> |
| |
| <li>「<tt><strong>com.mycompany.mavenplatformcrudapp.viewer</strong></tt>」パッケージを右クリックし、「新規」>「Java クラス」を選択します。</li> |
| <li>「クラス名」に「<strong>CustomerChildFactory</strong>」と入力します。「完了」をクリックします。</li> |
| <li>署名を変更して、<tt>ChildFactory<Customer></tt> を拡張します。</li> |
| <li>表の項目一覧のためのフィールド <tt>resultList</tt> を宣言して、<tt>CustomerChildFactory</tt> メソッドを追加します。 |
| <pre class="examplecode">private List<Customer> resultList; |
| |
| public CustomerChildFactory(List<Customer> resultList) { |
| this.resultList = resultList; |
| }</pre> |
| </li> |
| <li><tt>createKeys</tt> abstract メソッドを実装してから変更します。 |
| <pre class="examplecode">@Override |
| protected boolean createKeys(List<Customer> list) { |
| for (Customer customer : resultList) { |
| list.add(customer); |
| } |
| return true; |
| }</pre></li> |
| <li>ノードを作成するメソッドを追加します。 |
| <pre class="examplecode">@Override |
| protected Node createNodeForKey(Customer c) { |
| try { |
| return new BeanNode(c); |
| } catch (IntrospectionException ex) { |
| Exceptions.printStackTrace(ex); |
| return null; |
| } |
| }</pre> |
| </li> |
| <li><tt>org.openide.nodes.Node</tt> および <tt>java.beans.InstrospectionException</tt> をインポートするために、インポートを修正します。変更を保存します。</li> |
| </ol> |
| |
| |
| <p>クラスは次のようになります。</p> |
| |
| <pre class="examplecode">package com.mycompany.mavenplatformcrudapp.viewer; |
| |
| import com.mycompany.mavenplatformcrudapp.dbaccess.Customer; |
| import java.beans.IntrospectionException; |
| import java.util.List; |
| import org.openide.nodes.BeanNode; |
| import org.openide.nodes.ChildFactory; |
| import org.openide.nodes.Node; |
| import org.openide.util.Exceptions; |
| |
| public class CustomerChildFactory extends ChildFactory<Customer> { |
| |
| private List<Customer> resultList; |
| |
| public CustomerChildFactory(List<Customer> resultList) { |
| this.resultList = resultList; |
| } |
| |
| @Override |
| protected boolean createKeys(List<Customer> list) { |
| for (Customer customer : resultList) { |
| list.add(customer); |
| } |
| return true; |
| } |
| |
| @Override |
| protected Node createNodeForKey(Customer c) { |
| try { |
| return new BeanNode(c); |
| } catch (IntrospectionException ex) { |
| Exceptions.printStackTrace(ex); |
| return null; |
| } |
| } |
| |
| }</pre> |
| |
| <p>ここで、<strong>CustomerTopComponent</strong> を変更して、ExplorerManager を使用して JPA クエリーの結果リストを Node に渡すようにします。</p> |
| <ol> |
| <li>CustomerTopComponent コンストラクタに次の行を追加して、ノードのルートコンテキストを設定し、TopComponent の Lookup に TopComponent の ActionMap および ExplorerManager を追加します。 |
| |
| <pre class="examplecode"> |
| EntityManager entityManager = Persistence.createEntityManagerFactory("com.mycompany_MavenPlatformCRUDApp-dbaccess_nbm_1.0-SNAPSHOTPU").createEntityManager(); |
| Query query = entityManager.createQuery("SELECT c FROM Customer c"); |
| List<Customer> resultList = query.getResultList(); |
| <strong>em.setRootContext(new AbstractNode(Children.create(new CustomerChildFactory(resultList), true))); |
| associateLookup(ExplorerUtils.createLookup(em, getActionMap()));</strong></pre> |
| <!-- <li>Expand the Libraries node and change the dependency on <tt>org-openide-nodes</tt> and <tt>org-openide-explorer</tt> from transitive to direct.--> |
| |
| <p>これにより、選択した各ノードのプロパティーウィンドウおよびツールチップのテキストが同期します。</p> |
| </li> |
| <li>インポートを修正して変更内容を保存します。</li> |
| </ol> |
| |
| |
| |
| <h3><a name="03d"></a>アプリケーションの実行</h3> |
| <p>この課題では、アプリケーションが正常にデータベースの表にアクセスして、読み取りを行えるかどうかを確認するためのテストを行います。アプリケーションは、<tt>org-openide-nodes</tt> および <tt>org-openide-explorer</tt> JAR に直接依存リソースを必要とするため、アプリケーションを構築および実行できるようにするには、POM を修正する必要があります。「プロジェクト」ウィンドウで依存リソースを変更できます。</p> |
| |
| <ol> |
| <li>「<strong>dbaccess</strong>」モジュールの「ライブラリ」ノードを展開します。</li> |
| <li>「<tt>org-openide-nodes</tt>」JAR を右クリックし、「直接依存リソースとして宣言」を選択します。</li> |
| <li>「<tt>org-openide-explorer</tt>」JAR を右クリックし、「直接依存リソースとして宣言」を選択します。</li> |
| <li>「<strong>MavenPlatformCRUDApp NetBeans Platform based application</strong>」を右クリックして、「依存関係で構築」を選択します。 |
| <p>「出力」ウィンドウに、含まれるモジュールが表示されます。</p> |
| <img src="../../images/tutorials/maven-crud/mavencrud-build-output1.png" alt="「出力」ウィンドウのスクリーンショット - 上部" title="構築順序を示す「出力」ウィンドウ" class="margin-around b-all" /> |
| <p>「出力」ウィンドウには、構築状態も表示されます。</p> |
| <img src="../../images/tutorials/maven-crud/mavencrud-build-output2.png" alt="「出力」ウィンドウのスクリーンショット - 下部" title="構築の成功を示す「出力」ウィンドウ" class="margin-around b-all" /> |
| </li> |
| <li>アプリケーションを右クリックし、「実行」を選択します。</li> |
| </ol> |
| <p>アプリケーションが起動すると、データベースの表の各レコードのノードと一緒に「Customer」ウィンドウが表示されます。</p> |
| |
| <img src="../../images/tutorials/maven-crud/mavencrud-customer-window1.png" alt="アプリケーションの「Customer」ウィンドウのスクリーンショット" title="アプリケーションの「Customer」ウィンドウ" class="margin-around b-all" /> |
| <p>「Customer」ウィンドウツリーでノードを右クリックして「プロパティー」を選択すると、その項目に関する追加情報が表示されます。</p> |
| |
| |
| <img src="../../images/tutorials/maven-crud/mavencrud-read-properties.png" alt="アプリケーションの「プロパティー」ウィンドウのスクリーンショット" title="選択したノードの詳細を示す「プロパティー」ウィンドウ" class="margin-around b-all" /> |
| |
| </div> |
| |
| |
| |
| <!-- =================================================================== --> |
| <!-- +++++++++++++++++++ Implementing CRUD : UPDATE ++++++++++++++++++++ --> |
| |
| <h2><a name="04"></a>UPDATE: レコードの編集</h2> |
| |
| |
| <p>この節では、レコードの詳細を編集するためのウィンドウコンポーネントを追加します。</p> |
| <div class="indent"> |
| <h3><a name="04a"></a>エディタウィンドウの作成</h3> |
| <p>この課題では、選択したノードの name および city フィールドを編集するための 2 つのテキストフィールドを含む、新しいウィンドウ「MyEditor」を作成します。そのあと、<tt>layer.xml</tt> ファイルを変更して、「Customer」ウィンドウがエディタモードではなくエクスプローラモードで開くようにします。</p> |
| <ol> |
| <li>「<strong>dbaccess</strong>」モジュールを右クリックして、「新規」>「ウィンドウ」を選択します。</li> |
| <li>ドロップダウンリストから「<strong>editor</strong>」を選択し、「<strong>アプリケーションの起動時に開く</strong>」を選択します。「次へ」をクリックします。</li> |
| <li>「クラス名の接頭辞」に「<strong>MyEditor</strong>」と入力します。</li> |
| <li>「パッケージ」に「<strong>com.mycompany.mavenplatformcrudapp.editor</strong>」と入力します。「完了」をクリックします。</li> |
| <li>「<tt>MyEditorTopComponent</tt>」の「デザイン」ビューで、2 つの JLabel と 2 つの JTextField を追加します。 </li> |
| <li>ラベルのテキストに「Name」と「City」を設定し、2 つの JTextField の変数名にそれぞれ「<tt><strong>jTextField1</strong></tt>」と「<tt><strong>jTextField2</strong></tt>」を設定します。変更を保存します。<br/> |
| <img src="../../images/tutorials/maven-crud/mavencrud-myeditor-window.png" alt="「デザイン」ビューのウィンドウコンポーネントのスクリーンショット" title="「デザイン」ビューのウィンドウコンポーネント" class="margin-around b-all" /> |
| </li> |
| <li>「プロジェクト」ウィンドウで「重要なファイル」ノードを展開して「<strong>XML レイヤー</strong>」をダブルクリックし、エディタで <tt>layer.xml</tt> ファイルを開きます。</li> |
| <li><tt>layer.xml</tt> を変更して、「CustomerTopComponent」ウィンドウがエクスプローラモードで表示されるようにします。変更を保存します。 |
| <pre class="examplecode"> |
| <folder name="Modes"> |
| <folder name="editor"> |
| <file name="MyEditorTopComponent.wstcref" url="MyEditorTopComponentWstcref.xml"/> |
| </folder> |
| <strong><folder name="explorer"> |
| <file name="CustomerTopComponent.wstcref" url="CustomerTopComponentWstcref.xml"/> |
| </folder></strong> |
| </folder> |
| </pre> |
| </li> |
| </ol> |
| |
| |
| <p>ここで、アプリケーションをテストして、ウィンドウが開くかどうか、および正しい位置に表示されるかどうかを確認できます。</p> |
| <p class="tips">「依存関係で構築」を実行する前に、アプリケーションに対して「生成物を削除」を実行するようにしてください。</p> |
| |
| <p>これで、「Customer」ウィンドウのノードを選択したときに、オブジェクトの name および city フィールドをエディタに表示するためのコードを追加できるようになりました。</p> |
| |
| |
| <h3><a name="04b"></a>LookupListener の使用</h3> |
| <p>この課題では、「Customer」ウィンドウを変更して、ノードを選択すると新しい <tt>Customer</tt> オブジェクトが Node の Lookup に追加されるようにします。そのあと MyEditor を変更して、Lookup に追加された <tt>Customer</tt> オブジェクトを待機する <tt><a href="http://bits.netbeans.org/dev/javadoc/org-openide-util-lookup/org/openide/util/LookupListener.html">LookupListener</a></tt> をウィンドウに実装します。</p> |
| |
| <ol> |
| <li><strong>CustomerChildFactory</strong> の <tt>createNodeForKey</tt> メソッドが、<tt>BeanNode</tt> ではなく <tt>AbstractNode</tt> を作成するように変更します。 |
| <!--Do this by creating an AbstractNode, instead of a BeanNode, in the CustomerChildFactory class. |
| That enables you to add the current Customer object to the Lookup of the Node, as follows (note the part in bold):--> |
| <pre class="examplecode"> |
| @Override |
| protected Node createNodeForKey(Customer c) { |
| <strong>Node node = new AbstractNode(Children.LEAF, Lookups.singleton(c)); |
| node.setDisplayName(c.getName()); |
| node.setShortDescription(c.getCity()); |
| return node;</strong> |
| // try { |
| // return new BeanNode(c); |
| // } catch (IntrospectionException ex) { |
| // Exceptions.printStackTrace(ex); |
| // return null; |
| // } |
| }</pre> |
| <p>「Customer」ウィンドウで新しいノードを選択すると、選択された <tt>Customer</tt> オブジェクトがウィンドウの Lookup に追加されます。</p> |
| </li> |
| <!-- First, set a dependency in the editor module on the module that provides the entity class, |
| as well as the module that provides the persistence JARs. |
| --> |
| <li><strong>MyEditorTopComponent</strong> の「ソース」タブをクリックして、クラス署名が <tt>LookupListener</tt> を実装するように変更します。 |
| <pre class="examplecode">public final class MyEditorTopComponent extends TopComponent <strong>implements LookupListener</strong></pre> |
| </li> |
| <li>結果を格納する変数を追加します。 |
| <pre class="examplecode">private Lookup.Result result = null;</pre> |
| </li> |
| <li>必要な abstract メソッドを実装して、<tt>resultChanged</tt> メソッドを追加します。</li> |
| <li><tt>resultChanged</tt> メソッドを変更して、新しい <tt>Customer</tt> オブジェクトが Lookup に挿入されるたびに jTextField が更新されるようにします。 |
| <pre class="examplecode"> |
| @Override |
| public void resultChanged(LookupEvent le) { |
| Lookup.Result r = (Lookup.Result) le.getSource(); |
| Collection<Customer> coll = r.allInstances(); |
| if (!coll.isEmpty()) { |
| for (Customer cust : coll) { |
| jTextField1.setText(cust.getName()); |
| jTextField2.setText(cust.getCity()); |
| } |
| } else { |
| jTextField1.setText("[no name]"); |
| jTextField2.setText("[no city]"); |
| } |
| } |
| </pre> |
| |
| |
| <p>LookupListener を定義したら、グローバルコンテキストから取得した <tt>Lookup.Result</tt> に追加できます。グローバルコンテキストは、選択された Node のコンテキストの代わりとして機能します。たとえば、ツリー階層で「Ford Motor Co」を選択すると、「Ford Motor Co」の <tt>Customer</tt> オブジェクトが Node の Lookup に追加されます。これが現時点で選択された Node となるため、「Ford Motor Co」の <tt>Customer</tt> オブジェクトはグローバルコンテキストで使用できるようになります。次に、このオブジェクトが <tt>resultChanged</tt> に渡され、テキストフィールドに値が取り込まれます。</p> |
| </li> |
| <li><tt>componentOpened</tt> および <tt>componentClosed</tt> メソッドを変更して、エディタウィンドウが開いているときに LookupListener がアクティブになるようにします。 |
| <pre class="examplecode"> |
| @Override |
| public void componentOpened() { |
| result = WindowManager.getDefault().findTopComponent("CustomerTopComponent").getLookup().lookupResult(Customer.class); |
| result.addLookupListener(this); |
| resultChanged(new LookupEvent(result)); |
| } |
| |
| @Override |
| public void componentClosed() { |
| result.removeLookupListener(this); |
| result = null; |
| }</pre> |
| <p>アプリケーションが起動するとエディタウィンドウが開くように設定されているので、LookupListener はアプリケーションの起動時に使用可能になります。</p> |
| |
| <p>この例では、「Customer」ウィンドウによって提供されるローカルの Lookup を使用しています。ウィンドウは、この場合「<tt>CustomerTopComponent</tt>」という文字列で明示的に識別されます。この文字列は、<tt>CustomerTopComponent</tt> のソースコードで、CustomerTopComponent の ID として指定されています。この方法は、MyEditorTopComponent が「CustomerTopComponent」の ID で TopComponent を検出できる場合にだけ機能します。 |
| </p> |
| |
| <p class="tips">選択モデルの書き直しなどの、より柔軟な方法については、<a href="http://weblogs.java.net/blog/timboudreau/archive/2007/01/how_to_replace.html">Tim Boudreau 氏によるこのブログエントリ</a>で説明されています。</p> |
| </li> |
| </ol> |
| |
| <p>「生成物を削除」および「依存関係で構築」を実行したら、アプリケーションを再度実行できます。「Customer」ウィンドウで新しい Node を選択すると、エディタウィンドウが更新されるようになりました。<tt>BeanNode</tt> の代わりに <tt>AbstractNode</tt> を使用しているため、ノードの「プロパティー」ウィンドウにプロパティーは表示されません。</p> |
| |
| |
| |
| |
| <h3><a name="04c"></a>元に戻すおよび再実行の追加</h3> |
| <p>この課題では、<tt><a href="http://bits.netbeans.org/dev/javadoc/org-openide-awt/org/openide/awt/UndoRedo.html">UndoRedo</a></tt> マネージャーを実装して、元に戻すおよび再実行機能を有効にします。ツールバーの「Undo」および「Redo」ボタンと、「Undo」および「Redo」メニュー項目は、ユーザーが「Editor」ウィンドウのいずれかのフィールドを変更すると有効になります。</p> |
| |
| <ol> |
| <li>新しい UndoRedoManager を MyEditorTopComponent の先頭で宣言し、インスタンス化します。 |
| <pre class="examplecode">private UndoRedo.Manager manager = new UndoRedo.Manager();</pre> |
| </li> |
| <li>次のようにして、MyEditorTopComponent に <tt>getUndoRedo()</tt> メソッドを作成します。 |
| <pre class="examplecode"> |
| @Override |
| public UndoRedo getUndoRedo() { |
| return manager; |
| }</pre> |
| </li> |
| <li>コンストラクタに次のコードを追加します。 |
| <!--In the constructor of MyEditorTopComponent, add a KeyListener to the jTextFields and, |
| within the related methods that you need to implement, add the UndoRedoListeners: |
| |
| what is happening here? |
| |
| |
| --> |
| <pre class="examplecode"> |
| jTextField1.getDocument().addUndoableEditListener(manager); |
| jTextField2.getDocument().addUndoableEditListener(manager);</pre> |
| </li> |
| </ol> |
| <p>アプリケーションを実行して、「Undo」および「Redo」機能のボタンとメニュー項目が機能するかどうかをテストできます。</p> |
| |
| |
| <h3><a name="04d"></a>保存機能の追加</h3> |
| |
| <p>この課題では、NetBeans プラットフォームの保存機能を統合します。<tt>layer.xml</tt> ファイルを変更して、ツールバーの「Save All」ボタンを隠し、「Save」ボタンを追加します。そのあと、テキストフィールドの変更を検出するリスナーと、変更が検出されたときにトリガーされる <tt>fire</tt> メソッドを追加します。 |
| |
| </p> |
| <ol> |
| <li><strong>dbaccess</strong> モジュールの <tt>layer.xml</tt> ファイルを開き、Toolbar 要素を追加します。 |
| <pre class="examplecode"> |
| <strong><folder name="Toolbars"> |
| <folder name="File"> |
| <file name="org-openide-actions-SaveAction.shadow"> |
| <attr name="originalFile" stringvalue="Actions/System/org-openide-actions-SaveAction.instance"/> |
| <attr name="position" intvalue="444"/> |
| </file> |
| <file name="org-openide-actions-SaveAllAction.shadow_hidden"/> |
| </folder> |
| </folder></strong> |
| </filesystem></pre> |
| </li> |
| <li><strong>MyEditorTopComponent</strong> コンストラクタで、テキストフィールドで変更が検出されたときにメソッドを起動する、次の呼び出しを追加します。 |
| <pre class="examplecode"> |
| public MyEditorTopComponent() { |
| |
| ... |
| jTextField1.getDocument().addUndoableEditListener(manager); |
| jTextField2.getDocument().addUndoableEditListener(manager); |
| |
| <strong>jTextField1.getDocument().addDocumentListener(new DocumentListener() { |
| public void insertUpdate(DocumentEvent arg0) { |
| fire(true); |
| } |
| public void removeUpdate(DocumentEvent arg0) { |
| fire(true); |
| } |
| public void changedUpdate(DocumentEvent arg0) { |
| fire(true); |
| } |
| }); |
| |
| jTextField2.getDocument().addDocumentListener(new DocumentListener() { |
| public void insertUpdate(DocumentEvent arg0) { |
| fire(true); |
| } |
| public void removeUpdate(DocumentEvent arg0) { |
| fire(true); |
| } |
| public void changedUpdate(DocumentEvent arg0) { |
| fire(true); |
| } |
| }); |
| |
| //Create a new instance of our SaveCookie implementation: |
| impl = new SaveCookieImpl(); |
| |
| //Create a new instance of our dynamic object: |
| content = new InstanceContent(); |
| |
| //Add the dynamic object to the TopComponent Lookup: |
| associateLookup(new AbstractLookup(content));</strong> |
| |
| ... |
| }</pre> |
| </li> |
| <li>変更が検出されたときに呼び出される <tt>fire</tt> メソッドを追加します。 |
| |
| <pre class="examplecode"> |
| public void fire(boolean modified) { |
| if (modified) { |
| //If the text is modified, |
| //we add SaveCookie impl to Lookup: |
| content.add(impl); |
| } else { |
| //Otherwise, we remove the SaveCookie impl from the lookup: |
| content.remove(impl); |
| } |
| }</pre> |
| </li> |
| <li><tt>fire</tt> メソッドによって <tt>InstanceContent</tt> に追加される、次の <tt><a href="http://bits.netbeans.org/dev/javadoc/org-openide-nodes/org/openide/cookies/SaveCookie.html">SaveCookie</a></tt> の実装を追加します。 |
| <pre class="examplecode"> |
| private class SaveCookieImpl implements SaveCookie { |
| |
| @Override |
| public void save() throws IOException { |
| |
| Confirmation message = new NotifyDescriptor.Confirmation("Do you want to save \"" |
| + jTextField1.getText() + " (" + jTextField2.getText() + ")\"?", |
| NotifyDescriptor.OK_CANCEL_OPTION, |
| NotifyDescriptor.QUESTION_MESSAGE); |
| |
| Object result = DialogDisplayer.getDefault().notify(message); |
| //When user clicks "Yes", indicating they really want to save, |
| //we need to disable the Save action, |
| //so that it will only be usable when the next change is made |
| //to the JTextArea: |
| if (NotifyDescriptor.YES_OPTION.equals(result)) { |
| fire(false); |
| //Implement your save functionality here. |
| } |
| } |
| }</pre> |
| </li> |
| <li>MyEditorTopComponent に次のフィールドを追加します。 |
| <pre class="examplecode"> |
| private final SaveCookieImpl impl; |
| private final InstanceContent content; |
| </pre> |
| </li> |
| <li>インポートを修正して変更内容を保存します。</li> |
| <li>「プロジェクト」ウィンドウで、「ライブラリ」ノードの下の「<tt>org-openide-dialogs</tt>」JAR を右クリックし、「直接依存リソースとして宣言」を選択します。</li> |
| </ol> |
| <p>ここで、アプリケーションに対して「生成物を削除」、「依存関係で構築」、および「実行」を行うと、テキストフィールドを変更したときに「Save」ボタンが有効になることを確認できます。</p> |
| |
| |
| <h3><a name="04e"></a>変更内容の持続</h3> |
| |
| <p>この課題では、変更内容を持続させるコードを追加します。現時点のアプリケーションでは、フィールドが変更されると正常にそれを認識し、変更内容を保存するオプションを有効にします。「Save」をクリックすると、変更内容を保存するかどうかの確認を求めるダイアログが表示されます。ただし、ダイアログで「了解」をクリックしても、変更内容は持続しません。変更内容を持続させるには、データベースの変更を維持するための JPA コードをいくつか追加する必要があります。</p> |
| |
| <ol> |
| <li><strong>MyEditorTopComponent</strong> に次のフィールドを追加します。 |
| <pre class="examplecode">private Customer customer;</pre> |
| </li> |
| <li><tt>save</tt> メソッドを変更して、変更内容を持続させる JPA コードを追加します。これを行うには、「<tt>//Implement your save functionality here.</tt>」というコメントを次のコードに置き換えます。 |
| <pre class="examplecode">@Override |
| public void save() throws IOException { |
| ... |
| if (NotifyDescriptor.YES_OPTION.equals(result)) { |
| fire(false); |
| <strong>EntityManager entityManager = Persistence.createEntityManagerFactory("com.mycompany_MavenPlatformCRUDApp-dbaccess_nbm_1.0-SNAPSHOTPU").createEntityManager(); |
| entityManager.getTransaction().begin(); |
| Customer c = entityManager.find(Customer.class, customer.getCustomerId()); |
| c.setName(jTextField1.getText()); |
| c.setCity(jTextField2.getText()); |
| entityManager.getTransaction().commit();</strong> |
| } |
| }</pre> |
| <p class="tips">持続性ユニットの名前が正しいことを確認します。</p> |
| <p>「<tt>customer.getCustomerId()</tt>」の「customer」は、現時点では定義されていません。次の手順で、顧客 ID の取得に使用する現在の <tt>Customer</tt> オブジェクトを <tt>customer</tt> に設定します。</p> |
| </li> |
| <li>次のボールドの行を <tt>resultChanged</tt> メソッドに追加します。 |
| <pre class="examplecode"> |
| @Override |
| public void resultChanged(LookupEvent le) { |
| Lookup.Result r = (Lookup.Result) le.getSource(); |
| Collection<Customer> coll = r.allInstances(); |
| if (!coll.isEmpty()) { |
| for (Customer cust : coll) { |
| <strong>customer = cust;</strong> |
| jTextField1.setText(cust.getName()); |
| jTextField2.setText(cust.getCity()); |
| } |
| } else { |
| jTextField1.setText("[no name]"); |
| jTextField2.setText("[no city]"); |
| } |
| }</pre> |
| </li> |
| <li>インポートを修正して変更内容を保存します。</li> |
| </ol> |
| <p>アプリケーションを実行してデータをいくつか変更すると、保存機能が正常に機能して変更内容が持続するかどうかをテストできます。この時点では、変更されたデータはエディタのフィールドに反映されません。データが持続するかどうかを確認するには、アプリケーションを再起動する必要があります。</p> |
| |
| <p>次の課題では、データベースからデータを再読み込みして、エディタで変更内容が表示されるようにする「更新」機能を追加します。</p> |
| |
| |
| |
| <h3><a name="04f"></a>更新機能の追加</h3> |
| <p>この課題では、「Customer」ウィンドウのルートノードに「Refresh」メニュー項目を追加して、Customer ビューアを更新する機能を追加します。</p> |
| |
| <ol> |
| <li>「<tt><strong>com.mycompany.mavenplatformcrudapp.viewer</strong></tt>」パッケージを右クリックし、「新規」>「Java クラス」を選択して、<strong>CustomerRootNode</strong> という名前のクラスを作成します。</li> |
| <li>クラスで <tt>AbstractNode</tt> を拡張し、次のメソッドを追加します。 |
| <pre class="examplecode"> |
| public class CustomerRootNode extends AbstractNode { |
| |
| <strong>public CustomerRootNode(Children kids) { |
| super(kids); |
| setDisplayName("Root"); |
| } |
| |
| @Override |
| public Action[] getActions(boolean context) { |
| Action[] result = new Action[]{ |
| new RefreshAction()}; |
| return result; |
| } |
| |
| private final class RefreshAction extends AbstractAction { |
| |
| public RefreshAction() { |
| putValue(Action.NAME, "Refresh"); |
| } |
| |
| public void actionPerformed(ActionEvent e) { |
| CustomerTopComponent.refreshNode(); |
| } |
| }</strong> |
| |
| }</pre> |
| <p class="tips">「Refresh」アクションは、新しいルートノードにバインドされます。</p> |
| </li> |
| <li><strong><tt>javax.swing.Action</tt></strong> をインポートするために、インポートを修正します。変更を保存します。</li> |
| <li><strong>CustomerTopComponent</strong> を変更して、ビューを再表示するための次のメソッドを追加します。 |
| <pre class="examplecode"> |
| public static void refreshNode() { |
| EntityManager entityManager = Persistence.createEntityManagerFactory("com.mycompany_MavenPlatformCRUDApp-dbaccess_nbm_1.0-SNAPSHOTPU").createEntityManager(); |
| Query query = entityManager.createQuery("SELECT c FROM Customer c"); |
| List<Customer> resultList = query.getResultList(); |
| em.setRootContext(new <strong>CustomerRootNode</strong>(Children.create(new CustomerChildFactory(resultList), true))); |
| }</pre> |
| <p>このメソッドは、ルートコンテキストの設定に <strong>CustomerRootNode</strong> を使用します。</p> |
| <p class="tips"><tt>CustomerRootNode</tt> クラスでは、<tt>refreshNode</tt> が含まれる行で Alt+Enter を押すと、IDE によってメソッドのスケルトンが生成されます。</p> |
| </li> |
| <li>CustomerTopComponent のコンストラクタのコードを、<strong>AbstractNode</strong> の代わりに <strong>CustomerRootNode</strong> への呼び出しに変更します。 |
| <p><tt>CustomerRootNode</tt> を呼び出すと自動的に <tt>refreshNode</tt> メソッドが呼び出され、「Refresh」が呼び出されます。</p> |
| </li> |
| |
| <li>インポートを修正して変更内容を保存します。</li> |
| </ol> |
| |
| <p>アプリケーションを実行すると、ポップアップメニューで「Refresh」アクションが使用できる、新しいルートノードがあることが確認できます。</p> |
| |
| |
| <p class="tips"><tt>refreshNode</tt> メソッドを再利用して自動再表示を実装できます。<tt>save</tt> メソッドから <tt>refreshNode</tt> メソッドを呼び出してください。または、「Refresh」アクションを含む別のモジュールを作成して、このモジュールをモジュール間で共有することもできます。</p> |
| </div> |
| |
| |
| |
| <!-- =================================================================== --> |
| <!-- +++++++++++++++++++ Implementing CRUD : CREATE ++++++++++++++++++++ --> |
| |
| <h2><a name="05"></a>CREATE: 新規レコードの作成</h2> |
| |
| <p>この節では、データベース内にユーザーが新しいエントリを作成できるようにします。</p> |
| <div class="indent"> |
| <h3><a name="05a"></a>作成アクションの追加</h3> |
| <ol> |
| <li>「<strong>dbaccess</strong>」モジュールを右クリックして、「新規」>「アクション」を選択します。</li> |
| <li>「常に有効化」を選択します。「次へ」をクリックします。</li> |
| <li>「カテゴリ」ドロップダウンリストから「<strong>ファイル</strong>」を選択します。</li> |
| <li>「大域ツールバーボタン」を選択します。「次へ」をクリックします。<br/> |
| <img src="../../images/tutorials/maven-crud/mavencrud-new-action.png" alt="「新規アクション」ウィザードのスクリーンショット" title="「新規アクション」ウィザードの「GUI の登録」" class="margin-around b-all" /> |
| |
| </li> |
| <li>「クラス名」に「<strong>NewAction</strong>」と入力します。</li> |
| <li>「表示名」に「<strong>My New Action</strong>」と入力します。</li> |
| <li>「参照」をクリックして、ツールバーで使用する画像を選択します。 |
| <p>次の画像 <tt>abc16.png</tt> をデスクトップにコピーして、ウィザードでこの画像を指定することもできます。( <img src="../../images/tutorials/maven-crud/abc16.png" alt="サンプル 16 x 16 アイコン" title="サンプル 16 x 16 アイコン" /> ) |
| </p> |
| </li> |
| <li>「<strong>com.mycompany.mavenplatformcrudapp.editor</strong>」パッケージを選択します。「完了」をクリックします。</li> |
| <li><tt>NewAction</tt> クラスを、MyEditorTopComponent を開いてフィールドを削除するように変更します。 |
| <pre class="examplecode"> |
| import java.awt.event.ActionEvent; |
| import java.awt.event.ActionListener; |
| |
| public final class NewAction implements ActionListener { |
| |
| public void actionPerformed(ActionEvent e) { |
| MyEditorTopComponent tc = MyEditorTopComponent.getDefault(); |
| tc.resetFields(); |
| tc.open(); |
| tc.requestActive(); |
| } |
| |
| }</pre> |
| |
| <p>このアクションは、ActionListener クラスを実装します。このクラスは、レイヤーファイル内のエントリを通じてアプリケーションにバインドされ、「新規アクション」ウィザードによってアプリケーションに挿入されます。</p> |
| </li> |
| </ol> |
| |
| <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++ --> |
| <!-- I am still hitting issue 186876 in the RC2 build --> |
| <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++ --> |
| |
| <h3><a name="05b"></a>新規オブジェクトの作成および保存</h3> |
| <ol> |
| <li><strong>MyEditorTopComponent</strong> で、JTextFields をリセットし、新しい <tt>Customer</tt> オブジェクトを作成する次のメソッドを追加します。 |
| <pre class="examplecode"> |
| public void resetFields() { |
| customer = new Customer(); |
| jTextField1.setText(""); |
| jTextField2.setText(""); |
| }</pre> |
| <p class="tips"><tt>NewAction</tt> クラスでは、<tt>resetFields</tt> への呼び出しで Alt+Enter を押すと、IDE によって MyEditorTopComponent にメソッドのスケルトンが生成されます。</p> |
| </li> |
| <li>SaveCookie で、null の戻り値が、既存のエントリの更新ではなく、新しいエントリが保存されたことを示すようにします。 |
| <pre class="examplecode"> |
| public void save() throws IOException { |
| |
| Confirmation message = new NotifyDescriptor.Confirmation("Do you want to save \"" |
| + jTextField1.getText() + " (" + jTextField2.getText() + ")\"?", |
| NotifyDescriptor.OK_CANCEL_OPTION, |
| NotifyDescriptor.QUESTION_MESSAGE); |
| |
| Object result = DialogDisplayer.getDefault().notify(msg); |
| |
| //When user clicks "Yes", indicating they really want to save, |
| //we need to disable the Save button and Save menu item, |
| //so that it will only be usable when the next change is made |
| //to the text field: |
| if (NotifyDescriptor.YES_OPTION.equals(result)) { |
| fire(false); |
| EntityManager entityManager = Persistence.createEntityManagerFactory("CustomerLibraryPU").createEntityManager(); |
| entityManager.getTransaction().begin(); |
| <strong>if (customer.getCustomerId() != null) {</strong> |
| Customer c = entityManager.find(Customer.class, cude.getCustomerId()); |
| c.setName(jTextField1.getText()); |
| c.setCity(jTextField2.getText()); |
| entityManager.getTransaction().commit(); |
| <strong>} else { |
| Query query = entityManager.createQuery("SELECT c FROM Customer c"); |
| List<Customer> resultList = query.getResultList(); |
| customer.setCustomerId(resultList.size()+1); |
| customer.setName(jTextField1.getText()); |
| customer.setCity(jTextField2.getText()); |
| //adds more fields that will populate the zip and discountCode columns |
| customer.setZip("12345"); |
| customer.setDiscountCode(entityManager.find(DiscountCode.class, 'H')); |
| |
| entityManager.persist(customer); |
| entityManager.getTransaction().commit(); |
| }</strong> |
| } |
| |
| }</pre> |
| <p>また、DiscountCode を空にすることはできないため、このフィールドに任意のデータを書き込んでいます。</p> |
| </li> |
| <li><tt><strong>javax.persistence.Query</strong></tt> をインポートするために、インポートを修正します。変更を保存します。</li> |
| </ol> |
| |
| </div> |
| |
| |
| <!-- =================================================================== --> |
| <!-- ++++++++++++++++++++ Running the Application ++++++++++++++++++++++ --> |
| |
| <h2><a name="06"></a>アプリケーションの構築と実行</h2> |
| <p>これで、アプリケーションは CRUD 機能のうちの 3 つ (Create、Read、および Update) を実行できるようになりました。ここでアプリケーションを構築および実行し、すべての機能が正常に動作するかを確認できます。</p> |
| <ol> |
| <li>「<strong>MavenPlatformCRUDApp NetBeans Platform based application</strong>」のプロジェクトノードを右クリックして、「生成物を削除」を選択します。</li> |
| <li>「<strong>MavenPlatformCRUDApp NetBeans Platform based application</strong>」のプロジェクトノードを右クリックして、「依存関係で構築」を選択します。</li> |
| <li>「<strong>MavenPlatformCRUDApp NetBeans Platform based application</strong>」のプロジェクトノードを右クリックして、「実行」を選択します。</li> |
| </ol> |
| |
| <p>「実行」をクリックすると、IDE によってプラットフォームアプリケーションが起動します。アプリケーションは、データベースの顧客名を使用して「Customer」ウィンドウにツリーを生成します。「Customer」ウィンドウでノードを選択すると、選択した顧客の名前および都市が「My Editor」ウィンドウに表示されます。「Name」および「City」フィールドのデータを変更して保存できます。新しい顧客を作成するには、ツールバーで「My Action」ボタンをクリックし、「My Editor」ウィンドウの空のテキストフィールドに名前と都市を入力してから、「Save」をクリックします。</p> |
| <p> |
| <img src="../../images/tutorials/maven-crud/mavencrud-finished-app.png" alt="完成したアプリケーションのスクリーンショット" title="「Customer」および「MyEditor」ウィンドウを表示する完成したアプリケーション" class="margin-around b-all" /> |
| </p> |
| <p class="tips">保存機能に「Refresh」アクションを実装しなかった場合は、顧客を作成または変更したあとに、「Customer」ウィンドウのルートノードを再表示する必要があります。</p> |
| |
| <p>このチュートリアルでは、Maven を使用した NetBeans プラットフォームアプリケーションの作成方法が、Ant を使用した作成方法と大きく違わないことを示しました。主な違いは、Maven POM によるアプリケーション組み立ての制御方式です。ほかの NetBeans プラットフォームアプリケーションおよびモジュール構築の例については、「<a href="https://netbeans.org/kb/trails/platform.html">NetBeans プラットフォームの学習</a>」に一覧表示されている各チュートリアルを参照してください。</p> |
| |
| <!-- ======================================================================================== --> |
| |
| |
| <h2><a name="nextsteps"></a>関連項目</h2> |
| |
| <p>これで、CRUD チュートリアルを終了します。このドキュメントは、Maven 構築フレームワークを使用して、CRUD 機能を備えた新しい NetBeans プラットフォームアプリケーションを作成する方法について説明しました。アプリケーションの作成と開発の詳細については、次のリソースを参照してください。</p> |
| <ul> |
| <li><a href="https://netbeans.org/kb/trails/platform_ja.html">NetBeans プラットフォームの学習</a></li> |
| <li><a href="http://bits.netbeans.org/dev/javadoc/">NetBeans API Javadoc</a></li> |
| </ul> |
| |
| <p>NetBeans プラットフォームに関して質問がある場合は、dev@platform.netbeans.org のメーリングリストに投稿していただくか、<a href="https://netbeans.org/projects/platform/lists/dev/archive">NetBeans プラットフォームメーリングリストのアーカイブ</a>を参照してください。</p> |
| |
| |
| <!-- ======================================================================================== --> |
| |
| |
| </body> |
| |
| </html> |