blob: 0c88db783cf56909d4739c47a4bc80f964baec53 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--
Copyright (c) 2009, 2010, 2011, Oracle and/or its affiliates. All rights reserved.
-->
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="description" content="A short guide to enabling Java Web Start for a simple Java SE application in NetBeans IDE">
<meta name="keywords" content="NetBeans, IDE, integrated development environment, Java Web Start, Java
tutorial, guide, user, documentation, open source, Java">
<link rel="stylesheet" type="text/css" href="../../../netbeans.css">
<title>NetBeans IDEでのJava Web Startの有効化</title>
<style type="text/css">
<!--
.style1 {color: #FF0000}
.style2 {color: #000000}
-->
</style>
</head>
<body>
<h1>NetBeans IDEでのJava Web Startの有効化</h1>
<p>このチュートリアルの手順に従い、Java Web Startを使用してアプリケーションをデプロイできるようにアプリケーションを構成する方法を学びます。Java Web Startは、シングル・クリックでWebブラウザからJavaアプリケーションを実行するために使用されるテクノロジです。つまり、Java Web Startは単に、Javaアプリケーションをデプロイできるもう1つの方法です。 </p>
<p>このチュートリアルでは、距離の測定値をメートル法と米国単位の間で変換する単純なJavaアプリケーション(コンバータ)を使用します。このサンプル・アプリケーションのコードはダウンロードで提供され、Java Web Startを使用してアプリケーションを起動するにはプロジェクト設定を構成する必要があります。アプリケーション・ファイルのアップロードには、使用可能な任意のリモートWebサーバーを使用できます。</p>
<p>このチュートリアルを完了するのに要する時間は約<span class="style2">20</span>分です。 </p>
<p><b>目次</b></p>
<img alt="このページの内容は、NetBeans IDE 6.9、7.0、7.1、7.2および7.3に適用されます" class="stamp" src="../../../images_www/articles/71/netbeans-stamp-71-72-73.png" title="このページの内容は、NetBeans IDE 6.9、7.0、7.1および7.3に適用されます">
<ul class="toc">
<li><a href="#openproject" title="プロジェクトの設定">プロジェクトを開く</a></li>
<li><a href="#configure" title="Javaソース・コードの作成と編集">Java Web Startを有効にするためのプロジェクトの構成</a></li>
<li><a href="#runremote">リモートの場所からのアプリケーションの実行</a></li>
<li><a href="#summary" title="アプリケーションのテストとデバッグ">要約</a></li>
<li><a href="#seealso" title="次の手順">関連項目</a></li>
</ul>
<p><b>このチュートリアルを完了するには、次の表に示すソフトウェアとリソースが必要です。</b></p>
<table>
<tbody>
<tr>
<th width="165" class="tblheader" scope="col">ソフトウェアまたはリソース</th>
<th width="142" class="tblheader" scope="col">必須バージョン</th>
</tr>
<tr>
<td class="tbltd1"><a href="http://download.netbeans.org/">NetBeans IDE</a></td>
<td class="tbltd1">6.9, 7.0, 7.1, 7.2, 7.3 </td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Java Development Kit (JDK)</a></td>
<td class="tbltd1"> 6または7 </td>
</tr>
<tr>
<td class="tbltd1"><a href="https://netbeans.org/projects/samples/downloads/download/Samples%252FJava%252FConverterPrj.zip">Converterのzipアーカイブ</a></td>
<td class="tbltd1">該当なし</td>
</tr>
</tbody>
</table>
<h2>プロジェクトを開く<a id="openproject" name="openproject"></a></h2>
<p>最初に、IDEでConverterアプリケーションを開く必要があります。このアプリケーションは、ユーザーがIDEでプロジェクトを開くのみで済むように、すでにNetBeans IDEプロジェクトとしてパッケージ化されています。 </p>
<p>Converterデモのソース・コードは、Javaチュートリアルに元々用意されています。この小さいアプリケーションの記述方法については、Javaチュートリアルの<a href="http://java.sun.com/docs/books/tutorial/uiswing/examples/components/index.html" target="_blank">Swingコンポーネントの使用</a>の項を参照してください。このチュートリアルでは、このJavaアプリケーションをWebブラウザで起動できるように、プロジェクト設定を構成する方法について学びます。 </p>
<ol>
<li><a href="https://netbeans.org/projects/samples/downloads/download/Samples%252FJava%252FConverterPrj.zip" target="_blank">Converterデモ・アプリケーションのzipアーカイブ</a>をダウンロードします。</li>
<li>このアーカイブをシステム上の場所に展開します。</li>
<li>IDEで、メイン・メニューから「ファイル」>「プロジェクトを開く」を選択します。<br>「プロジェクト」ウィンドウに<tt>ConverterPrj</tt>プロジェクトが開きます。プロジェクトのノードを展開すると、ソース・ファイルを表示できます。 </li>
</ol>
<p class="align-center"><img alt="ConverterPrjの内容を示すイメージ。" class="margin-around" src="../../../images_www/articles/71/java/javaws/converterprj.png"></p>
<!-- =============================================================================== -->
<h2><a name="configure"></a>Java Web Startを有効にするためのプロジェクトの構成</h2>
<p>Java Web Startを使用すると、ユーザーはWebブラウザ内で、このアプリケーションの<tt>JNLP</tt>ファイルへのHTMLリンクをクリックしてJavaアプリケーションを起動できます。特殊な構成ファイルである<tt>JNLP</tt>ファイルは、Java Web Startに対して、Javaアプリケーションのダウンロード、キャッシュ、および実行を指示します。Java Web Startを使用してアプリケーションを実行するには、互換性のあるJava Runtime Environment (JRE)のバージョンがクライアント・マシンにインストールされていれば十分です。Java Development Kit (JDK)は必要ありません。 </p>
<p>JavaアプリケーションをJava Web Startで実行できるように有効にするには、IDEによるプロジェクトのビルド方法に関するプロパティを構成する必要があります。プロジェクトのプロパティでJava Web Startが有効化されると、IDEは、<tt>JNLP</tt>ファイルと、JARファイルと一緒に<tt>JNLP</tt>ファイルへのリンクを備えたHTMLページを、自動的に作成します。 </p>
<div class="indent">
<h3 class="tutorial">Java Web Startを有効にするためのプロジェクトの構成 </h3>
<p>この課題では、Java Web Startを有効にするようにプロジェクトを構成し、その実行をローカルにテストします。 </p>
<ol>
<li><tt>ConverterPrj</tt>」プロジェクト・ノードを右クリックし、「プロパティ」を選択します。 </li>
<li>「カテゴリ」から「Web Start」を選択し、「Web Startを有効化」チェックボックスを選択します。 </li>
<li>最初にアプリケーションをローカルで実行するため、「コードベース」ドロップダウン・リストから「ローカル実行」オプションを選択します。<br>「コードベースのプレビュー」フィールドにローカル・アプリケーション・ファイルへのパスが表示されます。 </li>
<li>「カスタマイズ」をクリックして「署名」ダイアログ・ボックスを開きます。「<tt>生成されたキーによる自己署名</tt>」オプションを選択します。<br>プロジェクトのビルド時に自動的に生成された証明書によって、アプリケーションのJARファイルが署名されます。自己署名証明書により、アプリケーションは、ローカルで実行されるレギュラ・アプリケーションとして、コンピュータから同じリソースにアクセスできるようになります。たとえば、自己署名証明書を使用すると、アプリケーションはローカル・ファイルやネットワークにアクセスできます。 </li>
<li>「混合コード」ドロップダウン・リストで「ソフトウェア保護を有効にする」が選択されたままにして、「OK」をクリックします。</li>
<li>(オプション)「プロジェクト・プロパティ」ダイアログ・ボックスで、「アプリケーション」パネルを選択して、アプリケーション・タイトルおよびベンダー名を変更します。 </li>
<li>「OK」をクリックして、「プロジェクト・プロパティ」ダイアログ・ボックスを閉じます。 </li>
</ol>
<p class="align-center">
<a href="../../../images_www/articles/71/java/javaws/prjproperties.png" rel="lytebox" title="ConverterPrjのプロパティを示すイメージ。"> <img alt="ConverterPrjのプロパティを示すイメージ。" border="1" src="../../../images_www/articles/71/java/javaws/prjproperties-small.png"></a></p>
<h3>IDEからのJava Web Startアプリケーションのコンパイルと実行 </h3>
<p><strong>アプリケーションをコンパイルおよび実行してJava Web Startをローカルでテストする</strong></p>
<ol>
<li>「プロジェクト」ウィンドウで「<tt>ConverterPrj</tt>」プロジェクト・ノードを選択してから、メイン・メニューで「実行」>「メイン・プロジェクトとして設定」>「ConverterPrj」を選択します。 </li>
<li>「実行」>「メイン・プロジェクトの実行」を選択するか、[F6]を押します。<br>IDEがソースをコンパイルすると、Javaが起動中であることを示すスプラッシュ画面と、署名済のアプリケーションを実行するかどうかを尋ねる警告ウィンドウが表示されるはずです。 <p class="align-center">
<a href="../../../images_www/articles/71/java/javaws/warning.png" rel="lytebox" title="警告"> <img alt="警告" border="1" src="../../../images_www/articles/71/java/javaws/warning-small.png"></a></p> </li>
<li>内容を信頼することを示すチェックボックスを選択し、警告ウィンドウで「実行」をクリックします。<br> Converterアプリケーションが起動します。 <p><img alt="Converterアプリケーションを示すイメージ。" class="margin-around" src="../../../images_www/articles/71/java/javaws/converterapp.png"></p> </li>
</ol>
<h3 class="tutorial">Java Web Startファイルについて</h3>
<p>では、ビルド・プロセス中(「実行」>「プロジェクトのビルド」)にIDEによって作成されたJava Web Startファイルを詳しく参照します。 </p>
<p>ファイルを表示するには、IDEの「ファイル」ウィンドウを開いて<tt>dist</tt>フォルダを展開します。</p>
<p class="align-center"><img alt="Converterアプリケーション用に作成されたファイルを示すイメージ。" class="margin-around" src="../../../images_www/articles/71/java/javaws/converterfiles.png"></p>
<p> Java Web Start用に、次の2つの追加ファイルが作成されます。 </p>
<ul>
<li><tt>launch.jnlp</tt> - これは、アプリケーションの実行方法をブラウザに指示する特殊な要素と属性を含んだXMLファイルです。<tt>JNLP</tt>は、Java Network Launching Protocolの略です。<tt>JNLP</tt>ファイルの属性には、<tt>JNLP</tt>の仕様バージョン、アプリケーション・タイトル、ベンダー名、アプリケーションのJARファイルへのリンクなどが含まれます。 </li>
<li><tt>launch.html</tt> - これは、<tt>JNLP</tt>ファイルへのリンクを含む、自動的に生成されたHTMLページです。ユーザーはこのリンクをクリックしてJava Web Startからアプリケーションを起動します。生成されたこのHTMLファイルには、すでに公開されているJava Deployment Toolkit (<a href="http://java.com/js/deployJava.js" target="_blank">deployJava.js</a>)の参照情報がコメントアウトされており、ブラウザの互換性に関する問題を回避するためのJavaScript関数を提供しています。<a href="http://download.oracle.com/javase/6/docs/technotes/guides/jweb/deployment_advice.html#deplToolkit" target="_blank">Java Deployment Toolkitの詳細情報については、ここ</a>を参照してください。<br><br> IDEの外部で、システム上の<tt>launch.html</tt>ファイルに移動し、ブラウザで開いてリンクをクリックし、Converterデモ・アプリケーションを起動してみてください。 </li>
</ul>
</div>
<h2><a id="runremote" name="runremote"></a>リモートの場所からのアプリケーションの実行</h2>
<p>Java Web Startを使用してローカル・ソースからアプリケーションを問題なく起動できることが確認できたら、リモートの場所にアップロードして、そこから起動します。</p>
<p class="notes"><b>注意:</b> Web上でJava Web Startを使用してアプリケーションをデプロイする場合、使用するWebサーバーが<tt>JNLP</tt>ファイルを扱えるようにしてください。Webサーバーは、<tt>JNLP</tt>ファイルをアプリケーションとして認識するように構成します(つまり、<tt>JNLP</tt>のMIMEタイプをWebサーバーの構成に追加します)。これを行わないと、<tt>JNLP</tt>拡張子の付いたファイルは通常のテキスト・ファイルとして扱われます。Webサーバーの構成に関する詳細は、<a href="http://docs.oracle.com/javase/6/docs/technotes/guides/javaws/developersguide/setup.html" target="_blank">Java Web Startガイド</a>を参照してください。</p>
<div class="indent">
<h3 class="tutorial">JNLPファイルの変更</h3>
<p>Webからアプリケーションを起動するには、<tt>JNLP</tt>ファイル内に、Web上のアプリケーション・ソース・ファイルへのリンクを指定する必要があります。 </p>
<ol>
<li><tt>ConverterPrj</tt>」プロジェクト・ノードを右クリックし、「プロパティ」を選択して「カテゴリ」の下にある「Web Start」を選択します。 </li>
<li>コードベースとして「ユーザー定義」を選択します。</li>
<li>「コードベースのプレビュー」フィールドに、ソース・ファイルのアップロード先とするURLを入力します。<br>たとえば、<tt>http://mydomain.com/myuser/converter/</tt>です。</li>
<li>「プロジェクト・プロパティ」ウィンドウで「OK」をクリックします。</li>
<li><tt>ConverterPrj</tt>」ノードを右クリックし、「消去してビルド」を選択します。<br>このIDEコマンドにより、以前にコンパイルされたすべてのファイルとビルド出力が削除され、アプリケーションが再コンパイルされ、出力ファイルが現在の設定でビルドされます。 </li>
</ol>
<h3 class="tutorial">ソース・ファイルのアップロード </h3>
<p>ここで、ソース・ファイルをサーバーにアップロードし、そこからアプリケーションを実行します。この項で使用しているすべてのユーザー証明書とプロジェクト名は、ご自分の個人データに置き換えてください。 </p>
<ol>
<li>Webサーバーにログインし、プロジェクトのダウンロード領域に移動します。<br>ここでは、プロジェクト・タイトルは「NetBeans IDEドキュメント領域」です。</li>
<li>プロジェクトの<tt>dist</tt>フォルダからプロジェクトのそのディレクトリに、<tt>ConverterPrj.jar</tt><tt>launch.html</tt>、および<tt>launch.jnlp</tt>のローカル・ファイルをアップロードします。
<p>次の図は、NetBeans IDEドキュメント領域プロジェクトのダウンロード領域を示しています。 </p>
<p class="align-center">
<a href="../../../images_www/articles/71/java/javaws/download.png" rel="lytebox" title="NetBeans IDEドキュメント領域プロジェクトのダウンロード領域を示すイメージ"> <img alt="NetBeans IDEドキュメント領域プロジェクトのダウンロード領域を示すイメージ" border="1" src="../../../images_www/articles/71/java/javaws/download-small.png"></a></p></li>
<li>次に、アプリケーションを実行します。ブラウザ・ウィンドウで、<tt>launch.html</tt>ファイルへのURLを入力し、「アプリケーションを起動」リンクをクリックします。
<p>Java Web Startを使用してConverterアプリケーションが起動します。</p> </li>
</ol>
</div>
<h2><a name="summary"></a>要約</h2>
<p>この短いチュートリアルでは、NetBeans IDEを使用して、JavaアプリケーションをWeb経由で簡単にデプロイできるようにする方法を示しました。これは、Javaアプリケーションのデプロイ方法のほんの一例です。 </p>
<div class="indent"></div>
<!--<br>-->
<div class="feedback-box"><a href="/about/contact_form.html?to=3&amp;subject=Feedback:%20Enabling%20Java%20Web%20Start%20in%20the%20NetBeans%20IDE">このチュートリアルに関するご意見をお寄せください</a></div>
<br style="clear:both;" >
<h2><a id="seealso" name="seealso"></a>関連項目 </h2>
<p>Java Web Startの使用方法の詳細は、次のリソースを参照してください。 </p>
<ul>
<li><a href="http://download.oracle.com/javase/6/docs/technotes/guides/javaws/developersguide/contents.html" target="_blank">Java Web Startガイド</a> - Java Web Startテクノロジを使用するためのガイド </li>
<li>Javaチュートリアルの「<a href="http://download.oracle.com/javase/tutorial/deployment/webstart/index.html">Lesson: Java Web Start</a>」 - アプリケーションをJava Web Start対応にするための実践的な課題 </li>
</ul>
</body>
</html>