ページの先頭行へ戻る
Interstage Application Server/Interstage Web Server Java EE運用ガイド
第4章 Java EEアプリケーションの開発 > 4.2 deployment descriptor > 4.2.3 Interstage deployment descriptor
前次

4.2.3 Interstage deployment descriptor

本製品は、各Java EE規約標準のdeployment descriptorファイルに加えて、本製品固有の定義ファイルを使用できます。この定義ファイルをInterstage deployment descriptorファイルと呼びます。Interstage deployment descriptorファイルの一覧を以下に示します。

ファイル名

説明

sun-application.xml

Java EEアプリケーション(EARファイル)の定義を指定できます。

sun-web.xml

Webアプリケーション(WARファイル)の定義を指定できます。

sun-ejb-jar.xml

EJBアプリケーション(EJB JARファイル)の定義を指定できます。

sun-cmp-mappings.xml

EJBアプリケーションのCMPの定義を指定できます。

sun-application-client.xml

Java EEアプリケーションクライアント(JARファイル)の定義を指定できます。

sun-acc.xml

アプリケーションクライアントコンテナの定義を指定できます。


各定義ファイルの定義内容について説明します。

4.2.3.1 Interstage application deployment descriptor (sun-application.xml)

記述形式

  <?xml version="1.0" encoding="UTF-8" ?>
  <!DOCTYPE sun-application PUBLIC
    "-//Sun Microsystems, Inc.//DTD Application Server 9.0 Java EE Application 5.0//EN"
    "http://www.sun.com/software/appserver/dtds/ sun-application_5_0-0.dtd ">
  <sun-application>
    <pass-by-reference>...</pass-by-reference>
    <unique-id>...</unique-id>
    <security-role-mapping>
      <role-name>...</role-name>
      <principal-name>...</principal-name>  または
      <group-name>...</group-name>
    </security-role-mapping>
  </sun-application>

タグの一覧

Interstage application deployment descriptorのタグ一覧を以下に示します。一覧の記載方法やタグの説明については、「4.2.3.7 Interstage deployment descriptorのタグの説明」を参照してください。

タグ名

概要

sun-application

deployment descriptorの開始と終了

  

pass-by-reference?

メソッド呼出し時の引数の受け渡し方法

unique-id?

システムID

security-role-mapping*

セキュリティロールの対応付け

  

role-name

deployment descriptorのセキュリティロール

principal-name+ (注)

ディレクトリサービスに定義されているユーザID

group-name+ (注)

ディレクトリサービスに定義されているグループ名

注) principal-nameまたはgroup-nameのどちらか、または両方で、1つ以上、複数の指定ができます。指定順序の制限もありません。

4.2.3.2 Interstage Web application deployment descriptor (sun-web.xml)

記述形式

  <?xml version="1.0" encoding="UTF-8" ?>
  <!DOCTYPE sun-web-app PUBLIC
    "-//Sun Microsystems, Inc.//DTD Application Server 9.0 Servlet 2.5//EN"
    "http://www.sun.com/software/appserver/dtds/sun-web-app_2_5-0.dtd">
  <sun-web-app>
    <security-role-mapping>
      <role-name>...</role-name>
      <principal-name>...</principal-name>  または
      <group-name>...</group-name>
    </security-role-mapping>
    <servlet>
      <servlet-name>...</servlet-name>
      <principal-name>...</principal-name>
    </servlet>
    <session-config>
      <session-properties>
        <property name="..." value="..."> (with attributes)
          <description>...</description>
        </property>
      </session-properties>
      <cookie-properties>
        <property name="..." value="..."> (with attributes)
          <description>...</description>
        </property>
      </cookie-properties>
    </session-config>
    <ejb-ref>
      <ejb-ref-name>...</ejb-ref-name>
      <jndi-name>...</jndi-name>
    </ejb-ref>
    <resource-ref>
      <res-ref-name>...</res-ref-name>
      <jndi-name>...</jndi-name>
      <default-resource-principal>
        <name>...</name>
        <password>...</password>
      </default-resource-principal>
    </resource-ref>
    <resource-env-ref>
      <resource-env-ref-name>...</resource-env-ref-name>
      <jndi-name>...</jndi-name>
    </resource-env-ref>
    <message-destination-ref>
      <message-destination-ref-name>...</message-destination-ref-name>
      <jndi-name>...</jndi-name>
    </message-destination-ref>
    <class-loader delegate="..."/>
    <jsp-config>
      <property name="..." value="..."> (with attributes)
        <description>...</description>
      </property>
    </jsp-config>
    <parameter-encoding default-charset="..."/>
    <property name="..." value="..."> (with attributes)
      <description>...</description>
    </property>
    <message-destination>
      <message-destination-name>...</message-destination-name>
      <jndi-name>...</jndi-name>
    </message-destination>
  </sun-web-app>

タグの一覧

Interstage Web application deployment descriptorのタグ一覧を以下に示します。一覧の記載方法やタグの説明については、「4.2.3.7 Interstage deployment descriptorのタグの説明」を参照してください。

タグ名

概要

sun-web-app

deployment descriptorの開始と終了

  

security-role-mapping*

セキュリティロールの対応付け

  

role-name

deployment descriptorのセキュリティロール

principal-name+ (注)

ディレクトリサービスに定義されているユーザID

group-name+ (注)

ディレクトリサービスに定義されているグループ名

servlet*

サーブレットまたはJSPの動作の定義

  

servlet-name

サーブレットまたはJSPの名前

principal-name?

セキュリティロールに対応するユーザ名

session-config?

Webアプリケーション内のセション制御の定義

  

session-properties?

Webアプリケーション内のセションを制御する共通の値

  

property*

プロパティ

  

description?

説明

cookie-properties?

Webアプリケーション内のクッキーを制御する共通の値

  

property*

プロパティ

  

description?

説明

ejb-ref*

参照名に対応するEJBアプリケーションのJNDI名

  

ejb-ref-name

EJBオブジェクトの参照名

jndi-name

EJBアプリケーションのJNDI名

resource-ref*

参照名に対応するリソースのJNDI名

  

res-ref-name

リソースの参照名

jndi-name

リソースのJNDI名

default-resource-principal?

デフォルトユーザの定義

  

name

ユーザ名

password

パスワード

resource-env-ref*

参照名に対応するJMSのJNDI名

  

resource-env-ref-name

JMSの参照名

jndi-name

JMSのJNDI名

message-destination-ref*

参照名に対応するJMS DestinationオブジェクトのJNDI名

  

message-destination-ref-name

JMS Destinationオブジェクトの参照名

jndi-name

JMS DestinationオブジェクトのJNDI名

class-loader?

クラスローダの定義

jsp-config?

JSPの定義

  

property*

プロパティ

  

description?

説明

parameter-encoding?

エンコーディング

property*

プロパティ

  

description?

説明

message-destination*

参照名に対応するJMS DestinationオブジェクトのJNDI名

  

message-destination-name

JMS Destinationオブジェクトの参照名

jndi-name

JMS DestinationオブジェクトのJNDI名

注) principal-nameまたはgroup-nameのどちらか、または両方で、1つ以上、複数の指定ができます。指定順序の制限もありません。

4.2.3.3 Interstage EJB application deployment descriptor (sun-ejb-jar.xml)

記述形式

  <?xml version="1.0" encoding="UTF-8" ?>
  <!DOCTYPE sun-ejb-jar PUBLIC
    "-//Sun Microsystems, Inc.//DTD Application Server 9.0 EJB 3.0//EN"
    "http://www.sun.com/software/appserver/dtds/sun-ejb-jar_3_0-0.dtd">
  <sun-ejb-jar>
    <security-role-mapping>
      <role-name>...</role-name>
      <principal-name>...</principal-name>  または
      <group-name>...</group-name>
    </security-role-mapping>
    <enterprise-beans>
      <unique-id>...</unique-id>
      <ejb>
        <ejb-name>...</ejb-name>
        <jndi-name>...</jndi-name>
        <ejb-ref>
          <ejb-ref-name>...</ejb-ref-name>
          <jndi-name>...</jndi-name>
        </ejb-ref>
        <resource-ref>
          <res-ref-name>...</res-ref-name>
          <jndi-name>...</jndi-name>
          <default-resource-principal>
            <name>...</name>
            <password>...</password>
          </default-resource-principal>
        </resource-ref>
        <resource-env-ref>
          <resource-env-ref-name>...</resource-env-ref-name>
          <jndi-name>...</jndi-name>
        </resource-env-ref>
        <message-destination-ref>
          <message-destination-ref-name>...</message-destination-ref-name>
          <jndi-name>...</jndi-name>
        </message-destination-ref>
        <pass-by-reference>...</pass-by-reference>
        <cmp>
          <one-one-finders>
            <finder>
              <method-name>...</method-name>
              <query-params>...</query-params>
              <query-filter>...</query-filter>
            </finder>
          </one-one-finders>
        </cmp>
        <principal>
          <name>...</name>
        </principal>
        <mdb-connection-factory>
          <jndi-name>...</jndi-name>
        </mdb-connection-factory>
        <jms-durable-subscription-name>...</jms-durable-subscription-name>
        <ior-security-config>
          <transport-config>
            <integrity>...</integrity>
            <confidentiality>...</confidentiality>
            <establish-trust-in-target>...</establish-trust-in-target>
            <establish-trust-in-client>...</establish-trust-in-client>
          </transport-config>
          <as-context>
            <auth-method>...</auth-method>
            <realm>...</realm>
            <required>...</required>
          </as-context>
          <sas-context>
            <caller-propagation>...</caller-propagation>
          </sas-context>
        </ior-security-config>
        <cmt-timeout-in-seconds>...</cmt-timeout-in-seconds>
        <use-thread-pool-id>...</use-thread-pool-id>
        <bean-pool>
          <steady-pool-size>...</steady-pool-size>
          <resize-quantity>...</resize-quantity>
          <max-pool-size>...</max-pool-size>
          <pool-idle-timeout-in-seconds>...</pool-idle-timeout-in-seconds>
        </bean-pool>
        <bean-cache>
          <max-cache-size>...</max-cache-size>
          <resize-quantity>...</resize-quantity>
          <cache-idle-timeout-in-seconds>...</cache-idle-timeout-in-seconds>
          <removal-timeout-in-seconds>...</removal-timeout-in-seconds>
          <victim-selection-policy>...</victim-selection-policy>
        </bean-cache>
        <mdb-resource-adapter>
          <resource-adapter-mid>...</resource-adapter-mid>
          <activation-config>
            <description>...</description>
            <activation-config-property>
              <activation-config-property-name>...</activation-config-property-name>
              <activation-config-property-value>...</activation-config-property-value>
            </activation-config-property>
          </activation-config>
        </mdb-resource-adapter>
        <webservice-endpoint>
          <port-component-name>...</port-component-name>
          <login-config>
            <auth-method>...</auth-method>
          </login-config>
        </webservice-endpoint>
      </ejb>
      <cmp-resource>
        <jndi-name>...</jndi-name>
        <default-resource-principal>
          <name>...</name>
          <password>...</password>
        </default-resource-principal>
      </cmp-resource>
      <message-destination>
        <message-destination-name>...</message-destination-name>
        <jndi-name>...</jndi-name>
      </message-destination>
    </enterprise-beans>
  </sun-ejb-jar>

タグの一覧

Interstage EJB application deployment descriptorのタグ一覧を以下に示します。一覧の記載方法やタグの説明については、「4.2.3.7 Interstage deployment descriptorのタグの説明」を参照してください。

タグ名

概要

sun-ejb-jar

deployment descriptorの開始と終了

  

security-role-mapping*

セキュリティロールの対応付け

  

role-name

deployment descriptorのセキュリティロール

principal-name+ (注)

ディレクトリサービスに定義されているユーザID

group-name+ (注)

ディレクトリサービスに定義されているグループ名

enterprise-beans

EJB JARファイルに定義したアプリケーションに関する定義

  

unique-id?

システムID

ejb*

EJBアプリケーションに関する定義

  

ejb-name

EJBアプリケーションのEnterprise Bean名

jndi-name?

EJBアプリケーション名、またはDestination名

ejb-ref*

参照名に対応するEJBアプリケーションのJNDI名

  

ejb-ref-name

EJBオブジェクトの参照名

jndi-name

EJBアプリケーションのJNDI名

resource-ref*

参照名に対応するリソースのJNDI名

  

res-ref-name

リソースの参照名

jndi-name

リソースのJNDI名

default-resource-principal?

デフォルトユーザの定義

  

name

ユーザ名

password

パスワード

resource-env-ref*

参照名に対応するJMSのJNDI名

  

resource-env-ref-name

JMSの参照名

jndi-name

JMSのJNDI名

message-destination-ref*

参照名に対応するJMS DestinationオブジェクトのJNDI名

  

message-destination-ref-name

JMS Destinationオブジェクトの参照名

jndi-name

JMS DestinationオブジェクトのJNDI名

pass-by-reference?

メソッド呼出し時の引数の受け渡し方法

cmp?

CMP Entity Beanアプリケーションに関する定義

  

one-one-finders?

EJB 1.1のCMPのEntity Beanに関する定義

  

finder+

finderメソッドごとのクエリの定義

  

method-name

finderメソッドと紐付けしたメソッド名

query-params?

入力パラメタの名前とタイプ

query-filter?

各オブジェクトに適用される条件

principal?

セキュリティロールに対応するユーザ名

  

name

ユーザ名

mdb-connection-factory?

Message-driven Beanに関連付けるConnectionFactory名

  

jndi-name

JNDI名

jms-durable-subscription-name?

サブスクライバの識別名

ior-security-config?

IIOP通信の認証、通信データの完全性、機密性

  

transport-config?

トランスポート層のセキュリティレベル

  

integrity

通信データの完全性

confidentiality

メッセージの機密性

establish-trust-in-target

クライアントからのEJBコンテナの認証の可否

establish-trust-in-client

EJBコンテナからのクライアントの認証の可否

as-context?

クライアントがEJBコンテナに渡す認証情報

  

auth-method

認証方法

realm

クライアント認証で使用するレルム

required

ユーザ名とパスワードの必要性

sas-context?

クライアントから伝播される識別情報

  

caller-propagation

クライアントから伝播される識別情報のサポート

cmt-timeout-in-seconds?

トランザクションタイムアウト値

use-thread-pool-id?

リモート呼出しに使用するスレッドのプール名

bean-pool?

プール定義

  

steady-pool-size?

Beanインスタンスの最小数

resize-quantity?

削減または増加するインスタンス数

max-pool-size?

インスタンスの最大数

pool-idle-timeout-in-seconds?

インスタンスの最大許容アイドルタイムアウト時間

bean-cache?

キャッシュ定義

  

max-cache-size?

キャッシュの最大値

resize-quantity?

キャッシュの変更量

cache-idle-timeout-in-seconds?

Beanインスタンスがキャッシュにいられる最大時間

removal-timeout-in-seconds?

無通信タイムアウト時間

victim-selection-policy?

Beanインスタンスを削除するために使用するポリシー

mdb-resource-adapter?

Message-driven Beanの受信対象種別定義

  

resource-adapter-mid

リソースアダプタ名

activation-config?

activationに関する定義

  

description?

説明

activation-config-property+

activation configurationプロパティ

  

activation-config-property-name

activation configurationプロパティ名

activation-config-property-value

activation configurationプロパティ値

webservice-endpoint?

Webサービス公開に関する定義

  

port-component-name

Webサービスの名前

login-config?

ユーザ認証の方法

  

auth-method

認証方法

realm?

認証で使用するレルム

cmp-resource?

CMP Entity Beanのデータベース情報

  

jndi-name

JDBCリソース名のJNDI名

default-resource-principal?

デフォルトユーザの定義

  

name

ユーザ名

password

パスワード

message-destination*

参照名に対応するJMS DestinationオブジェクトのJNDI名

  

message-destination-name

JMS Destinationオブジェクトの参照名

jndi-name

JMS DestinationオブジェクトのJNDI名

注) principal-nameまたはgroup-nameのどちらか、または両方で、1つ以上、複数の指定ができます。指定順序の制限もありません。

4.2.3.4 Interstage CMP Mappings deployment descriptor (sun-cmp-mappings.xml)

記述形式

  <?xml version="1.0" encoding="UTF-8" ?>
  <!DOCTYPE sun-cmp-mappings PUBLIC
  "-//Sun Microsystems, Inc.//DTD Sun Java Application Server 8.1 OR Mapping 1.2 //EN"
  "http://www.sun.com/software/sunone/appserver/dtds/sun-cmp-mapping_1_2.dtd">
  <sun-cmp-mappings>
    <sun-cmp-mapping>
      <schema>...</schema>
      <entity-mapping>
        <ejb-name>...</ejb-name>
        <table-name>...</table-name>
        <cmp-field-mapping>
          <field-name>...</field-name>
          <column-name>...</column-name>
        </cmp-field-mapping>
        <cmr-field-mapping>
          <cmr-field-name>...</cmr-field-name>
          <column-pair>
            <column-name>...</column-name>
            <column-name>...</column-name>
          </column-pair>
        </cmr-field-mapping>
      </entity-mapping>
    </sun-cmp-mapping>
  </sun-cmp-mappings>

タグの一覧

Interstage CMP Mappings deployment descriptorのタグ一覧を以下に示します。一覧の記載方法やタグの説明については、「4.2.3.7 Interstage deployment descriptorのタグの説明」を参照してください。

タグ名

概要

sun-cmp-mappings

deployment descriptorの開始と終了

  

sun-cmp-mapping+

CMP Entity Beanのマッピング情報

  

schema

データベースのスキーマ情報

entity-mapping+

データベースとCMP Entity Beanのマッピング

  

ejb-name

CMP Entity Beanと一致するEnterprise Bean名

table-name

データベースのテーブル名

cmp-field-mapping+

CMPフィールドの定義

  

field-name

CMPフィールド名

column-name+

テーブルのカラム名

cmr-field-mapping*

CMRフィールドの定義

  

cmr-field-name

CMRフィールド名

column-pair+

データベースカラム名の対応の定義

  

column-name

テーブルのカラム名

4.2.3.5 Interstage application client deployment descriptor (sun-application-client.xml)

記述形式

  <!DOCTYPE sun-application-client PUBLIC
    "-//Sun Microsystems, Inc.//DTD Application Server 9.0 Application Client 5.0//EN"
    "http://www.sun.com/software/appserver/dtds/sun-application-client_5_0-0.dtd">
  <sun-application-client>
    <ejb-ref>
      <ejb-ref-name>...</ejb-ref-name>
      <jndi-name>...</jndi-name>
    </ejb-ref>
    <resource-ref>
      <res-ref-name>...</res-ref-name>
      <jndi-name>...</jndi-name>
      <default-resource-principal>
        <name>...</name>
        <password>...</password>
      </default-resource-principal>
    </resource-ref>
    <resource-env-ref>
      <resource-env-ref-name>...</resource-env-ref-name>
      <jndi-name>...</jndi-name>
    </resource-env-ref>
    <message-destination>
      <message-destination-name>...</message-destination-name>
      <jndi-name>...</jndi-name>
    </message-destination>
    <message-destination-ref>
      <message-destination-ref-name>...</message-destination-ref-name>
      <jndi-name>...</jndi-name>
    </message-destination-ref>
  </sun-application-client>

タグの一覧

Interstage application client deployment descriptorのタグ一覧を以下に示します。一覧の記載方法やタグの説明については、「4.2.3.7 Interstage deployment descriptorのタグの説明」を参照してください。

タグ名

概要

sun-application-client

deployment descriptorの開始と終了

  

ejb-ref*

参照名に対応するEJBアプリケーションのJNDI名

  

ejb-ref-name

EJBオブジェクトの参照名

jndi-name

EJBアプリケーションのJNDI名

resource-ref*

参照名に対応するリソースのJNDI名

  

res-ref-name

リソースの参照名

jndi-name

リソースのJNDI名

default-resource-principal?

デフォルトユーザの定義

  

name

ユーザ名

password

パスワード

resource-env-ref*

参照名に対応するJMSのJNDI名

  

resource-env-ref-name

JMSの参照名

jndi-name

JMSのJNDI名

message-destination*

参照名に対応するJMS DestinationオブジェクトのJNDI名

  

message-destination-name

JMS Destinationオブジェクトの参照名

jndi-name

JMS DestinationオブジェクトのJNDI名

message-destination-ref*

参照名に対応するJMS DestinationオブジェクトのJNDI名

  

message-destination-ref-name

JMS Destinationオブジェクトの参照名

jndi-name

JMS DestinationオブジェクトのJNDI名

4.2.3.6 Interstage ACC deployment descriptor (sun-acc.xml)

記述形式

  <!DOCTYPE client-container PUBLIC
    "-//Sun Microsystems Inc.//DTD Application Server 8.0 Application Client Container//EN"
    "http://www.sun.com/software/appserver/dtds/sun-application-client-container_1_2.dtd">
  <client-container>
    <target-server name="..." address="..." port="..."/>
    <log-service>
      <property name="..." value="..."/>
    </log-service>
    <property name="..." value="..."/>
  </client-container>

タグの一覧

Interstage ACC deployment descriptorのタグ一覧を以下に示します。一覧の記載方法やタグの説明については、「4.2.3.7 Interstage deployment descriptorのタグの説明」を参照してください。

タグ名

概要

client-container

deployment descriptorの開始と終了

  

target-server+

アクセスするサーバのIIOPリスナーの定義

log-service?

ログファイル

  

property (with attributes)*

プロパティ

property (with attributes)*

プロパティ


注意

sun-acc.xmlでは、以下の2つのプロパティのみサポートします。

プロパティ名

指定可能値

com.sun.appserv.iiop.loadbalancingpolicy

ic-based

com.sun.appserv.iiop.endpoints

(IPアドレス):(ポート),……

4.2.3.7 Interstage deployment descriptorのタグの説明

タグの一覧

各Interstage deployment descriptorのタグ一覧の見方と注意事項を説明します。

タグ一覧の見方

タグ一覧に記載されている記号の意味を以下に示します。

記号

意味

?

タグを定義しなくて良い。または1つだけタグを定義することができる。

*

タグを定義しなくて良い。または複数のタグを定義することができる。

+

タグを1つ以上記述する必要がある。

注意事項

Interstage deployment descriptorの注意事項を以下に示します。

タグの説明

bean-cache (親タグ:ejb)

Stateful Session BeanとEntity Beanのキャッシュ定義です。
EJBコンテナのキャッシュ定義を上書きしBeanごとに指定できます。不当な値を指定した場合の動作は保証しません(注)。各定義値の設定可能な範囲および項目間の大小関係はEJBコンテナのEnterprise Beanインスタンスのキャッシング定義と同等ですので、「9.8.8 EJBコンテナの定義項目」を参照してください。
キャッシュ機能については、「7.7.2 Enterprise Beanインスタンスのキャッシング」を参照してください。

<max-cache-size>
キャッシュされたBeanインスタンスをpassivate対象とするか判断する数です。
デフォルト値は512です。0を設定した場合はキャッシュサイズが無制限になります。

<resize-quantity>
Beanインスタンスをpassivateする場合、この数のインスタンスをpassivateしてキャッシュから破棄します。
変更量はキャッシュサイズの最大値による制限を受けます。デフォルト値は32です。

<cache-idle-timeout-in-seconds>
キャッシュされたBeanインスタンスをpassivate対象とするかを判定する監視時間(秒単位)です。指定した時間間隔でキャッシュを監視し、指定した時間以上アイドル状態が続いているBeanインスタンスをpassivate対象とします。passivate対象のインスタンス数が8を超えるとBeanインスタンスをファイルシステムにpassivateします。0を設定した場合はキャッシュアイドルタイムアウトが動作しません。
デフォルト値は600秒(10分)です。

<removal-timeout-in-seconds>
passivateしたBeanインスタンスがファイルシステムに存在できる最大時間(秒単位)です。Beanインスタンスに対して、この時間を超過してもビジネスメソッドが実行されなかった場合、EJBコンテナが該当のインスタンスの対話状態をファイルシステムから削除します。キャッシュアイドルタイムアウト以下の値を指定すると、Beanインスタンスをpassivateした後に削除します。0を設定した場合は削除タイムアウトが動作しません。
デフォルト値は5400秒(90分)です。

<victim-selection-policy>
設定されたポリシーに基づいて、コンテナは削除するStateful Session Beanを決定します。コンテナがキャッシュからBeanインスタンスを削除するために使用するポリシーを以下の値で指定します。

  • NRU : 最近使用されていない

  • FIFO: ファーストインファーストアウト

  • LRU : 最近の使用頻度がもっとも低い

NRUポリシー(Not Recently Used)は、キャッシュ内で古い、かつ最近アクセスされていないBeanインスタンスを優先的に削除します。FIFOポリシー(First In, First Out)は、キャッシュ内で最も古いBeanを削除します。LRUポリシー(Least Recently Used)は、最近最もアクセスされていないBeanを削除します。
デフォルト値はNRUです。
Entity Beanの場合は常にFIFOポリシーを使って削除されます。


注意

不当な値を指定した場合、以下のように動作します。

  • マイナスの値を入力した場合

    • -1を入力した場合は、EJBコンテナのキャッシュ定義の値が有効となる。

    • -1以外が指定された場合には0が指定された場合と同様に動作する。

  • resize-quantityにmax-cache-sizeより大きい値を指定した場合

    • 想定外のタイミングでインスタンスをpassivateする。

  • 文字列を入力するなど、上記以外の不当な値を指定した場合

    • 指定した値は無効となり、EJBコンテナのキャッシュ定義の値が有効となる。

bean-pool (親タグ:ejb)

Stateless Session Bean、Message-driven BeanとEntity Beanのプール定義です。
EJBコンテナのプール定義を上書きしBeanごとに指定する場合、以下の定義を使用できます。不当な値を指定した場合の動作は保証しません(注)。各定義値の設定可能な範囲および項目間の大小関係はEJBコンテナのEnterprise Beanインスタンスのプーリング定義と同等ですので、「9.8.8 EJBコンテナの定義項目」または「9.8.9 Message-driven Beanデフォルトプールの定義項目」を参照してください。
プーリング機能については、「7.7.3 Enterprise Beanインスタンスのプーリング」を参照してください。

<steady-pool-size>
EJBアプリケーションへのアクセス時、またはアイドルタイムアウト監視処理時に生成するBeanインスタンス数です。
処理要求によりプールに存在するインスタンス数が指定した値より小さくなると、EJBコンテナはプールされたBeanインスタンスが指定された値以上になるまでBeanインスタンスをプールサイズの変更量単位に生成してプールに追加します。
デフォルト値は0です。

<resize-quantity>
コンテナがプール内のインスタンスの数を調整する場合、一度に破棄または追加するインスタンスの数を指定します。
0～MAX_INTEGERの範囲(Message-driven Beanの場合は1～MAX_INTEGERの範囲)で指定できますが、プールサイズの最小値と最大値による制限を受けます。
0を設定した場合、またはプールサイズの最小値に0を指定した場合は適用されません。適用されない場合は1インスタンスずつ生成します。
デフォルト値は8です。
Message-driven Beanでは0を設定した場合、デフォルト値が設定されます。

<max-pool-size>
プール内に保持するインスタンスの最大数を指定します。0～MAX_INTEGERの範囲(Message-driven Beanの場合は1～MAX_INTEGER)で指定します。
デフォルト値は32です。
0を設定した場合はプールサイズが無制限になりますが、Message-driven Beanの場合はデフォルト値が設定されます。

<pool-idle-timeout-in-seconds>
プールにあるインスタンスの最大許容アイドル時間を指定します。EJBコンテナは設定値の間隔でプールを監視し、この設定値を超過したアイドル状態のBeanインスタンスをプールから除去します。プールサイズが最小プールサイズ未満の場合は、プールサイズの変更量に従いインスタンスを追加します。
デフォルト値は600秒(10分)です。
0を設定した場合は監視しませんが、Message-driven Beanの場合はデフォルト値が設定されます。


注意

不当な値を指定した場合、以下のように動作します。

  • マイナスの値を入力した場合

    • -1を入力した場合は、EJBコンテナのプール定義の値が有効となる。

    • -1以外が指定された場合には0が指定された場合と同様に動作する。

  • 文字列を入力するなど、上記以外の不当な値を指定した場合

    • 指定した値は無効となり、EJBコンテナのプール定義の値が有効となる。

class-loader (親タグ: sun-web-app)

Webアプリケーションをロードするクラスローダを制御する共通の値を定義します。
指定可能な属性名を以下に示します。

属性名

省略値

意味

delegate

true

Webクラスローダの委譲モデルを指定します。Webクラスローダの委譲モデルについては、「3.19.3 Webクラスローダの委譲モデルの変更」を参照してください。

  • true :親クラスローダへの委譲を先に行います。

  • false:親クラスローダへの委譲を後に行います。

client-container

Interstage ACC deployment descriptorの開始と終了を定義します。

cmp (親タグ: ejb)

CMP Entity Beanアプリケーションに関する定義です。

<one-one-finders>
EJB 1.1のCMPのEntity Beanに関する定義です。

<finder>
EJB 1.1のCMP Entity Beanのfinderメソッドごとにクエリを定義します。
定義の詳細については、「D.1.3 EJB 1.1のCMP Entity Beanのfinderメソッドの検索条件定義の指定」を参照してください。

<method-name>
Homeインタフェースに定義したfinderメソッドと紐付けしたメソッド名を指定します。

<query-params>
クエリの1つまたは複数の入力パラメタの名前とタイプを指定します。Java言語のパラメタの構文で記述します。

<query-filter>
クエリによって返される各オブジェクトに適用される条件を指定します。WHERE句に対応します。

cmp-field-mapping (親タグ:entity-mapping)

CMPフィールドを指定します。ejb-jar.xmlファイルに定義されているcmp-fieldごとに1つの<cmp-field-mapping>タグを定義してください。

<field-name>
ejb-jar.xmlファイルに定義されているCMPフィールド(<field-name>)と一致するCMPフィールド名を指定します。

<column-name>
CMPフィールドと対応付けるテーブルのカラム名を指定します。

cmp-resource (親タグ:enterprise-beans)

EJB application deployment descriptor (ejb-jar.xml)に定義したCMP Entity Beanのデータベース情報を定義します。

<jndi-name>
JDBCリソース名のJNDI名を指定します。

cmr-field-mapping (親タグ:entity-mapping)

互いに参照を持つEJBアプリケーションのリレーションのCMRフィールドを定義します。EJB 1.1のCMP Entity Beanの場合は省略します。
ejb-jar.xmlファイルに定義されているcmr-fieldごとに1つのcmr-field-mappingを定義してください。
Entity Bean間のリレーションシップはテーブルのカラムが他のテーブルのカラムの値と同じになっていることで成り立っています。多:多のリレーションの場合にはJoinテーブルを使用します。1:1、1:多と多:1の場合にもJoinテーブルを使用できますが、通常は外部キーカラムを使用します。
Joinテーブルは、リレーションのある両方のEntity Beanのプライマリキーを格納するためのカラムを持っています。各Entity Beanオブジェクトのリレーションに対してJoinテーブルに行があります。Entity Beanオブジェクトのリレーションをたどると、この行から他のEntity Beanのプライマリキーが取得されます。リレーションを作成/更新/削除するとEJBコンテナが行を追加/削除します。Joinテーブルを使用した場合、両方のEntity Beanの各プライマリキーカラムに対して<column-pair>を定義してください。

以下にEntity Bean間の多:多のリレーション(単方向)のJoinテーブルマッピング例を示します。
双方向のリレーションの場合は、その他のEntity Beanの<cmr-field-mapping>にも同じ<column-pair>を定義してください。

  <cmr-field-mapping>
      <cmr-field-name>meetings</cmr-field-name>
      <column-pair>
          <column-name>EMPLOYEEMEETING.EMPLOYEE_ID</column-name>
          <column-name>EMPLOYEEMEETING.MEETING_NO</column-name>
      </column-pair>
  </cmr-field-mapping>

外部キーカラムは、Entity Beanにマッピングしたテーブルに、その他のEntity Beanのプライマリキーを格納するために追加したカラムです。Entity Bean間にリレーションを作成すると、EJBコンテナはEntity Beanオブジェクトに対応する行の外部キーカラムに、他Entity Beanのプライマリキーを格納します。リレーションを削除すると、NULLを格納します。
外部キーカラムを使用した場合、各プライマリキーカラムに対して<column-pair>を定義してください。

以下にEntity Bean間の1:多のリレーション(双方向)の外部キーカラムマッピング例を示します。

  <entity-mapping>
      <ejb-name>Customer</ejb-name>
      <table-name>CUSTOMER</table-name>
      <cmp-field-mapping>
          <field-name>id</field-name>
          <column-name>ID</column-name>
      </cmp-field-mapping>
      <cmp-field-mapping>
          <field-name>name</field-name>
          <column-name>NAME</column-name>
      </cmp-field-mapping>
      <cmr-field-mapping>
          <cmr-field-name>cards</cmr-field-name>
          <column-pair>
              <column-name>CUSTOMER.ID</column-name>
              <column-name>CREDITCARD.CUSTOMER_ID</column-name>
          </column-pair>
      </cmr-field-mapping>
  </entity-mapping>
  <entity-mapping>
      <ejb-name>Creditcard</ejb-name>
      <table-name>CREDITCARD</table-name>
      <cmp-field-mapping>
          <field-name>number</field-name>
          <column-name>NO</column-name>
      </cmp-field-mapping>
      <cmp-field-mapping>
          <field-name>name</field-name>
          <column-name>NAME</column-name>
      </cmp-field-mapping>
      <cmp-field-mapping>
          <field-name>expires</field-name>
          <column-name>EXPIRES</column-name>
      </cmp-field-mapping>
      <cmr-field-mapping>
          <cmr-field-name>cardholder</cmr-field-name>
          <column-pair>
              <column-name>CUSTOMER.ID</column-name>
              <column-name>CREDITCARD.CUSTOMER_ID</column-name>
          </column-pair>
      </cmr-field-mapping>
  </entity-mapping>

<cmr-field-name>
ejb-jar.xmlファイルに定義されているCMRフィールド(<cmr-field-name>)と一致するCMRフィールド名を指定します。

<column-pair>
連携するデータベースカラム名を対で指定します。
<cmp-field-mapping>に定義したEntity Beanのプライマリキーカラムと、同じ値となるJoinテーブルカラムまたは他テーブルの外部キーカラムを指定してください。

<column-name>
テーブルのカラム名を指定します。
<table-name>に指定したテーブルと違うテーブルのカラムを定義する場合、「テーブル名.カラム名」のように、テーブル名とカラム名をピリオドで区切って指定してください。

cmt-timeout-in-seconds (親タグ:ejb)

トランザクション制御をコンテナが行う場合、トランザクションタイムアウト値を秒で指定します。
省略または0に指定するとトランザクションサービスで設定したタイムアウト値が使用されます。
トランザクションのタイムアウトが発生した場合、IJServerクラスタはトランザクションの状態を「MarkedRollback」に変更します(注)。MarkedRollbackに変更されたトランザクションは、EJBアプリケーションのメソッド処理完了時に、自動的にロールバックされます。
注) トランザクションの状態については、「3.12.6 トランザクションの監視と凍結機能」を参照してください。

Webアプリケーション内のセションの追跡に使用するcookieを制御する共通の値を<property>タグを使用して定義します。
指定可能なプロパティを以下に示します。

プロパティ名

省略値

意味

cookieSecure

dynamic

セションの追跡に使用するcookieにSecure属性を常に付加するかどうかを指定します。
SSLアクセラレータを使用する場合には、セションの追跡に使用するcookieにSecure属性は自動的に付加されませんが、本機能を有効にすることにより、Secure属性を常に付加することが可能です。

  • true : 常に付加する

  • dynamic : スキーマに依存
    httpの場合は付加しない
    httpsの場合は付加する

注) 上記以外の設定を行った場合、WEB0123が出力されてアプリケーションの実行に失敗するかまたは、常に付加されなくなります。

cookieMaxAgeSeconds

-1

Webブラウザ上でセッションを保存する際の有効期限を秒単位で設定します。

  • 1～2147483647:Webブラウザ上でセッションを保存する際の有効期限となります。「Webブラウザでセッションを保存する」の注意点を参照し、運用環境に合わせて適切な値を設定してください。

  • 0:cookieによるセッションの追跡が無効となります。

  • 上記以外:Webブラウザ上でセッションを保存しません。


default-resource-principal (親タグ:resource-ref、cmp-resource)

親タグで定義したリソースを使用することができるデフォルトのユーザを定義します。

<name>
JDBCリソースやJMSを使用する際の、デフォルトのユーザ名を定義します。

<password>
<name>タグで定義したデフォルトのユーザが使用するパスワードを定義します。

注意

本定義はサーバ上にテキストファイルで保管されますので、JDBCリソースやJMSのリソース定義にパスワードエイリアスを定義することを推奨します。

ejb (親タグ:enterprise-beans)

EJBアプリケーションに関する定義です。

<ejb-name>
EJB application deployment descriptor (ejb-jar.xml)またはアノテーションで宣言されたEJBアプリケーションと紐付けしたEJBアプリケーションのEnterprise Bean名を指定します。

<jndi-name>

  • Remote BusinessインタフェースまたはRemoteインタフェースを定義したSessionとEntity Beanの場合:
    JNDIに登録するEJBアプリケーション名を指定します。
    このタグを省略した場合、以下の順番でEJBアプリケーション名が決定されます。

    1. ejb-jar.xmlの<mapped-name>に定義された値

    2. EJBアプリケーションのJavaソースに定義された@Statelessまたは@StatefulのmappedName属性に定義された値

  • JMSからメッセージを受信するMessage-driven Beanの場合:
    使用するDestination名を指定します。

  • その他の場合:
    本定義が無視されます。

ejb-name (親タグ:entity-mapping)

ejb-jar.xmlファイルに定義されているCMP Entity Beanと一致するEnterprise Bean名を指定します。

ejb-ref (親タグ:sun-web-app、ejb、sun-application-client)

Java EE deployment descriptorの<ejb-ref>タグ、または@EJB、@EJBsのアノテーションで定義した参照名に対応するEJBアプリケーションのJNDI名(運用環境の実名)を指定します。

<ejb-ref-name>
EJBオブジェクトの参照名を定義します。
ここで指定する参照名はJava EE deployment descriptorの<ejb-ref-name>タグで定義した参照名を使用してください。

<jndi-name>
実際の運用環境におけるEJBアプリケーションのJNDI名を定義します。

参照

定義方法については、「3.11 JNDI」を参照してください。

enterprise-beans (親タグ:sun-ejb-jar)

EJB JARファイルに定義したアプリケーションに関する定義です。

entity-mapping (親タグ:sun-cmp-mapping)

データベースカラムとCMP Entity Beanのマッピングを定義します。

ior-security-config (親タグ:ejb)

Enterprise JavaBeanに対するIIOP通信の認証、通信データの完全性、機密性を設定します。

<transport-config>
トランスポート層のセキュリティレベルを指定します。
いずれかの1つでも"REQUIRED"が指定された場合は、SSLまたはTLSで通信を行います。

<integrity>
通信データの完全性を設定します。
通信データが改ざんされる恐れがある場合はREQUIREDを指定してください。

  • NONE:
    EJBコンテナは通信データの完全性をサポートしません。

  • SUPPORTED:
    EJBコンテナは通信データの完全性をサポートします。

  • REQUIRED:
    EJBコンテナは通信データの完全性をクライアントに要求します。

<confidentiality>
メッセージの機密性を設定します。
通信データが盗聴される恐れがある場合はREQUIREDを指定してください。

  • NONE:
    EJBコンテナは通信データの機密性をサポートしません。

  • SUPPORTED:
    EJBコンテナは通信データの機密性をサポートします。

  • REQUIRED:
    EJBコンテナは通信データの機密性をクライアントに要求します。

<establish-trust-in-target>
EJBコンテナがクライアントから認証可能かを設定します。

  • NONE:
    クライアントはEJBコンテナを認証できません。

  • SUPPORTED:
    クライアントはEJBコンテナを認証することが可能です。

<establish-trust-in-client>
EJBコンテナがクライアントを認証するかを設定します。

  • NONE:
    EJBコンテナはクライアントを認証しません。

  • SUPPORTED:
    EJBコンテナはクライアントを認証することが可能です。

  • REQUIRED:
    EJBコンテナはクライアントの認証を要求します。クライアントはクライアント証明書が必要です。

<as-context>
クライアントがEJBコンテナに渡す認証情報を指定します。

<auth-method>
認証方法を指定します。
IIOP通信の場合、USERNAME_PASSWORDを指定してください。

<realm>
クライアント認証で使用するレルムを指定します。defaultを指定してください。
Interstageディレクトリサービスのレルムになります。

<required>
クライアント側でユーザ名とパスワードを提供する必要があるかどうか指定します。
trueかfalseを指定してください。trueを指定すると、BeanはEJBクライアントに対してユーザ名とパスワードの指定を要求します。

<sas-context>
クライアントから伝播される識別情報について設定します。

<caller-propagation>
クライアントからの識別情報の伝播をサポートするかを指定します。

  • NONE:
    クライアントから伝播される識別情報をサポートしません。

  • SUPPORTED:
    クライアントは識別情報を伝播することが可能です。

jms-durable-subscription-name (親タグ:ejb)

EJB 2.1以降のEJBアプリケーションの場合、EJB application deployment descriptor (ejb-jar.xml)のactivation-configタグまたは@ActivationConfigPropertyのアノテーションでサブスクライバの識別名を定義します。以下の順番でサブスクライバの識別名が決定されます。

  1. EJB application deployment descriptor (ejb-jar.xml)のactivation-configタグで定義したサブスクライバの識別名

  2. @ActivationConfigPropertyのアノテーションで定義したサブスクライバの識別名

  3. 本タグで定義したサブスクライバの識別名

jsp-config (親タグ: sun-web-app)

Webアプリケーション内のJSPを制御する共通の値を<property>タグを使用して定義します。
指定可能なプロパティを以下に示します。

プロパティ名

省略値

意味

enablePooling

true

タグプーリングを使用するかどうかを指定します。

  • true : 使用します。

  • false: 使用しません。

ignoreJspFragmentErrors

false

JSPを事前コンパイルする時に静的includeするJSPファイルのエラーを無視するかどうかを指定します。

  • true : 無視します。

  • false: 無視しません。

JSP事前コンパイルに対してだけ有効です。構成チェック(配備モジュールの検証)には有効となりません。

keepgenerated

true (注1)

JSPコンパイル時にJavaソースコードを生成するかどうかを指定します。 (注2)

  • true : 生成します。

  • false: 生成しません。

development

false

リクエスト時にJSPのオートリロードを行うかどうかを指定します。

  • true : オートリロードを行う。

  • false: オートリロードを行わない。

checkInterval

0

JSPのオートリロードを行う間隔(秒)を指定します。developmentにfalseが設定されており、0より大きい値を指定した場合にオートリロードが有効になります。

有効範囲: 1～2147483647

scratchdir

(注3)

JSPのコンパイル結果を格納するディレクトリを絶対パスで指定します。(注4)
JSP事前コンパイル時にはこの定義は有効となりません。省略値で動作します。

usePrecompiled

false

Webアプリケーション内にあるJSP事前コンパイル結果を使用してJSPを実行するか指定します。

  • true : 使用します

    • JSP事前コンパイル結果はパッケージ構成ごとWEB-INF/classes、またはWEB-INF/lib(JARファイルとして管理している場合)に格納してください。

    • JSP事前コンパイル結果がない場合、メッセージPWC6034を出力してJSPの実行に失敗します。

    • JSPのオートリロード機能は設定にかかわらず無効になります。

  • false : 使用しません

注1) Java Development Kit 5.0の場合はtrue、Java Development Kit 6.0の場合はfalse。
注2) keepgeneratedはJSP実行時のコンパイルに対して有効になります。配備時にコンパイルを使用した場合、keepgeneratedの設定にかかわらず、必ずJavaソースコードを生成します。
注3) 「3.4.2 IJServerクラスタのファイル構成」の「JSPコンパイル結果格納ディレクトリ」を参照してください。
注4) Webアプリケーションの配備解除を行っても、scratchdirで指定したディレクトリ内にあるJSPコンパイル結果は削除されません。JSPコンパイル結果が必要ない場合には、手動で削除してください。

注意

scratchdirでJSPコンパイル結果格納ディレクトリを指定する場合のパスの長さは以下を目安にしてください。

指定可能なパスの長さ =
  最大パス長(255バイト) -
  パッケージパス(org\apache\jsp\ : 15バイト) -
  Webアプリケーション内のJSP格納ディレクトリパス(ユーザ任意) -
  JSPコンパイル結果(JSPファイル名_jsp.class)

指定可能なパスの長さ =
  最大パス長(1023バイト) -
  パッケージパス(org/apache/jsp/ : 15バイト) -
  Webアプリケーション内のJSP格納ディレクトリパス(ユーザ任意) -
  JSPコンパイル結果(JSPファイル名_jsp.class)

例

以下の構成でJSPが格納されている場合に指定可能なパスの長さを説明します。

sample.war

  

/jsp

  

/sample.jsp

/WEB-INF

指定可能なパスの長さ =
  最大パス長(255バイト) -
  パッケージパス(org\apache\jsp\ : 15バイト) -
  Webアプリケーション内のJSP格納ディレクトリパス(\jsp : 4バイト) -
  JSPコンパイル結果(\sample_jsp.class : 17バイト) = 219バイト

指定可能なパスの長さ =
  最大パス長(1023バイト) -
  パッケージパス(org/apache/jsp/ : 15バイト) -
  Webアプリケーション内のJSP格納ディレクトリパス(/jsp : 4バイト) -
  JSPコンパイル結果(/sample_jsp.class : 17バイト) = 987バイト

log-service (親タグ:client-container)

ログの出力レベルを指定します。
指定可能な属性を以下に示します。

属性名

省略値

意味

level

INFO

ログの出力レベルを指定します。

  • INFO: 情報メッセージ、警告メッセージ、エラーメッセージを出力します。 (注1)

  • WARNING: 警告メッセージ、エラーメッセージを出力します。 (注2)

  • SEVERE: エラーメッセージを出力します。

注1) トラブル調査用にログを採取する場合はINFOレベルを指定してください。
注2) -xmlオプションを指定しない場合に使用されるデフォルトのsun-acc.xmlファイルにはWARNINGを指定しています。

mdb-connection-factory (親タグ:ejb)

JMSからメッセージを受信するMessage-driven Beanに関連付けるConnectionFactory名(運用環境の実名)を指定します。

<jndi-name>
JNDI名(絶対名)を指定します。

注意

本タグ配下には<default-resource-principal>タグが記述可能ですが、利用できません。
Message-driven Bean単位にConnectionFactoryの認証情報を定義する場合、ejb-jar.xmlの<activation-config-property>に定義してください。詳細は、「6.7.3 アプリケーションからJMSを利用する際の認証方法」を参照してください。

mdb-resource-adapter (親タグ:ejb)

Message-driven Beanの受信対象種別定義です。

<resource-adapter-mid>
Message-driven Beanがリソースアダプタからメッセージを受信する場合は、リソースアダプタ名を指定します。
JMSからメッセージを受信する場合は、「jmsra」を指定してください。または、<mdb-resource-adapter>定義を省略してください。

<activation-config>
activationに関する設定です。

<description>
activation configurationの説明文です。

<activation-config-property>
activation configurationプロパティを指定します。

<activation-config-property-name>
activation configurationプロパティ名を指定します。

<activation-config-property-value>
activation configurationプロパティ値を指定します。

webservice-endpoint (親タグ:ejb)

Stateless Session BeanをWebサービスのエンドポイントとして公開する場合の設定を定義します。

<port-component-name>
Webサービスの名前を記載します。javax.jws.WebServiceアノテーションのname属性などで指定した名前を記載します。特に指定していない場合、ejb実装クラスのクラス名を記載します。

<login-config>
クライアントを認証する場合に、認証の方法を定義します。

<auth-method>
認証方法を定義します。以下の値がサポートされます。

  • BASIC : HTTP Basic認証

<realm-name>
認証で使用するレルム名を定義します。省略した場合は、デフォルトレルムが選択されます。

message-destination (親タグ: sun-web-app、enterprise-beans、sun-application-client)

Java EE deployment descriptorの<message-destination>タグ、または@Resource、@Resourcesで定義した参照名に対応する実際の運用環境におけるJMS DestinationオブジェクトのJNDI名を定義します。

<message-destination-name>
JMS Destination オブジェクトへの参照名を定義します。
ここで指定する参照名はJava EE deployment descriptorの<message-destination-ref>タグで定義した参照名を指定してください。

<jndi-name>
実際の運用環境におけるJMS DestinationオブジェクトのJNDI名を定義します。

参照

定義方法については、「3.11 JNDI」を参照してください。

message-destination-ref (親タグ:sun-web-app、ejb、sun-application-client)

Java EE deployment descriptorの<message-destination-ref>タグ、または@Resource、@Resourcesで定義した参照名に対応する実際の運用環境におけるJMS DestinationオブジェクトのJNDI名を定義します。
Java EE deployment descriptorのmessage-destination-refタグでmessage-destination-linkを定義した場合は、対応する実際の運用環境におけるJMS Destinationオブジェクトをmessage-destination定義で指定します。

<message-destination-ref-name>
JMS Destination オブジェクトへの参照名を定義します。
ここで指定する参照名はJava EE deployment descriptorの<message-destination-ref-name>タグで定義した参照名を指定してください。

<jndi-name>
実際の運用環境におけるJMS DestinationオブジェクトのJNDI名を定義します。

参照

定義方法については、「3.11 JNDI」を参照してください。

parameter-encoding (親タグ:sun-web-app)

Webアプリケーション内で使用するエンコーディングを定義します。
指定可能な属性を以下に示します。

属性名

省略値

意味

default-charset

ISO-8859-1

クライアントからのリクエストのパラメタ解析やボディの処理に使用するエンコーディングを指定します。

pass-by-reference (親タグ:sun-application、ejb)

ServletまたはEnterprise JavaBeanが同一プロセス上の他のEnterprise JavaBeanのリモートインタフェース(Homeインタフェース、Remoteインタフェース、Remote Businessインタフェース)のメソッドを呼び出す場合、引数と返却値のコピーを渡すか、または参照を渡すかを指定します。trueまたはfalseを指定してください。それ以外の値を指定した場合、falseを指定した動作になります。それぞれの値を指定した場合の動作は以下です。

  • true:
    引数と返却値の参照を渡します。コピーを作成しないため性能が向上します。しかし、渡された値を呼出し元で変更した場合、呼出し先の値を変更することになるため、アプリケーションの動作に影響があります。メソッドの引数と返却値を更新しない場合だけ指定してください。

  • false:(省略値)
    引数と返却値のコピーを渡します。EJB規約通りの動作です。コピーを生成するため、性能のオーバーヘッドがあります。しかし、渡された値を呼出し元で変更しても、呼出し先の値は変更されないため、別プロセスで同一のEnterprise JavaBeanを呼び出した場合とアプリケーションの動作を同一とすることができます。

principal (親タグ:ejb)

EJB application deployment descriptor (ejb-jar.xml)のrun-asタグまたは@RunAsのアノテーションに指定したセキュリティロールに対応するprincipal名(ユーザ名)を指定します。
セキュリティロールに対応するユーザが1つしかない場合は、定義不要です。

<name>
principal名(ユーザ名)を指定します。

property (親タグ:sun-web-app、session-properties、cookie-properties、client-container)

親タグに関するプロパティを定義します。
指定可能な属性、プロパティを以下に示します。

属性名

省略値

意味

name

－

プロパティ名を指定します。

value

－

プロパティ値を指定します。

プロパティ名

省略値

意味

description

－

プロパティの説明を記述します。親タグがclient-containerタグの場合には指定できません。

resource-env-ref (親タグ:sun-web-app、ejb、sun-application-client)

Java EE deployment descriptorの<resource-env-ref>タグ、または@Resource、@Resourcesで定義した参照名に対応するJMS Destination(Queue,Topic)の運用環境のJNDI名を指定します。
このタグを定義することによって、IJServerクラスタの名前変換と同等の機能を使用できます。

<resource-env-ref-name>
JMS Destination(Queue,Topic)の参照名を定義します。
ここで指定する参照名はJava EE deployment descriptorの<resource-env-ref-name>タグで定義した参照名を指定してください。

<jndi-name>
実際の運用環境におけるJNDI名を定義します。

参照

定義方法については、「3.11 JNDI」を参照してください。

resource-ref (親タグ:sun-web-app、ejb、sun-application-client)

Java EE deployment descriptorの<resource-ref>タグ、または@Resource、@Resourcesのアノテーションで定義した参照名に対応するJDBCデータソース、JMS(ConnectionFactory)、JavaMail、connector、URLの運用環境の実名を指定します。

<res-ref-name>
リソースの参照名を定義します。
ここで指定する参照名はJava EE deployment descriptorの<res-ref-name>タグで定義した参照名を指定してください。

<jndi-name>
実際の運用環境におけるJNDI名を定義します。

参照

定義方法については、「3.11 JNDI」を参照してください。

schema (親タグ: sun-cmp-mapping)

capture-schemaコマンドにより取得したデータベースのスキーマ情報のファイルパスを指定します。
ejb-jarファイルのトップからの相対パスを指定して拡張子(".dbschema")を省略してください。
スキーマ情報を自動的に取得させる場合、タグの値を空にしてください(<schema/>)。

security-role-mapping (親タグ:sun-application、sun-web-app、sun-ejb-jar)

Java EE deployment descriptorに定義されているセキュリティロールとInterstageディレクトリサービスに定義されているユーザまたはグループを対応付けます。
Java EE セキュリティを使用する場合に定義します。

<role-name>
Java EE deployment descriptorに定義されているセキュリティロールを定義します。

<principal-name>
Interstageディレクトリサービスに定義されているユーザIDを定義します。

<group-name>
Interstageディレクトリサービスに定義されているグループ名を定義します。

注意

1つのセキュリティロールに対して複数のユーザ(または、グループ)を対応付ける場合は以下のように1つの<security-role-mapping>タグに複数の<principal-name>タグ(または、<group-name>タグ)を定義してください。

  <security-role-mapping>
    <role-name>roleA</role-name>
    <principal-name>userA</principal-name>
    <principal-name>userB</principal-name>
    <group-name>GroupA</group-name>
    <group-name>GroupB</group-name>
  </security-role-mapping>

以下のように複数の<security-role-mapping>タグに分けて定義した場合は、セキュリティロールとユーザ(または、グループ)の対応付けが正常に動作しません。

  <security-role-mapping>
    <role-name>roleA</role-name>
    <principal-name>userA</principal-name>
  </security-role-mapping>

  <security-role-mapping>
    <role-name>roleA</role-name>
    <principal-name>userB</principal-name>
  </security-role-mapping>
servlet (親タグ: sun-web-app)

サーブレットまたはJSPの動作について定義します。

<servlet-name>
サーブレットまたはJSPの名前を定義します。
ここで指定する名前はdeployment descriptor(web.xml)の<servlet-name>タグで定義された名前を使用してください。

<principal-name>
deployment descriptor(web.xml)の<run-as>タグまたは@RunAsのアノテーションに指定したセキュリティロールに対応するprincipal名(ユーザ名)を指定します。
セキュリティロールに対応するユーザが1つしかない場合は、定義不要です。

session-config (親タグ:sun-web-app)

Webアプリケーション内のセションを制御する共通の値を定義します。

session-properties (親タグ: session-config)

Webアプリケーション内のセションを制御する共通の値を<property>タグを使用して定義します。
指定可能なプロパティを以下に示します。

プロパティ名

省略値

意味

enableCookies

true

セションIDをcookieに設定するか指定します。設定した場合、cookieを使用したセションの追跡ができます。

  • true : 設定します。

  • false: 設定しません。

sun-application

Interstage application deployment descriptorの開始と終了を定義します。

sun-application-client

Interstage application client deployment descriptorの開始と終了を定義します。

sun-cmp-mapping (親タグ:sun-cmp-mappings)

特定のスキーマにマップするCMP Entity Beanのマッピング情報を定義します。

sun-cmp-mappings

Interstage CMP Mappings deployment descriptorの開始と終了を定義します。

sun-ejb-jar

Interstage EJB application deployment descriptorの開始と終了を定義します。

sun-web-app

Interstage Web application deployment descriptorの開始と終了を定義します。
また、Webアプリケーション内で共通の値を<property>タグを使用して定義できます。
指定可能なプロパティを以下に示します。

プロパティ名

省略値

意味

crossContextAllowed

false

他のWebアプリケーションへのディスパッチを許可するかどうかを指定します。

  • true : 許可します。

  • false: 許可しません。

listings

false

ディレクトリの内容を一覧表示するかどうかを指定します。

  • true : 表示します。 (注)

  • false: 表示しません。

fileEncoding

OSデフォルトのエンコーディング

サーブレットやJSPなどから静的リソースにディスパッチした場合に、静的リソースの処理に使用するエンコーディングを指定します。

注) listingsにtrueを選択した場合、ディレクトリ内のファイルの増大やリクエストの同時処理数に依存して、メモリ使用量が増大します。セキュリティの観点からもデフォルト値での運用を推奨します。

table-name (親タグ:entity-mapping)

使用するデータベースのテーブル名を指定します。

target-server (親タグ:client-container)

アクセスするサーバのIIOPリスナーを定義してください。リスナーには、ホスト名またはIPアドレスと、ポート番号を指定します。
指定可能な属性を以下に示します。

属性名

省略値

意味

name

なし

一意な名前を指定します。

address

なし

クライアントからアクセスするサーバのDNSで解決できるホスト名またはIPアドレスを指定します。

port

なし

クライアントからアクセスするサーバのネーミングサービスのポート番号を指定します。

unique-id (親タグ:sun-application、enterprise-beans)

システムIDを-9223372036854775808～9223372036854775807の範囲で指定します。IPCOMと連携したIIOP通信の負荷分散機能を使用する場合だけ使用してください。
本タグを省略した場合、および0を設定した場合はシステムで自動的に採番されます。そのため、負荷分散機能を使用する場合は0以外の値を設定してください。

use-thread-pool-id (親タグ:ejb)

リモート呼出しに使用するスレッドのプール名を指定します。
省略または定義されていないスレッドプール名を指定するとデフォルトスレッドプールが使用されます。
スレッドプール機能については、「7.7.1 スレッドプーリング」を参照してください。

前次
Copyright FUJITSU LIMITED 2009