Cosminexus 機能解説

[目次][用語][索引][前へ][次へ]

9.8.2 JavaBeansリソースの実装

JavaBeansリソースの実装手順を,例を用いて説明します。

<この項の構成>
(1) インポート時の設定
(2) JavaBeansリソースの実装クラスの作成
(3) アプリケーションの設定
(4) アプリケーションの開始と終了

(1) インポート時の設定

サーバ管理コマンド(cjimportjbコマンド)でJavaBeansリソースをインポートするときに必要な設定と注意事項を示します。

(a) JavaBeansリソース属性ファイルの設定

JavaBeansリソース属性ファイルは,次に示す点に留意して作成してください。

JavaBeansリソース属性ファイルの設定例を示します。

<!DOCTYPE hitachi-javabeans-resource-property PUBLIC '-//Hitachi, Ltd.//DTD JavaBeans Resource Property 7.0//EN' 
'http://localhost/hitachi-javabeans-resource-property_7_0.dtd'>
 
<hitachi-javabeans-resource-property>
  <description></description>
  <display-name>JavaBean_resource</display-name>
    <class-name>com.mycompany.mypackage.MyJavaBean</class-name>
    <runtime>
      <property>
        <property-name>UserName</property-name>
        <property-type>java.lang.String</property-type>
        <property-value>Hitachi</property-value>
      </property>
      <property>
        <property-name>UserID</property-name>
        <property-type>java.lang.String</property-type>
        <property-value>01234567</property-value>
      </property>
    </runtime>
</hitachi-javabeans-resource-property>

JavaBeansリソース属性ファイルのテンプレートファイル(jb_template.xml)は,次のディレクトリに格納されています。

<Cosminexusのインストールディレクトリ>\CC\admin\templates
(b) -dオプションの使い方

インポート時に-dオプションを使用することで,アーカイブを作成しないで,ディレクトリ構成のままインポートできます。-dで指定するディレクトリは,インポートするディレクトリの最上位を指定します。

インポートするときの-dオプションの指定例を次に示します。この指定例では,パッケージ名がcom.mycompany.mypackageのMyJavaBeanクラスをインポートします。

-dで指定するディレクトリ\
  └ com\
     └ mycompany
        └ mypackage
             └ MyJavaBean.class

-dオプションは指定されたディレクトリ下に存在するものをすべてインポートするので,不要なファイルはディレクトリ内に含めないでください。

複数のJavaBeansリソースをインポートする場合の注意
インポート済みのJavaBeansリソースと同じ実装クラス名のJavaBeansリソースはインポートできません。先にインポートしたJavaBeansリソースを削除してからインポートするか,実装クラス名を変更し,作成し直してからインポートしてください。

(2) JavaBeansリソースの実装クラスの作成

JavaBeansで管理するデータ(プロパティ)を操作するメソッドを宣言します。データを登録する場合,setメソッド(set+プロパティ名)を設定します。データを参照する場合,getメソッド(get+プロパティ名)を設定します。

次に,JavaBeansリソースを登録,参照するクラスの実装例を示します。

package com.mycompany.mypackage;
public class MyJavaBean {
    private String username;
    private String userid;
 
    public void setUserName(String user_name) {
        this.username = user_name;
    }
    public void setUserID(String user_id) {
        this.userid = user_id;
    }
    public String getUserName() {
        return this.username;
    }
    public int getUserID() {
        return this.userid;
    }
}

(3) アプリケーションの設定

JavaBeansリソースを利用するときに,アプリケーション側で必要な実装および定義について説明します。

(a) lookupの実装(JavaBeansリソース)

JavaBeansリソースを,ルックアップまたはDIを使用して取得します。ここでは,"java:comp/env"形式でルックアップする方法を示します。

Context initCtx = new InitialContext();
MyJavaBean jb = (MyJavaBean) initCtx.lookup("java:comp/env/bean/myJB");

JavaBeansリソースをルックアップできる範囲は,ほかのリソース同様に,同じJ2EEサーバプロセス内のアプリケーションです。

(b) DDの定義内容(JavaBeansリソース)

ルックアップを使用してJavaBeansリソースを取得する場合,ルックアップする名前や実装クラス名の情報をDD(ejb-jar.xmlまたはweb.xml)に定義します。設定するタグを次に示します。

また,作成したアプリケーションをJ2EEサーバ上にデプロイするときに,ルックアップでの参照用の名称と実際の名称をlinked-toで結び付けます。この操作をするには,サーバ管理コマンド(cjsetapppropコマンド)を使用します。

次に,cjsetapppropで渡す属性ファイルの<resource-env-ref>タグの例を示します。

<resource-env-ref>
  <resource-env-ref-name>bean/myJB</resource-env-ref-name>
  <resource-env-ref-type>com.mycompany.mypackage.MyJavaBean</resource-env-ref-type>
  <linked-to>JavaBean_resource</linked-to>
</resource-env-ref>

(4) アプリケーションの開始と終了

JavaBeansリソースを利用するアプリケーションの開始,終了は,サーバ管理コマンドまたはManagement Serverで操作します。アプリケーションの開始,終了方法については,マニュアル「Cosminexus アプリケーション設定操作ガイド」を参照してください。

Cosminexusでは,JavaBeansリソースのサンプルプログラムを提供します。サンプルプログラムの概要および実行方法については,マニュアル「Cosminexus システム構築ガイド」のJavaBeansリソースのサンプルプログラムについての説明を参照してください。