blob: 29c28edfc3beddc2d6e9f9f96c75f6473a5da410 [file] [log] [blame]
//
// Licensed to the Apache Software Foundation (ASF) under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied. See the License for the
// specific language governing permissions and limitations
// under the License.
//
= Webアプリケーションでのアプレットの統合
:jbake-type: tutorial
:jbake-tags: tutorials
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Webアプリケーションでのアプレットの統合 - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Webアプリケーションでのアプレットの統合
アプレットとは、Javaプログラミング言語で記述されたプログラムで、イメージをページに含めるのとよく似た方法でHTMLページに含めることができるものです。このチュートリアルでビルドするアプリケーションでは、アプレットをIDE内でビルドしてデプロイする方法を示します。
*注意: *IDE内にアプレットを作成する目的で設計されたプロジェクト・テンプレートはありませんが、このようなテンプレートは、このチュートリアルで示すようにJavaプロジェクトで簡単に開発してWebプロジェクト内にパッケージ化できます。
image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
*このチュートリアルに従うには、次のソフトウェアとリソースが必要です。*
|===
|ソフトウェアまたはリソース |必須バージョン
|link:https://netbeans.org/downloads/index.html[+NetBeans IDE+] |7.2、7.3、7.4、8.0、Javaバージョン
|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Java Development Kit (JDK)+] |バージョン7または8
|GlassFish Server Open Source Edition
_または_
Tomcatサーブレット・コンテナ |3.xまたは4.x
_ _
バージョン7.xまたは8.x
|===
== アプレット・ソース・ファイルの作成またはインポート
この項では、最初のアプレットを作成します。作成したアプレットがすでにある場合、次の手順を使用してそのアプレットをIDEにインポートします。
=== 最初からまたは既存のソースからのJavaプロジェクト作成
1. 「ファイル」>「新規プロジェクト」([Ctrl]-[Shift]-[N])を選択します。「カテゴリ」から「Java」を選択します。
2. 次のいずれかを選択します。
* 新しいアプレット・ソース・ファイルを作成する場合、「プロジェクト」の下の「Javaクラス・ライブラリ」を選択します。「次」をクリックします。
* アプレット・ソース・ファイルをインポートする場合、既存のソースがあるJavaプロジェクトを選択します。「次」をクリックします。「ソース・パッケージのフォルダ」テキスト・ボックスで、ファイルの場所を指定します。
. 「プロジェクト名」に「 ``HelloApplet`` 」と入力します。「プロジェクトの場所」をローカル・コンピュータ上の任意のフォルダに変更します。
. 「終了」をクリックします。アプレット・ソース・ファイルをインポートした場合は、<<runanddebug,それを実行>>します。
=== アプレット・ソース・ファイルの作成
1. HelloApplet」プロジェクトを右クリックして「プロパティ」を選択し、「プロパティ」ウィンドウを開きます。
2. プロジェクトに必要なソース/バイナリ形式を選択し、「OK」をクリックします。
*注意: *たとえば、JDK 6を選択した場合、それより古いバージョンのJREまたはJavaブラウザ・プラグインが存在するマシンでは、アプレットが動作しない可能性があります。
. 「プロジェクト」ウィンドウの「HelloApplet」プロジェクト・ノードを右クリックし、「新規」>「その他」([Ctrl]-[N])を選択します。
. 「カテゴリ」から「Java」を選択します。「ファイル・タイプ」から「アプレット」を選択します。
または、新しいアプレットを視覚的にデザインする場合、「Swing GUIフォーム」>「JAppletフォーム」を選択します。
「次」をクリックします。
. 「クラス名」に「 ``MyApplet`` 」と入力します。「パッケージ」に「 ``org.me.hello`` 」と入力します。
. 「終了」をクリックします。
IDEで、アプレット・ソース・ファイルが指定したパッケージ内に作成されます。ソース・エディタが開いて、アプレット・ソース・ファイルが表示されます。
. 既存のデフォルト・コードの上に次のコードを コピーして貼り付け、アプレット・クラスを定義します。
[source,java]
----
package org.me.hello;
import java.applet.Applet;
import java.awt.Graphics;
public class MyApplet extends Applet {
@Override
public void paint(Graphics g) {
g.drawString("Hello applet!", 50, 25);
}
}
----
または、アプレット・フォームをデザインする場合、link:../java/quickstart-gui.html[+NetBeans IDEにおけるGUI構築+]のドキュメントを使用して、次のようなフォームを作成します。
image::images/movie-magic-quiz-design.png[]
アプレットの記述方法に関する詳細は、Java^TM^チュートリアルのlink:http://download.oracle.com/javase/tutorial/deployment/applet/index.html[+アプレット+]の項を参照してください。
== アプレット・ソース・ファイルの実行
作成したアプレットは、IDEから実行できます。この項でその方法を説明します。
=== アプレット・ソース・ファイルのビルドと実行
「プロジェクト」ウィンドウでMyApplet.javaファイル・ノードを右クリックし、コンテキスト・メニューから「ファイルの実行」を選択します。アプレットが埋め込まれる ``MyApplet.html`` 起動ファイルは、 ``build`` フォルダに作成され、「ファイル」ウィンドウ([Ctrl]-[2])に切り替えると確認できます。
image::images/built-project-files.png[]
アプレットはアプレット・ビューアで起動します。
image::images/appletviewer.png[]
アプレット・フォームもアプレット・ビューアで表示されます。
image::images/movie-magic-quiz.png[]
== アプレットのWebアプリケーションへの埋込み
これでアプレットの作成は完了しました。次に、これをユーザーが使用できるようにする必要があります。そのためには、Webアプリケーションを作成し、このアプレットJARをクラスパスに配置し、アプレット・タグをWebアプリケーションのHTMLファイルに追加します。
=== Webプロジェクトの作成
1. 「ファイル」>「新規プロジェクト」を選択します。
2. Java Web」カテゴリから「Webアプリケーション」を選択します。「次」をクリックします。
3. 「プロジェクト名」に「 ``HelloWebApplet`` 」と入力します。
4. 「プロジェクトの場所」をローカル・コンピュータ上の任意のフォルダに変更します。「次」をクリックします。
5. ターゲット・サーバーを選択します。「終了」をクリックします。
=== アプレットJARファイルのWebプロジェクトへの追加
アプレットJARファイルをWebプロジェクトに含める場合は、そのJARファイルが格納されたJavaプロジェクトを追加するか、またはJARファイル自体を追加します。どちらを選択することもできますが、JavaプロジェクトをWebプロジェクトに追加する場合、Webアプリケーションをビルドするたびに、IDEでそのアプレットが毎回ビルドされます。そのため、そのアプレットをJavaプロジェクトで変更すると、そのWebプロジェクトのビルド時にIDEで新しいバージョンのアプレットが常にビルドされます。一方、そのアプレットJARファイルがNetBeans IDEプロジェクト内にない場合、アプレット・ソース・ファイルはWebプロジェクトのビルド時に再ビルドされません。
*注意:* IDE ``HelloApplet`` プロジェクトを使用している場合、この時点で ``HelloApplet.jar`` ファイルは存在しません。それで問題ありません。 ``HelloApplet.jar`` ファイルは ``HelloWebApplet`` プロジェクトのビルド時にビルドされます。
1. 「プロジェクト」ウィンドウで、「HelloWebApplet」プロジェクト・ノードを右クリックし、コンテキスト・メニューから「プロパティ」を選択します。
2. 「パッケージング」カテゴリを選択します。
3. 次のいずれかを選択します。
* アプレットがJavaプロジェクト内にある場合、「プロジェクトの追加」をクリックしてJavaプロジェクトを含むフォルダを特定します。「JAR/フォルダの追加」をクリックします。
*注意:*IDEプロジェクトには、NetBeans IDEプロジェクト・アイコンのマークが付きます。
* IDEプロジェクト内にないアプレットJARファイルを使用している場合、「ファイル/フォルダの追加」をクリックし、JARファイルを含むフォルダを特定します。「選択」をクリックします。
. アプレットのソース・ファイルを含むJARが「プロジェクト・プロパティ」ウィンドウの表にリストされていることを確認します。「OK」をクリックします。
デフォルトでは、アプレットJARファイルはWebアプリケーションのWebページ・ライブラリ( ``build/web`` フォルダ)にコピーされます。 ``build/web`` フォルダはアプリケーションのルート・ディレクトリで、表の「WAR内のパス」列に" ``/`` "と表示されます。「WAR内のパス」列にアプレットの新しい場所を入力すると、WAR内のアプレットの場所を変更できます。
. 「閉じる」をクリックして、「プロジェクト・プロパティ」ウィンドウを閉じます。
IDEのメイン・メニューから「実行」>「プロジェクトのビルド(HelloWebApplet)」を選択して ``HelloWebApplet`` プロジェクトをビルドすると、アプレットのJARファイルが元の ``HelloApplet`` プロジェクト内に生成され、 ``HelloWebApplet`` プロジェクトのWARファイルにパッケージ化されます。 ``build/web`` フォルダにも追加されます。この処理を「出力」ウィンドウで追跡し、結果を「ファイル」ウィンドウで確認できます。
[.feature]
--
image:images/helloapplet-jar-in-files-small.png[role="left", link="images/helloapplet-jar-in-files.png"]
--
=== JSPファイルまたはHTMLファイルの作成と実行
1. 次のいずれかを選択します。
* アプレットをJSPファイルに埋め込む場合は、「プロジェクト」ウィンドウにあるデフォルトの ``index.jsp`` ファイルをダブルクリックします。このファイルは、Webプロジェクトの作成時にIDEで作成されます。ソース・エディタにこのファイルが表示されます。
* アプレットをHTMLファイルに埋め込む場合は、「HelloWebApplet」プロジェクト・ノードを右クリックし、コンテキスト・メニューから「新規」>「その他」を選択します。「カテゴリ」から「Web」を選択します。「ファイル・タイプ」から「HTML」を選択します。「次」をクリックします。HTMLファイルに名前を付け、その場所としてWebフォルダを選択し、「終了」をクリックします。
. 次のように、ファイルの ``<body>`` ``</body>`` 2つのタグの間の任意の場所にアプレット・タグを追加することで、アプレットをファイルに埋め込みます。
* HTMLファイル内: [examplecode]# ``<applet code="org.me.hello.MyApplet" archive="HelloApplet.jar"></applet>`` #
* JSPファイル内: [examplecode]# ``<applet code="org.me.hello.MyApplet" archive="HelloApplet.jar" width="600" height="480"/>`` #
*注意:*
* このチュートリアルでは、HTMLファイルにアプレット・コードを追加する場合は、左マージンにあるヒント・グリフを無視できます。
* ``org.me.hello.MyApplet`` はアプレットの完全クラス名です。
* ``HelloApplet.jar`` はアプレットを格納するJARファイル名です。
. 「プロジェクト」ウィンドウでこのJSPノードまたはHTMLノードを右クリックし、コンテキスト・メニューから「ファイルを実行」を選択します。
サーバーによって、JSPファイルまたはHTMLファイルがIDEのデフォルト・ブラウザにデプロイされます。
次の図のような表示になります(セキュリティ警告ダイアログ・ボックスで「実行」をクリックしてアプリケーションの実行を許可した後)。
[.feature]
--
image:images/appletinbrowser-small.png[role="left", link="images/appletinbrowser.png"]
--
アプレット・フォームの場合、次のように表示されるはずです。
image::images/movie-magic-quiz-html.png[]
link:/about/contact_form.html?to=3&subject=Feedback:%20Introduction%20to%20Developing%20Applets[+このチュートリアルに関するご意見をお寄せください+]