Symfoware Server V12.1.x アプリケーション開発ガイド(JDBCドライバ編)

付録C 異常時の対処

JDBCドライバ利用時に、異常が発生した際の対処方法について説明します。

なお、ここに記載されていない異常が発生した場合は、“付録E メッセージリファレンス”または“5.4 アプリケーションのデバッグ”を参照し、対処を行ってください。

"LDWrapperクラスがローカルデータベースアクセスをロードしていません"のエラーが返却された場合

• JDBCドライバが正しくインストールされているかを確認してください。

• JDBCドライバの環境設定に誤りがある可能性があります。“5.3 アプリケーションの実行”を参照し、環境設定を見直してください。

  注意

  ServletやJSPで環境設定を変更した場合、変更した値を有効にするために、使用しているServletコンテナを再起動してください。

• アプリケーションサーバ上に、以下のどちらかの製品が正しくインストールされていることを確認してください。

  • Symfoware Server クライアント機能

  • Symfoware Server

"データ受信中にサーバとの通信が切断されました"のエラーが返却された場合

• 指定されたポート番号に誤りがある可能性があります。ポート番号が正しいかどうか、確認してください。

"コネクションの失敗: I/Oエラーが発生しました"のエラーが返却された場合

• 指定されたホスト名、ポート番号およびデータ資源名が正しいか確認してください。

• Symfoware Serverが起動されているかを確認してください。

"同時に使用できるコネクション数の最大値を超えました"のエラーが返却された場合

• JDBCドライバが同時に使用できるコネクション数の最大値を超えたため、コネクションをクローズするか、JDBCデータソースオプション設定画面で最大コネクション数の値を増やしてください。

  必要に応じてSymfoware Serverの最大コネクション数も変更してください。

"コネクション違反 - SQLクライアントがSQLコネクションを獲得できませんでした"のエラーが返却された場合

• JDBCドライバでタイムアウトが発生した可能性があります。

  JDBCデータソースオプション設定画面のサーバ待ち時間の値を見直し,適切な値を設定してください。0を指定した場合は、待ち時間の監視を行いません。

• Symfoware Serverが正しく動作しているかを再度確認してください。

"JYP1059E 不当なプロトコルが転送されました."のエラーが返却された場合

• 指定されたポート番号に誤りがある可能性があります。ポート番号が正しいかどうか、確認してください。

"JYP2278E SQL文識別子で指定している表が変更されました."のエラーが返却された場合

• ステートメントキャッシュ機能を使用中に、動的定義変更機能が使用された可能性があります。アプリケーションのプロセスを再起動してください。

"java.sql.SQLException: No suitable driver "のエラーが返却された場合

• DriverManager.getConnectionメソッドの引数に指定するURLの記述形式が正しいか確認してください。

• Class.forNameメソッドの引数に指定するJDBCドライバ名が正しいか確認してください。

"java.lang.NoClassDefFoundError"のエラーが返却された場合

• JDBCドライバの環境設定に誤りがある可能性があります。“5.3 アプリケーションの実行”を参照し、環境設定を見直してください。

"java.lang.OutOfMemoryError"のエラーが返却された場合

• メモリ不足が発生しました。

  Javaでは、不要になったメモリの解放はガーベジコレクションで行われます。しかし、ガーベジコレクションは、使われなくなったオブジェクトが使用しているメモリを解放するだけです。アプリケーションが必要なメモリの解放としては、十分ではありません。 そのため、アプリケーションがメモリ不足になる場合があります。

  メモリ不足が発生した場合は、以下の対処を行ってください。

  • Java実行環境のヒープサイズを拡張する。

  • System.gcメソッドを使い、強制的にメモリの解放を行う。

  ただし、System.gcメソッドは実行性能に影響します。

  呼び出しのタイミングなどを十分に検討した上で使用してください。

[Java実行環境のヒープサイズ拡張例]

初期サイズを64MByte、最大サイズを128MByteに設定します。

java -Xms64m -Xmx128m <class Name>

"java.lang.IncompatibleClassChangeError"のエラーが返却された場合

• 現在有効になっているJDKのバージョンが、1.1.*になっている可能性があります。以下のコマンドを使用して、有効になっているJDKのバージョンを確認してください。

  java -version

  JDK1.1.*を使用している場合、JDKの環境設定（環境変数“PATH”）を見直し、再度確認してください。

"java.lang.UnsupportedClassVersionError"のエラーが返却された場合

• 現在有効になっているJDKのバージョンとJDBCドライバとの組合せに問題がある可能性があります。
  以下のコマンドを使用して、有効になっているJDKのバージョンを確認し、JDBCドライバモジュールがそのバージョンをサポートしているかを確認していください。

  java -version

JDBCドライバとJDKとの組合せについては、“1.4 JDKとの組合せ”を参照してください。

• 利用するJDBCドライバの環境設定に誤りがある可能性があります。“5.3 アプリケーションの実行”を参照し、環境設定を見直してください。