連載：Tomcatを使う「JSPプログラミング」第6回

新人SEのためのJava講座

Tomcatを使う「JSPプログラミング」

三谷純
タイムインターメディア
2001/8/8

第6回　クラスやBeanの作成とJSPとの連携

前回は既存のJSPコードをインクルードすることで、プログラムを再利用する方法を説明しました。今回は、JavaクラスとBeanのそれぞれについてオリジナルのものを作成し、それを利用する方法を解説します。また、JSPにおけるBeanのスコープの概念についても簡単に説明します。

今回の内容

オリジナルクラスの作成とその使用
オリジナルBeanの作成とその使用
Beanのスコープ

　第5回でも解説しましたが、JSPでのプログラムの再利用方法には、主に次のような方法があります。

インクルードディレクティブを使用した静的インクルード
インクルードアクションを使用した動的インクルード
オリジナルクラスの作成とその使用
オリジナルBeanの作成とその使用

　　第5回ではインクルードの手法を解説しました。今回は、上記の手法の後半にあたるオリジナルクラスとオリジナルBeanの作成と使用方法について説明します。クラスとBeanの作成は、一般的なJavaプログラムでも用いられる手法です。ここでは、これらのクラスとBeanを、どのようにしてJSPと連携させるのかを理解しましょう。

■オリジナルクラスの作成とその使用

　JSPプログラムおよびJavaプログラムでは、あらかじめ準備された豊富なAPIの便利な機能を使用して、複雑な処理も楽に実現させることができます。しかしながら、システムを開発していくうえで、独自の機能を持ったクラスが必要になることがあります。そのような場合にはオリジナルのクラスを作成し、それをJSPから使用することになります。繰り返し使用する機能はクラスにまとめてしまうことで、プログラムの有効な再利用を行うことができます。

　ここでは、具体例として著作権表示用のHTMLを生成するCopyrightHTMLクラスを作成し、それを使用する方法を説明します。

　まず、CopyrightHTMLクラスには、メンバ変数としてそれぞれ文字列型の、year（著作年）と、name（著作者の名前）、およびmail（メールアドレス）があるものとします。また、メソッドとして、標準的な著作権表示HTML文を取得するgetNormalHTML()と、短い著作権表示HTML文を取得するgetShortHTML()があるものとします。

　このCopyrightHTMLクラスのソースコードは次のようになります。なお、メールアドレスが指定されている場合には著作者名に自動でリンクする機能を付けています。

・CopyrightHTML.java

 1: 
            package atmarkit;

             2: 

             3: /**

             4:  * 著作権表示用のHTMLを生成するクラス

             5:  */

             6: public class CopyrightHTML {

             7: 

             8:     /** 著作年 */

             9:     public String year = "";

            10: 

            11:     /** 著作者 */

            12:     public String name = "";

            13: 

            14:     /** メールアドレス */

            15:     public String mail = "";

            16: 

            17:     /**

            18:      * 標準的な著作権表示HTML文を取得する

            19:      * @return 標準的な著作権表示HTML文

            20:      */

            21:     public String getNormalHTML() {

            22:         // メールアドレスが指定されている場合は著作者名にリンクをつける

            23:         if(!mail.equals("")) 
            {

            24:             
            name = " <a href=\"mailto:" + mail + "\">" + name + "</a>";

            25:         }

            26:         return "Copyright 
            " + year + " " + name + ". All rights reserved.";

            27:     }

            28: 

            29:     /**

            30:     * 短い著作権表示HTML文を取得する

            31:     * @return 短い著作権表示HTML文

            32:     */

            33:     public String getShortHTML() {

            34:         // メールアドレスが指定されている場合は著作者名にリンクをつける

            35:         if(!mail.equals("")) 
            {

            36:             
            name = " <a href=\"mailto:" + mail + "\">" + name + "</a>";

            37:         }

            38:         return "(C) " 
            + year + " " + name + ".";

            39:     }

            40: }

　一般的なJavaプログラミングとなんら変わりはないので、特に難しいところはないでしょう。JSPから使用できるようにするために、クラス自体と、各メンバ変数、メソッドの属性はpublicにしてあることに注意しましょう。

簡単なプログラムコードなのに、コメント文がおおげさに見えるかもしれません。しかし、このようなコメントを付けておくと、javadocコマンドによって次のようなHTML形式のAPIドキュメントを自動で生成することができます。後で仕様を確認するうえで、とても便利です。javadocに関する詳細はこちら（http://java.sun.com/j2se/javadoc/）を参照ください。

javadoc コマンドで生成したAPIドキュメントHTML

　さて、いままでのJSPのプログラミングでは明示的にコンパイルを行う必要はありませんでしたが、今回のCopyrightHTML.javaは純粋なJavaのプログラムなので、コンパイルが必要です。次のように入力してコンパイルしましょう。CopyrightHTML.classが生成されます。

% javac CopyrightHTML.java

javacコマンドは、J2SDKをインストールしたディレクトリのbin以下にあります。

　次に、コンパイルしてできたCopyrightHTML.classを、WEB-INF/classes/以下に配置します。この配置方法については、本連載第4回目で説明しています。今回は、1行目の、

1: package atmarkit;

の宣言によって、atmarkitパッケージに属するクラスとして定義しているので、次のようなディレクトリ構成になります。ディレクトリが存在しない場合は作成しましょう（$docBaseは、Context pathで指定したdocBaseのパスになります）。

$docBase/WEB-INF/classes/atmarkit/CopyrightHTML.class

　さて、これでオリジナルのクラスを使用する準備が整いました。さっそく、JSPからこのクラスを使用してみます。CopyrightHTML.classを使用したサンプルコードは次のとおりです。

 1: 
            <%@ page contentType="text/html; charset=euc-jp" import="atmarkit.CopyrightHTML" 
            %>

             2: <%

             3: // オリジナルクラスを使用する

             4: CopyrightHTML copyright = new CopyrightHTML();

             5: copyright.year = "2001";

             6: copyright.mail = "taro@java.server.pages";

             7: copyright.name = "JSP 太郎";

             8: 

             9: %>

            10: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

            11: <html>

            12: <head>

            13:     <title>オリジナルクラスを使用する</title>

            14: </head>

            15: <body>

            16: <p>-- オリジナルクラスを使用する --</p>

            17: <p>

            18: <hr>

            19: 標準的な著作権表示<br>

            20: <%= copyright.getNormalHTML() %>

            21: <hr>

            22: 短い著作権表示<br>

            23: <%= copyright.getShortHTML() %>

            24: <hr>

            25: </p>

            26: </body>

            27: </html>

　まず1行目で、今回作成したatmarkit.CopyrightHTMLクラスをインポートしています。その後、4行目でインスタンスを作成し、5～7行目でメンバ変数を設定しています。実際の著作権表示用のHTMLの取得は20行目と23行目で行っています。

　一度、オリジナルクラスの作成とその配置方法が分かれば、既存のAPIに準備されたクラスと同じようにして使用できます。

　上記のJSPプログラムを実行した結果は次のようになります。

実行結果

WEB-INF/classes/ 以下にクラスを配置することで、新しく作成したクラスはTomcatを再起動しなくても読み込むことができます。しかしながら、もともと存在しなかったWEB-INFディレクトリを新しく作成した場合など、うまくパスが認識されないことがあるようです。その際は、Tomcatを再起動してみましょう。

■オリジナルBeanの作成とその使用

　Beanとは、JavaBeansの仕様で定義された命名規則と設計規則に従って作成されたJavaクラスのことをいいます。

　詳細は、サン・マイクロシステムズのサイトのJavaBeansに関するドキュメント（http://java.sun.com/products/javabeans/docs/）を参照してください。

　詳細なドキュメントを読むと、とても難しい話をしている印象を受けますが、BeanであるクラスとBeanでないクラスの違いを一言でいってしまうと「Beanにはプロパティの値を設定するメソッドとプロパティの値を取得するメソッドの名前に決まり事がある」ということができます。基本的には、setとgetの後にプロパティ名を続けたメソッドを準備すればよいだけなので、まずはそれほど難しく考える必要はありません。これらのプロパティの値にアクセスするためのメソッドはアクセッサと呼ばれ、これらをきちんと定義することで、特定のクラスをBeanとして扱うことができるようになります。Beanは、うまく使用することで、開発効率を向上させたり、より信頼性の高いプログラミングを行うことができます。

　BeanはJavaクラスの1つなので、当然のことながらすでに述べたクラスファイルの扱いと同じ方法でもJSPから使用することができます。しかしながら、JSPにはBeanをより効率よく使用する仕組みが用意されています。ここではその使用方法について説明します。Bean の設計方法、および作成方法の詳細について説明すると、それだけで本が1冊書けてしまうので、ここでは省略します。本サイト内の連載記事「樋口研究室スマートなサーバ・サイドJava」内でのBeanの説明も参考にしてみてください。

　さてここでは、CopyrightHTMLクラスをBeanにしてみることにします。Beanのクラス名は、CopyrightHTMLBeanとします。プログラムコードは次のようになります。

・CopyrightHTMLBean.java

 1: 
            package atmarkit;

             2: 

             3: /**

             4:  * 著作権表示用のHTMLを生成するBean

             5:  */

             6: public class CopyrightHTMLBean {

             7: 

             8:     /** 著作年 */

             9:     private String year = "";

            10:     public void setYear(String year) { this.year 
            = year; }

            11: 

            12:     /** 著作者 */

            13:     private String name = "";

            14:     public void setName(String name) { this.name 
            = name; }

            15: 

            16:     /** メールアドレス */

            17:     private String mail = "";

            18:     public void setMail(String mail) { this.mail 
            = mail; }

            19: 

            20:     /**

            21:      * 標準的な著作権表示HTML文を取得する

            22:      * @return 標準的な著作権表示HTML文

            23:      */

            24:     public String getNormalHTML() {

            25:         // メールアドレスが指定されている場合は著作者名にリンクをつける

            26:         if(!mail.equals("")) 
            {

            27:             
            name = " <a href=\"mailto:" + mail + "\">" + name + "</a>";

            28:         }

            29:         return "Copyright 
            " + year + " " + name + ". All rights reserved.";

            30:     }

            31: 

            32:     /**

            33:      * 短い著作権表示HTML文を取得する

            34:      * @return 短い著作権表示HTML文

            35:      */

            36:     public String getShortHTML() {

            37:         // メールアドレスが指定されている場合は著作者名にリンクをつける

            38:         if(!mail.equals("")) 
            {

            39:             
            name = " <a href=\"mailto:" + mail + "\">" + name + "</a>";

            40:         }

            41:         return "(C) " 
            + year + " " + name + ".";

            42:     }

            43: }

　基本的な様子は、CopyrightHTML.javaとほとんど変わっていません。唯一変わったのは、前回はpublicだったメンバ変数がprivateになり、各変数を設定するためのメソッドset変数名メソッドが追加された点です。

　このような簡単な変更で、CopyrightHTMLクラスを、Beanとして定義し直すことができました。

　ここで作成したBeanのプログラムは、前回のクラスファイルと同じようにコンパイルし、また同じようにWEB-INF/classes/以下に配置します。

　それではさっそく、このBeanをJSPプログラムから使用してみましょう。プログラムコードは次のようになります。

 1: 
            <%@ page contentType="text/html; charset=euc-jp" %>

             2: <jsp:useBean id="copyright" class="atmarkit.CopyrightHTMLBean" 
            />

             3: <jsp:setProperty name="copyright" property="year" value="2001" 
            />

             4: <jsp:setProperty name="copyright" property="mail" value="taro@java.server.pages" 
            />

             5: <jsp:setProperty name="copyright" property="name" value="JSP 
            太郎" />

             6: <%

             7: // オリジナルBeanを使用する

             8: %>

             9: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

            10: <html>

            11: <head>

            12:     <title>オリジナルBeanを使用する</title>

            13: </head>

            14: <body>

            15: <p>-- オリジナルBeanを使用する --</p>

            16: <p>

            17: <hr>

            18: 標準的な著作権表示<br>

            19: <jsp:getProperty name="copyright" property="normalHTML" />

            20: <hr>

            21: 短い著作権表示<br>

            22: <jsp:getProperty name="copyright" property="shortHTML" />

            23: <hr>

            24: </p>

            25: </body>

            26: </html>

　コードをご覧になれば分かると思いますが、前回のものとはだいぶ様子が違います。<jsp:useBean> <jsp:setProperty> <jsp:getProperty> という新しいタグが出てきました。JSPでは、このようなBeanタグと呼ばれるタグを使用してBeanを使用します。それぞれのタグの使用方法は次のとおりです。

●<jsp:useBean>

　Beanの使用を宣言します。

<jsp:useBean id="copyright" 
            class="atmarkit.CopyrightHTMLBean" />

　例えば上のような記述では、atmarkit.CopyrightHTMLBeanクラスのBeanをcopyrightという名前で使用することを宣言しています。通常のプログラムにおける、

atmarkit.CopyrightHTMLBean 
            copyright = new atmarkit.CopyrightHTMLBean();

の記述と同じような意味を持ちます。

●<jsp:setProperty>

　Beanのプロパティの値を設定します。

<jsp:setProperty name="copyright" 
            property="year" value="2001" />

　例えば、上のような記述では、copyrightという名前で宣言されたBeanのyearというプロパティに2001という値を設定しています。具体的には、copyrightオブジェクトのsetYearメソッドが実行されるので、通常のプログラムにおける

copyright.setYear("2001");

の記述と同じ意味を持ちます。

●<jsp:getProperty>

　Beanのプロパティの値を取得します。

<jsp:getProperty name="copyright" 
            property="shortHTML" />

　例えば、上のような記述では、copyrightという名前で宣言されたBeanのshortHTMLというプロパティの値を取得しています。具体的には、copyrightオブジェクトのgetShortHTMLメソッドが実行されるので、通常のプログラムにおける、

copyright.getShortHTML();

の記述と同じ意味を持ちます。

　さて、上記の実行結果は、クラスを使用したときと同じように、次のようになります。予想どおり、CopyrightHTMLクラスを使用した例と結果はまったく同じですね。

実行結果

■Beanのスコープ

　上記の例では、ごく簡単なサンプルだったため、あまりBeanを使用することのメリットが感じられなかったかもしれません。しかし、Beanは使い方によってはとても有効に機能します。今回は、1ページの表示で完結するJSPプログラムだったので、特に意識しませんでしたが、Beanには、その有効範囲を指定できるscope属性があります。

　例えば、<jsp:useBean>タグを次のように記述することでscopeを指定できます。

<jsp:useBean id="id_name" 
            class="class_name" scope="scope" 
            />

　ここで指定できるscopeの値は、page、request、session、applicationの4通りのいずれかです（scope 属性を指定しなかった場合はデフォルトでpageが使用されます）。このscope属性は、一度宣言されたBeanにアクセスできる有効範囲を意味します。例えば、scopeにsessionを指定した場合、同じセッションの範囲においては、違うページであっても同じidの値を指定することで、同一のBeanにアクセスすることができます。このようにすることで、セッション間の各ページで1つのBeanを共有することができ、異なるページで同一の情報へアクセスできるようになります。

　それぞれのscopeを指定したときのBeanの特徴は次のようになります。scopeの指定によって、Beanをより有効に利用できるようになります。

scope の値	アクセス可能な範囲	特徴
page	現在のページのみ	デフォルトで使用されるスコープ。もっとも有効な期間が短い
request	現在のリクエストの範囲（インクルードされたページ、転送先のページを含む）	レスポンスがユーザーに返されるまでの間だけ有効（使用例：FORMで入力されたデータを保持させる）
session	現在のセッションの範囲	セッションと同じだけの有効期間を持つ（使用例：ログインしたユーザーの情報を保持させる）
application	現在のWebアプリケーション	アプリケーションの有効期間と同じだけ、永続的に使用できる（使用例：アクセスカウントなど、アプリケーション間で共有する情報を保持させる）

　
　今回は、オリジナルのクラスとオリジナルBeanを作成して使用する方法を解説しました。Beanの扱いについてはとても奥が深いので、今回述べられなかった大切な要素もたくさんあるのですが、まずはBeanの特徴と、JSPからの使用方法を理解してください。次回は、JSPでのセッションの扱いについて解説します。

Tomcatを使う「JSPプログラミング」バックナンバー

連載記事一覧

TechTargetジャパン

Java Solution フォーラム新着記事

EclipseでScalaプログラミングを始めるための基礎 （2012/2/10）
　概要や5つの特徴を紹介し、開発環境を構築して対話型実行環境「REPL」やEclipse上でHello Worldを実行します
並列分散処理の常識をHadoopファミリから学ぶ （2012/2/8）
　並列分散処理の課題やHadoopの長所／短所、そして短所を補うHadoop関連プロジェクトの構成や概要などを簡単に紹介
WebLogicサーバ最新版「12c」の気になる4つの特徴 （2012/1/31）
　久々にメジャーアップグレードしたJavaアプリケーションサーバについて、製品担当者に軽量インストーラなどの特徴を聞いた
GitHubをもっとソーシャルに使いこなすための7つ道具 （2012/1/23）
　ソースコードホスティングのGitHub周辺で便利な新サービスが続々登場しているので、まとめて紹介しよう。特に連動クラウド「fluxflex」が注目だ

＠ITメールマガジン　新着情報やスタッフのコラムがメールで届きます（無料）

RSSフィード

＠IT 新着記事

キャリアアップ

- PR -

＠IT Sepcial

＠IT Special ヘ

イベントカレンダー

PickUpイベント

- PR -

アクセスランキング

ニュース一覧へ

- PR -

お勧め求人情報

転職／派遣情報を探す

エンジニアの求人に復活の兆し！
【転職サーチ】SIerにWeb業界……
気になる求人情報をいますぐチェック！

派遣エンジニアにお役立ちの仕事情報
「派遣・フリーで働くメリット」とは？
活躍する派遣エンジニアの本音

エンジニアのキャリア実現を応援します

ITトレメ「ビジネス基礎」シリーズ開始
「マナー＆コミュニケーション編」「法律・知財・債権管理編」

＊先週の人気講座ランキング＊
～ Android編～

ホワイトペーパー（TechTargetジャパン）

＠IT Sepcial

＠IT Special ヘ

ソリューションFLASH

＠ITトップ｜Java Solutionフォーラムトップ｜会議室｜利用規約｜プライバシーポリシー｜サイトマップ

Copyright(c) 2000-2012 ITmedia Inc.
著作権はアイティメディア株式会社またはその記事の筆者に属します。（著作権について）
当サイトに掲載されている記事や画像などの無断転載を禁止します。
「＠IT」「＠IT自分戦略研究所」「＠IT情報マネジメント」「JOB＠IT」「＠ITハイブックス」「＠IT MONOist」「ITmedia」「誠」「BARKS」は、アイティメディア株式会社の登録商標です。
当サイトに関するお問い合わせは「＠ITへのお問い合わせ」をご覧ください。

Tomcatを使う「JSPプログラミング」 バックナンバー