29.3. EJB コンテナー

図29.4 コンテナー設定関連の jboss_4_0 DTD 要素

<container-configuration>
    <container-name>Standard CMP 2.x EntityBean</container-name>
    <call-logging>false</call-logging>
    <invoker-proxy-binding-name>entity-rmi-invoker</invoker-proxy-binding-name>
    <sync-on-commit-only>false</sync-on-commit-only>
    <insert-after-ejb-post-create>false</insert-after-ejb-post-create>
    <call-ejb-store-on-clean>true</call-ejb-store-on-clean>
    <container-interceptors>
        <interceptor>org.jboss.ejb.plugins.ProxyFactoryFinderInterceptor</interceptor>
        <interceptor>org.jboss.ejb.plugins.LogInterceptor</interceptor>
        <interceptor>org.jboss.ejb.plugins.SecurityInterceptor</interceptor>
        <interceptor>org.jboss.ejb.plugins.TxInterceptorCMT</interceptor>
        <interceptor>org.jboss.ejb.plugins.CallValidationInterceptor</interceptor>
        <interceptor metricsEnabled="true">
            org.jboss.ejb.plugins.MetricsInterceptor
        </interceptor>
        <interceptor>org.jboss.ejb.plugins.EntityCreationInterceptor</interceptor>
        <interceptor>org.jboss.ejb.plugins.EntityLockInterceptor</interceptor>
        <interceptor>org.jboss.ejb.plugins.EntityInstanceInterceptor</interceptor>
        <interceptor>org.jboss.ejb.plugins.EntityReentranceInterceptor</interceptor>
        <interceptor>
             org.jboss.resource.connectionmanager.CachedConnectionInterceptor
        </interceptor>
        <interceptor>org.jboss.ejb.plugins.EntitySynchronizationInterceptor</interceptor>
        <interceptor>org.jboss.ejb.plugins.cmp.jdbc.JDBCRelationInterceptor</interceptor>
    </container-interceptors>
    <instance-pool>org.jboss.ejb.plugins.EntityInstancePool</instance-pool>
    <instance-cache>org.jboss.ejb.plugins.InvalidableEntityInstanceCache</instance-cache>
    <persistence-manager>org.jboss.ejb.plugins.cmp.jdbc.JDBCStoreManager</persistence-manager>
    <locking-policy>org.jboss.ejb.plugins.lock.QueuedPessimisticEJBLock</locking-policy>
    <container-cache-conf>
        <cache-policy>org.jboss.ejb.plugins.LRUEnterpriseContextCachePolicy</cache-policy>
        <cache-policy-conf>
            <min-capacity>50</min-capacity>
            <max-capacity>1000000</max-capacity>
            <overager-period>300</overager-period>
            <max-bean-age>600</max-bean-age>
            <resizer-period>400</resizer-period>
            <max-cache-miss-period>60</max-cache-miss-period>
            <min-cache-miss-period>1</min-cache-miss-period>
            <cache-load-factor>0.75</cache-load-factor>
        </cache-policy-conf>
    </container-cache-conf>
    <container-pool-conf>
        <MaximumSize>100</MaximumSize>
    </container-pool-conf>
    <commit-option>B</commit-option>
</container-configuration>

<?xml version="1.0"?>
<jboss>
    <enterprise-beans>
        <session>
            <ejb-name>EchoBean</ejb-name>
            <configuration-name>Secured Stateless SessionBean</configuration-name>
            <!-- ... -->
        </session>
    </enterprise-beans>
    <container-configurations>
        <container-configuration extends="Standard Stateless SessionBean">
            <container-name>Secured Stateless SessionBean</container-name>
            <!-- Override the container security domain -->
            <security-domain>java:/jaas/my-security-domain</security-domain>
        </container-configuration>
    </container-configurations>
</jboss>

import org.w3c.dom.Element;
public interface XmlLoadable
{
    public void importXml(Element element) throws Exception;
}

29.3.1.3.9. container-pool-conf 要素

container-pool-conf を InstancePool 実装クラスに渡します。このInstancePool 実装クラスは、XmlLoadable インターフェースが実装された場合にinstance-pool 要素により渡されます。現在の JBoss InstancePool 実装は、図29.5「container-pool-conf 要素の DTD」 で提示している要素へ対応可能にする org.jboss.ejb.plugins.AbstractInstancePool クラスから来ています。

図29.5 container-pool-conf 要素の DTD

• MinimumSize: JBoss では現在 InstancePool を MinimumSize 値にシードしませんが、MinimumSize 要素は、プールに保存できるインスタンスの最小数を渡します。
• MaximumSize: MaximumSize は、プールインスタンスの上限数を指定します。MaximumSize のデフォルトの用途は、考えているものと少し違うかもしれません。プール MaximumSize は、EJB インスタンスの最大利用可能数ですが、同時リクエストの数が MaximumSize の値を超えた場合、さらにインスタンスを作成することができます。
• strictMaximumSize: EJB の最大並行処理数をプールの MaximumSizeに制限したい場合、strictMaximumSize 要素を true に設定する必要があります。strictMaximumSize が true の場合、MaximumSize EJB インスタンスのみがアクティブとなります。MaximumSize が有効なインスタンスがある場合、インスタンスがプールに開放されるまでその後に続くリクエストはブロックされます。strictMaximumSize のデフォルト値は、false です。
• strictTimeout: リクエストがインスタンスのプールオブジェクトの待機をブロックする時間は、strictTimeout 要素で制御されます。strictTimeout は、MaximumSize が有効なインスタンスがある場合にプールへインスタンスを返すまでの待機時間をミリ秒単位で定義します。0以下の値の場合は待機時間なしとなります。リクエストのインスタンス待機時間がタイムアウトした場合、java.rmi.ServerException が生成され呼び出しが中断されます。これは Long として解析されるため、最大の許容待機時間は 9,223,372,036,854,775,807 あるいは約 292,471,208 年で、これがデフォルト値となっています。

29.3.1.3.11. container-cache-conf 要素

container-cache-conf 要素は、XmlLoadable インターフェースに対応している場合、InstanceCache 実装に渡されます。現在の JBoss InstanceCache 実装はすべて、org.jboss.ejb.plugins.AbstractInstanceCache クラスから来ています。このクラスは、XmlLoadable インターフェースに対応し、インスタンスキャッシュストアとして利用する org.jboss.util.CachePolicy 実装の完全修飾名としてcache-policy 子要素を利用します。cache-policy-conf 子要素は、XmlLoadable インターフェースに対応していれば、CachePolicy 実装に渡されます。対応していない場合は、cache-policy-conf は確認なしに無視されます。

現在の cache-policy-conf 子要素アレイに対応している、standardjboss.xml 設定が利用する CachePolicy の JBoss 実装が２つあります。これらの実装クラスは、 org.jboss.ejb.plugins.LRUEnterpriseContextCachePolicy は org.jboss.ejb.plugins.LRUStatefulContextCachePolicy となっています。LRUEnterpriseContextCachePolicy は、エンティティ bean コンテナーに、LRUStatefulContextCachePolicy はステートフルセッション bean コンテナーにより利用されます。このキャッシュポリシーは両方、図29.6「container-cache-conf 要素の DTD」にある以下の cache-policy-conf 子要素に対応しています。

図29.6 container-cache-conf 要素の DTD

• min-capacity: このキャッシュの最小容量を指定します。
• max-capacity: このキャッシュの最大容量を指定しますが、 min-capacity より小さい数値には設定できません。
• overager-period: overager タスクを実行する間隔を秒単位で指定します。overager タスクの目的は、キャッシュにmax-bean-age 要素値の一定年齢以上となっている bean が含まれているか確認することです。この基準に合致する bean はすべて非活性化 (passivate) されます。
• max-bean-age: overager プロセスにより非活性化が行われるまで bean がどの程度アクティブでない状態でいられるか上限を指定します。
• resizer-period: resizer タスクを実行する間隔を秒単位で指定します。resizer タスクの目的は、以下の方法で、残り３つの要素値をもとにキャッシュの容量を縮小／拡大します。resizer タスクが実行されると、キャッシュミスの現在の間隔をチェックし、この間隔がmin-cache-miss-period の値より小さい場合は、cache-load-factor を使い、キャッシュは最大で max-capacity の値まで拡大されます。キャッシュミスの間隔がmax-cache-miss-period 値より小さい場合は、このキャッシュは cache-load-factor を使い縮小されます。
• max-cache-miss-period: キャッシュミスがキャッシュの容量が縮小されたとシグナル送信すべき間隔を指定します。キャッシュが縮小されるまで許容最小の誤り指数と同じになります。
• min-cache-miss-period: キャッシュミスがキャッシュの容量が拡大されたとシグナル送信すべき間隔を指定します。キャッシュが拡大されるまで許容される最大の誤り指数と同じになります。
• cache-load-factor: キャッシュ容量を縮小／拡大する因数を指定します。因数は 1 未満にしてください。キャッシュが縮小される場合、容量が削減されるので bean がキャッシュする容量の現在の割合は cache-load-factor 値と同等になります。 キャッシュが拡大される場合、 新しい容量は current-capacity * 1/cache-load-factor として確定されます。実際の拡大因数はキャッシュミス数に基づく内部アルゴリズムに応じて 2 まで上げることができます。キャッシュミス率が高いほど実際の拡大因数は 2 に近くなります。

LRUStatefulContextCachePolicy は残りの子要素にも対応しています。

• remover-period: remover タスクを実行する間隔を秒単位で指定します。 remover タスクは max-bean-life 秒を超える間隔でアクセスされていない非活性化された bean を削除します。このタスクはユーザーにより削除されなかったステートフルセッション bean で非活性化ストアがいっぱいになってしまわないようにします。
• max-bean-life: bean がアクティブでない状態で存在できる最大期間を秒単位で指定します。この期間を超えると、bean は非活性化ストアから削除されます。

別のキャッシュポリシー実装は org.jboss.ejb.plugins.NoPassivationCachePolicy クラスで、これは単にインスタンスの非活性化を行いません。明示的に削除しない限りインスタンスを破棄することのないインメモリの HashMap 実装を使用します。このクラスはいずれの cache-policy-conf 設定要素もサポートしません。

29.3.1.3.17. cluster-config

cluster-config 要素によりコンテナー設定を使用するすべての EJB に対してクラスター固有の設定を指定することができるようになります。クラスター設定の指定はコンテナー設定レベルか個別の EJB デプロイメントレベルで行うことができます。

図29.7 cluster-config と関連要素

• partition-name: partition-name 要素は、クラスタリング情報の交換にコンテナーが使用する org.jboss.ha.framework.interfaces.HAPartition インターフェースを検索する場所を指示します。これは HAPartition がバインドされる場所の完全 JNDI 名ではなく、目的のクラスターを管理している ClusterPartitionMBean サービスの PartitionName 属性に該当するはずです。実際の HAPartition バインディングの JNDI 名は partition-name 値に /HASessionState/ を追加した形式となります。デフォルト値は DefaultPartition です。
• home-load-balance-policy: home-load-balance-policy 要素はホームプロキシで出された呼び出しの負荷分散に使用する Java クラス名を指示します。このクラスは org.jboss.ha.framework.interface.LoadBalancePolicy インターフェースを実装しなければなりません。 デフォルトポリシーは org.jboss.ha.framework.interfaces.RoundRobin になります。
• bean-load-balance-policy: bean-load-balance-policy 要素は bean プロキシで呼び出しの負荷分散に使用する java クラス名を指示します。このクラスは org.jboss.ha.framework.interface.LoadBalancePolicy インターフェースを実装しなければなりません。エンティティ bean およびステートフルセッション bean の場合デフォルトは org.jboss.ha.framework.interfaces.FirstAvailavble で、 ステートレスセッション bean の場合は org.jboss.ha.framework.interfaces.RoundRobin になります。
• session-state-manager-jndi-name: session-state-manager-jndi-name 要素はクラスター内のステータスセッション管理のバックエンドとしてコンテナーが使用する org.jboss.ha.framework.interfaces.HASessionState の名前を指示します。 partition-name 要素とは異なり、HASessionState 実装がバインドされる場所の JNDI 名になります。デフォルトの場所は /HASessionState/Default です。