3.3.12 リソースアダプタについての注意事項
ここでは,リソースアダプタについての注意事項を説明します。
- デプロイ方法によって使用できない機能
-
リソースアダプタをJ2EEアプリケーションに含めて使用する場合,J2EEアプリケーションに含めたリソースが更新されても,次の機能は有効になりません。
-
J2EEアプリケーションの更新検知
-
J2EEアプリケーションのリロード
詳細は,「18.8.13 リロードの注意事項および制限事項」を参照してください。
-
- リソースアダプタの表示名についての注意事項
-
J2EEアプリケーション内のEJBやWARは,J2EEリソースアダプタとしてデプロイするリソースアダプタ,およびJ2EEアプリケーションに含めて使用するリソースアダプタを同時に使用できます。ただし,一つのJ2EEサーバで同じ表示名のリソースアダプタを二つ以上使用することはできません。一つのJ2EEサーバに同じ表示名のリソースアダプタを二つ以上使用しようとすると,エラーメッセージが出力されて,リソースアダプタの開始に失敗します。リソースアダプタの開始に失敗する手順の例を次に示します。
- 例1.
-
-
「Rar1」という表示名のリソースアダプタをJ2EEサーバにデプロイする。
-
「Rar1」という表示名のリソースアダプタを含めたJ2EEアプリケーションをインポートする。
-
- 例2.
-
-
「Rar2」という表示名のリソースアダプタをJ2EEサーバにデプロイする。
-
「Rar2」という表示名のリソースアダプタを,インポート済みのJ2EEアプリケーションに追加する。
-
- 例3.
-
-
「Rar3」という表示名のリソースアダプタを含めたJ2EEアプリケーションをインポートする。
-
「Rar3」という表示名のリソースアダプタをJ2EEサーバにデプロイする。
-
- リソースアダプタのオプショナル名についての注意事項
-
同じオプショナル名で複数のリソースアダプタをデプロイしている場合,エラーメッセージが出力されて,リソースアダプタの開始に失敗します。
- リソースアダプタの開始処理についての注意事項
-
J2EEサーバの起動途中でリソースアダプタが開始処理に失敗した場合,開始状態から停止状態に遷移します。この場合,J2EEサーバの次回起動時にも開始されません。また,該当のリソースアダプタを使用しているアプリケーションの開始に失敗します。
このような場合は,エラー情報を参照してエラーの原因を取り除いたあとに,次の対処をしてください。
- リソースアダプタのトランザクションサポートレベルがLocalTransactionまたはNoTransactionの場合
-
-
停止状態に遷移したリソースアダプタを開始してください。
-
リソースアダプタを使用しているアプリケーションを開始してください。
-
- リソースアダプタのトランザクションサポートレベルがXATransactionの場合
-
-
停止状態に遷移したリソースアダプタを開始してください。
-
未決着トランザクションをリカバリするため,J2EEサーバを再起動してください。
-
リソースアダプタを使用しているアプリケーションを開始してください。
-
- そのほかの注意事項
-
URLコネクションのResource Factoryの参照機能は未サポートです。