3. EJB

3.1. 例外クラス

この章は、EJBで送出する例外クラスのメッセージと対処方法について説明します。

3.1.1. java.rmi.RemoteException

ERROR: Attempt to invoke on undeployed object
[説明]
このEnterprise Beanが削除された後にクライアントがそのメソッドを呼び出そうとした。
Client not authorized for this invocation.
[説明]
このメソッド呼び出しが許可されないクライアントから呼び出しを行おうとした。
[対処]
例外が出ないようにするためには、クライアントのロールをメソッド・パーミッションに含まれているものに設定するか、Enterprise Beanのメソッド・パーミッションの設定を変更してください。
Transaction Attribute not found for method <method_name>
[可変情報]
<method_name> : メソッド名
[説明]
不明なトランザクション属性が、指示されたEnterprise Beanのメソッドに与えられている。
[対処]
通常、この例外は発生しません。
EJB cannot be invoked in global transaction
[説明]
トランザクション属性がNEVERであるメソッドを処理中に、グローバル・トランザクションで呼び出された。
ERROR: No database resource reference for EntityBeans with container-managed persistence
[説明]
コンテナ管理による永続化のEntity Beanで、永続化のためのデータ保存をするデータベース情報が見つからなかった。
[対処]
配備記述子またはEJBコンテナの設定プロパティファイルで、データベース情報の設定を行って下さい。
Error obtaining CMP/primary key fields
[説明]
コンテナ管理による永続化のEntity Beanで、プライマリ・キーのフィールドが得られなかった。配備記述子で、プライマリ・キーのフィールドが正しく設定されていない可能性があります。
ERROR initializing EJB field <field name>
[可変情報]
<field_name> : フィールド名
[説明]
コンテナ管理による永続化のEntity Beanで、定義されたフィールドの値を初期化できなかった。配備記述子で、プライマリ・キーのフィールドの型宣言がサポート外であった可能性があります。
Unable to initialize primary key
[説明]
コンテナ管理による永続化のEntity Beanで、プライマリ・キー クラスの生成ができなかった。配備記述子で、プライマリ・キー クラスの定義が不完全であった可能性があります。
ERROR in database SELECT <exception_name>
[可変情報]
<exception_name> : 例外名
[説明]
コンテナ管理による永続化のEntity Beanで、コンテナがejbLoadメソッド処理中にデータベースへのアクセスに失敗した。配備記述子で設定したejbLoadメソッドに対するSQL文に誤りがあった可能性があります。
ERROR in database UPDATE <exception_name>
[可変情報]
<exception_name> : 例外名
[説明]
コンテナ管理による永続化のEntity Beanで、コンテナがejbStoreメソッド処理中にデータベースへのアクセスに失敗した。配備記述子で設定したejbStoreメソッドに対するSQL文に誤りがあった可能性があります。
ERROR in database DELETE <exception_name>
[可変情報]
<exception_name> : 例外名
[説明]
コンテナ管理による永続化のEntity Beanで、コンテナがejbRemoveメソッド処理中にデータベースへのアクセスに失敗した。配備記述子で設定したejbRemoveメソッドに対するSQL文に誤りがあった可能性があります。
No SQL statement for <method_name>
[可変情報]
<method_name> : メソッド名
[説明]
コンテナ管理による永続化のEntity Beanで、コンテナがejbFindxxxメソッド処理中にデータベースへのアクセスに失敗した。配備記述子で設定したejbFindxxxメソッドに対するSQL文に誤りがあった可能性があります。
Error deserializing primaryKey.
[説明]
Entity Beanのプライマリキーのデシリアライズに失敗しました。
[対処]
プライマリキーのクラスがSerializableかどうか確認して下さい。
EJB is already executing another request
[説明]
Entity Beanで、Enterprise Beanの状態が呼び出し中で、リエントラント設定が行われていない場合に呼び出された。
Null primary key returned by [ejbCreate | ejbFind] method
[説明]
Entity Beanで、プライマリ・キーが見つからなかった。
Error during [ejbLoad | ejbStore], EJB instance discarded
[説明]
Entity Beanで、ejbLoad()、ejbStore()メソッドの処理中にエラーが発生した。このEnterprise Beanインスタンスは破棄されます。
Exception creating EJBObject:
[説明]
Entity Beanで、リモート・インタフェースのインスタンス生成で例外が発生した。
Could not create Entity EJB
[説明]
Entity Beanで、Beanインスタンス生成ができなかった。
Error during ejbActivate
[説明]
Entity Beanで、ejbActivate()メソッド処理中にエラーが発生した。
Unable to get EJBObject:
[説明]
HandleクラスのgetEJBObject()メソッド呼び出しで、EJBObjectクラスのオブジェクト参照取得ができなかった。
Unable to get EJBHome:
[説明]
HomeHandleクラスのgetEJBHome()メソッド呼び出しで、EJBHomeクラスのオブジェクト参照取得ができなかった。
SessionBean is executing another request
[説明]
ステートフルSession Beanで、実行中に他のクライアントから呼び出し要求があった。Session Beanインスタンスは、複数のクライアントと共有できません。
Error during [afterBegin | beforeCompletion], EJB instance discarded
[説明]
ステートフルSession Beanで、SessionSynchronizationクラスのafterBegin()、beforeCompletion()メソッド呼出し中にエラーが発生した。このEnterprise Beanインスタンスは破棄されます。
Unable to activate EJB
[説明]
ステートフルSession Beanで、非活性化状態にあったEnterprise Beanを活性化できなかった。
Invalid operation for Session EJBs.
[説明]
Session Beanで、許可されないgetPrimaryKey()メソッドを呼び出しました。
[対処]
Beanの処理内容を確認してください。
ERROR creating EJB:
[説明]
ステートレスSession Beanで、Beanインスタンスの生成ができなかった。

3.1.2. java.lang.RuntimeException

No SQL statement for method <method_name>
[可変情報]
<method_name> : メソッド名
[説明]
コンテナ管理による永続化のEntity Beanで、そのメソッドに対するSQL文が設定されていない。
[対処]
配備記述子で、そのメソッドにSQL文を定義して下さい。
Bad SQL query for method <method_name>
[可変情報]
<method_name> : メソッド名
[説明]
コンテナ管理による永続化のEntity Beanで、そのメソッドに対するSQL文が誤っている。
[対処]
配備記述子で、そのメソッドにSQL文を正して下さい。
Bad parameter number <parameter_number> in SQL query for method <method_name>
[可変情報]
<parameter_number> : パラメータ数
<method_name> : メソッド名
[説明]
コンテナ管理による永続化のEntity Beanで、そのメソッドに対するSQL文のパラメータが誤っている。
[対処]
配備記述子で、そのメソッドにSQL文を正して下さい。
More than one row returned by SQL query for single-object finder <method_name>
[可変情報]
<method_name> : メソッド名
[説明]
コンテナ管理による永続化のEntity Beanで、その単一オブジェクトを返すファインダ・メソッドに対する返却数が複数定義されていた。
Invalid return type for finder
[説明]
コンテナ管理による永続化のEntity Beanで、ファインダ・メソッドに対する返却値の型が無効で定義されていた。
Unable to serialize container-managed field. <exception_name>
[可変情報]
<exception_name> : 例外名
[説明]
コンテナ管理による永続化のEntity Beanで、フィールドの型がシリアライズ可能でなかった。
[対処]
配備記述子で設定したコンテナが管理するフィールドがJavaのシリアライズ可能な型であるかを確認して下さい。
Unsupported JDBC type: <type_name>
[可変情報]
<type_name> : 型名
[説明]
コンテナ管理による永続化のEntity Beanで、永続化のために定義した型が、JDBCの有効な型でなかった。
[対処]
配備記述子で設定したコンテナが管理するフィールドの型がJDBCで有効なものであるかを確認して下さい。
Field not accessible: <exception_name>
[可変情報]
<exception_name> : 例外名
[説明]
コンテナ管理による永続化のEntity Beanで、永続化のために定義したフィールドにアクセスできなかった。
getCallerIdentity is deprecated in EJB1.1
[説明]
EJBContextクラスのgetCallerIdentity()メソッドを呼び出すと、この例外が送出されます。EJB 1.1では、このメソッドをサポートしません。

3.1.3. java.lang.ClassCastException

narrowFrom is not supported narrowTo
[説明]
PortableRemoteObject.narrowメソッドで引数に指定したオブジェクトのクラスがnarrowするクラスにキャストできない場合や、オブジェクトがリモートオブジェクトのとき、そのスタブのクラスがクラスパスに存在しない場合に、この例外が送出されます。

3.1.4. javax.ejb.CreateException

ERROR in database INSERT <exception_name>
[可変情報]
<exception_name> : 例外名
[説明]
コンテナ管理による永続化のEntity Beanで、createメソッド処理中にデータベースへのアクセスに失敗した。配備記述子で設定したejbCreateメソッドに対するSQL文に誤りがあった可能性があります。
ERROR creating stateful SessionBean: <exception_name>
[可変情報]
<exception_name> : 例外名
[説明]
ステートフルSession Beanの生成中にエラーが発生した。
Could not create stateless EJB
[説明]
ステートレスSession Beanの生成ができなかった。

3.1.5. javax.ejb.FinderException

ERROR in database SELECT for find: <exception_name>
[可変情報]
<exception_name> : 例外名
[説明]
コンテナ管理による永続化のEntity Beanで、findxxxメソッド処理中にデータベースへのアクセスに失敗した。配備記述子で設定したejbFindxxxメソッドに対するSQL文に誤りがあった可能性があります。

3.1.6. javax.ejb.DuplicateKeyException

Duplicate primary key
[説明]
コンテナ管理による永続化のEntity Beanで、ejbFindByPrimaryKeyメソッド処理中にデータベースへのアクセスで、重複したプライマリ・キーでアクセスしようとした。

3.1.7. javax.ejb.NoSuchEntityException

ERROR in SQL SELECT: No database row for EJB
[説明]
コンテナ管理による永続化のEntity Beanで、ejbFindByPrimaryKeyメソッド処理中にデータベースへのアクセスで、存在しないレコードにアクセスしようとした。
Exception thrown by [ejbLoad | ejbStore], EJB instance discarded
[説明]
Entity Beanで、ejbLoad()、ejbStore()メソッド呼び出しで例外が発生した。このEnterprise Beanインスタンスは破棄されます。
The EJB does not exist.
[説明]
ステートフルSession Beanで、存在しないEnterprise Beanを呼び出そうとした。

3.1.8. javax.ejb.ObjectNotFoundException

No database row found for primary key
[説明]
コンテナ管理による永続化のEntity Beanで、ejbFindByPrimaryKeyメソッド処理中にデータベースへのアクセスで、存在しないプライマリ・キーのレコードにアクセスしようとした。
No database row found for finder <method_name>
[可変情報]
<method_name> : メソッド名
[説明]
コンテナ管理による永続化のEntity Beanで、プライマリ・キーが未定義であった。

3.1.9. javax.ejb.RemoveException

Cannot remove EJB: transaction in progress
[説明]
ステートフルSession Beanで、トランザクション中にremove()メソッドが呼び出された。
Invalid remove operation.
[説明]
Session Beanで、許可されないremove(Primarykey)メソッドを呼び出しました。Session Beanはプライマリ・キーを持たないので、このメソッド呼び出しはできません。

3.1.10. java.sql.SQLException

Operation not supported
[説明]
DataSourceが実行しようとしたオペレーションをサポートしていません。
[対処]
DataSourceを使用している個所の処理内容を確認してください。
This DataSource object can only be used by J2EE components or application clients.
[説明]
J2EEコンポーネント以外のアプリケーションがデータソースを使用しようとしました。

3.1.11. java.lang.IllegalStateException

ERROR: only SessionBeans with bean-managed transactions can obtain UserTransaction
[説明]
Enterprise Beanが、Beanが管理するトランザクションのSession Bean以外が、UserTransactionオブジェクトを取得しようとした。
EJBObject not available
[説明]
EJBContextクラスのgetEJBObject()メソッド呼び出しで、サーバ内で起動されていないリモート・インタフェースのクラスを取得しようとした。
EJB not in READY state
[説明]
EJBContextクラスのgetCallerPrincipal()または、isCallerInRole(String)、setRollbackOnly()、getRollbackOnly()メソッド呼び出しで、Enterprise Beanがサーバ内で準備状態ではなかった。
Operation not allowed
[説明]
EJBContextクラスのgetUserTransaction()メソッド呼び出しで、Enterprise Beanがサーバ内で準備状態ではなかった。または、ejbActivate()やejbPassivate()メソッドからEJB仕様上、呼び出してはならないメソッドが呼び出された。
Illegal operation for bean-managed transactions
[説明]
EJBContextクラスのsetRollbackOnly()、getRollbackOnly()メソッド呼び出しで、Bean管理のトランザクションを持つEnterprise Beanであった。
No transaction context.
[説明]
EJBContextクラスのsetRollbackOnly()、getRollbackOnly()メソッド呼び出しで、トランザクション・コンテキストが既に無い状態で呼び出された。
Primary key not available
[説明]
EntityContextクラスのgetPrimaryKey()メソッド呼び出しで、リモート・オブジェクトが準備状態でない時に呼び出された。ejbCreate、ejbFind、setEntityContextからは呼び出せません。

3.1.12. java.lang.IllegalArgumentException

EJB not in READY state
[説明]
EJBContextクラスのisCallerInRole(String)メソッド呼び出しで、引数が与えられなかった。
No mapping available for role reference <role_name>
[可変情報]
<role_name> : ロール名
[説明]
EJBContextクラスのisCallerInRole(String)メソッド呼び出しで、指定されたロールがEnterprise Beanに設定されていない。
[対処]
配備記述子でそのロールを設定したかを確認して下さい。