4.4.7 環境プロパティを利用する場合

Interstage Application Server J2EE ユーザーズガイド

目次索引

4.4.7 環境プロパティを利用する場合

　環境プロパティとは、J2EEアプリケーションから任意に使用できる環境変数です。
　環境プロパティは、他のリソースやEJBと同様に、deployment descriptorファイル、またはWebアプリケーション環境定義ファイルに設定することで、JNDI SPを使用して参照することが可能です。

　環境プロパティの設定方法を以下に示します。

■環境プロパティの設定

　deployment descriptorファイル、またはWebアプリケーション環境定義ファイルに、環境プロパティの設定を行います。

　deployment descriptor、およびWebアプリケーション環境定義ファイルの編集は、ApworksのApdesignerのEJB Deployment Descriptorエディタ、または、コンポーネントデザイナのdeployment descriptorファイル編集（注：Plus Developerでは提供していません）を使用して行います。
　詳細については、Apworksの“Apdesigner プログラマーズガイド”または“コンポーネントデザイナユーザーズガイド”（注：Plus Developerでは提供していません）を参照してください。

　環境プロパティの、deployment descriptor、およびWebアプリケーション環境定義ファイルへの設定例を以下に示します。

【J2EEアプリケーションクライアントの場合】

　J2EEアプリケーションクライアントのdeployment descriptorファイルに、参照する環境プロパティを設定します。
　詳細については、“deployment descriptorファイルの詳細設定”を参照してください。

【設定例】
　設定例では“SValue”の参照設定を行っています。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE application-client PUBLIC "-//Sun Microsystems, Inc.//DTD J2EE Application Client 1.3//EN" "http://java.sun.com/dtd/application-client_1_3.dtd">
<application-client>
  …
  <env-entry>
    <description>EnvProp</description>
    <env-entry-name>SValue</env-entry-name>
    <env-entry-type>java.lang.Short</env-entry-type>
    <env-entry-value>1024</env-entry-value>
  </env-entry>
  …
</application-client>

【Webアプリケーションの場合】

　Webアプリケーション環境定義ファイル（web.xml）に、参照する環境プロパティを設定します。
　詳細については、“アプリケーション環境エントリ”を参照してください。

【設定例】
　設定例では“SValue”の参照設定を行っています。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
  …
  <env-entry>
    <description>EnvProp</description>
    <env-entry-name>SValue</env-entry-name>
    <env-entry-type>java.lang.Short</env-entry-type>
    <env-entry-value>1024</env-entry-value>
  </env-entry>
  …
</web-app>

【EJBアプリケーションの場合】

　deployment descriptor(ejb-jar.xml)に、参照する環境プロパティを設定します。
　詳細については、Apworksの“Apdesigner プログラマーズガイド”または“コンポーネントデザイナユーザーズガイド”（注：Plus Developerでは提供していません）を参照してください。

【設定例】
　設定例では“Session”の“SValue”の参照設定を行っています。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE ejb-jar PUBLIC "-//Sun Microsystems, Inc.//DTD EnterpriseJavaBeans 2.0//EN" "http://java.sun.com/dtd/ejb-jar_2_0.dtd">
<ejb-jar>
  <description>no description</description>
  <display-name>Ejb1</display-name>
  <enterprise-beans>
    <session>
    …
      <env-entry>
        <description>EnvProp</description>
        <env-entry-name>SValue</env-entry-name>
        <env-entry-type>java.lang.Short</env-entry-type>
        <env-entry-value>1024</env-entry-value>
      </env-entry>
    …
    </session>
  </enterprise-beans>
</ejb-jar>

目次索引