Hitachi

インメモリデータグリッド　uCosminexus Elastic Application Data store ユーザーズガイド

20.1.4　CacheExceptionクラス

〈この項の構成〉

(1)　説明

Cacheクラス，およびCacheManagerクラスに対する操作が失敗した場合に返却される例外クラスです。

getErrorCode()によってエラーコードを取得し，エラーの内容を判別します。

ページの先頭へ

(2)　継承関係

java.lang.Object
└java.lang.Throwable
    └java.lang.Exception
        └com.hitachi.software.xeads.client.api.CacheException

ページの先頭へ

(3)　形式

public class CacheException
extends Exception

ページの先頭へ

(4)　メソッド一覧

CacheExceptionクラスが提供するメソッド一覧を次の表に示します。

メソッド名

説明

getErrorCode()

発生した例外のエラーコードを取得します。

ページの先頭へ

(5)　getErrorCode()

(a)　機能

発生した例外のエラーコードを取得します。

(b)　形式

public int getErrorCode()

(c)　戻り値

戻り値としてエラーコードが返却されます。エラーコードとエラーの内容，発生要因を次の表に示します。

エラーコード

エラーコード定数

例外クラス

エラーの内容

発生要因

1000

EAD_ERROR_UNEXPECTED

CacheException

予期しないエラーが発生しました。

プログラム内で予期しないエラーが発生しました。

1010

EAD_ERROR_INVALID_PARAMETER

UserOperationException

指定されたパラメタが不正です。

APIの引数に不正なパラメタを指定しています。

1030

EAD_ERROR_CLIENT_FINALIZED

UserOperationException

EADsクライアントの使用を終了しているため，処理を実行できませんでした。

CacheManagerクラスのdestroy()を実行したあとで，CacheManagerクラスのメソッドが実行されました。

1040

EAD_ERROR_CACHE_NOT_STARTED

UserOperationException

キャッシュが開始されていないため実行できません。

次の要因が考えられます。

  • キャッシュの終了後（CacheManagerクラスのremoveCache()の実行後）に，データを操作した。

  • EADsクライアントの使用を終了したあと（CacheManagerクラスのdestroy()実行後）に，データを操作した。

1050

EAD_ERROR_NOT_SERIALIZABLE

UserOperationException

EADsクライアントでのシリアライズ処理に失敗しました。

APIの引数にシリアライズできないオブジェクトを指定しています。

1060

EAD_ERROR_NOT_DESERIALIZABLE

UserOperationException

EADsクライアントでのデシリアライズ処理に失敗しました。

EADsサーバから取得したオブジェクトはEADsクライアントでデシリアライズできませんでした。

EADsクライアントのクラスパスに含まれないオブジェクトであることが考えられます。

1100

EAD_ERROR_CACHE_NOT_NEED_STOP

UserOperationException

すでに終了しているキャッシュに対して，終了処理をしています。

次の要因が考えられます。

  • キャッシュの終了後（CacheManagerクラスのremoveCache()の実行後）に，キャッシュを終了した。

  • CacheManagerクラスのgetCache()を実行していない状態で，CacheManagerクラスのremoveCache()を実行した。

1110

EAD_ERROR_INVALID_NODE_ADDRESS

UserOperationException

指定したEADsサーバのアドレス情報が，EADsクライアントが保持するEADsサーバのアドレス情報と一致しません。

APIの引数に指定したEADsサーバのアドレス情報（IPアドレスおよびポート番号）が，EADsクライアントが保持するどのEADsサーバのアドレス情報とも一致しません。

1120

EAD_ERROR_EXCEED_MAX_CONNECTION_POOL_SIZE

UserOperationException

同一接続先に対してプールしておくコネクションがすでに最大個数に達していて，すべて使用中です。

特定のEADsサーバに対して同時にリクエストしているスレッド数が，コネクションの最大個数を超えています。

2000

EAD_ERROR_INIT

InitializeException

EADsクライアントの初期設定でエラーが発生しました。

CacheManagerクラスのcreate()実行中に予期しないエラーが発生しました。

2010

EAD_ERROR_INIT_PROPERTIES

InitializeException

クライアント定義ファイルが読み込めませんでした。

次の要因が考えられます。

  • クライアント定義ファイルが存在しない。

  • クライアント定義ファイルに読み込み権限がない。

  • 格納先パス名がファイルではなくディレクトリを指している。

  • CacheManagerクラスのcreate()で指定した入力ストリームに問題がある。

2020

EAD_ERROR_INIT_INVALID_PROPERTY

InitializeException

クライアント定義ファイルの定義内容に不正があります。

クライアント定義ファイルの定義内容が不正です。

2030

EAD_ERROR_INIT_LOGGER

InitializeException

ログの初期化に失敗しました。

次の要因が考えられます。

  • 指定されたディレクトリ，または出力先のログファイルに書き込み権限がない。

  • 指定されたディレクトリに同名のファイルが存在する。

  • 指定されたパス名，またはファイル名が不正である。

  • ログファイル名と同名のディレクトリが存在した。

  • ログ出力を開始するためのメモリが不足している。

2040

EAD_ERROR_INIT_CLUSTERINFO

InitializeException

クライアント定義ファイルで指定されたEADsサーバへの接続に失敗しました。

次の要因が考えられます。

  • クライアント定義に指定した接続先EADsサーバの指定に誤りがある。

  • 接続先EADsサーバとの通信に失敗した。または接続先EADsサーバで障害が発生している。

  • 接続先EADsサーバの最大同時接続数を超えた。

  • 接続先EADsサーバがリクエストの受付を開始できる状態でない。

3000

EAD_ERROR_NET

ServerCommunicationException

EADsサーバとの間で通信エラーが発生しました。

次の要因が考えられます。

  • 通信中にネットワーク障害が発生した。

  • 通信先のEADsサーバで問題が発生した。

  • 通信先のホストで問題が発生した。

  • EADsサーバが受信できるデータの最大サイズを超えた。

3010

EAD_ERROR_NET_TIMEOUT

ServerCommunicationException

EADsサーバとの通信中にタイムアウトが発生しました。

次の要因が考えられます。

  • 接続先EADsサーバで問題が発生した。

  • 接続先のホストで問題が発生した。

  • ネットワークで問題が発生した。

  • タイムアウト時間の設定が誤っている。

3020

EAD_ERROR_NET_CONNECTION

ServerCommunicationException

EADsサーバとの接続に失敗しました。

次の要因が考えられます。

  • 接続先EADsサーバで問題が発生した。

  • 接続先EADsサーバに関する設定が誤っている。

  • ネットワークで問題が発生した。

  • タイムアウト時間の設定が誤っている。

3030

EAD_ERROR_NET_PROTOCOL

ServerCommunicationException

EADsサーバとの通信中にプロトコル障害が発生しました。

接続先EADsサーバが誤りです。

3040

EAD_ERROR_NET_CLUSTERINFO

ServerCommunicationException

接続できる，すべてのEADsサーバへの接続に失敗しました。

次の要因が考えられます。

  • 接続先EADsサーバで問題が発生した。

  • 接続先EADsサーバに関する設定が誤っている。

  • ネットワークで問題が発生した。

  • 指定したキャッシュが接続先EADsサーバに存在しない。

  • 接続先EADsサーバが閉塞状態となっている。

  • EADsクライアントが保持するクラスタ構成情報と，再起動した接続先EADsサーバが保持するクラスタ構成情報が一致しない。

  • 接続先EADsサーバの最大同時接続数を超えた。

4000

EAD_ERROR_SERVER

InternalServerException

EADsサーバで内部エラーが発生しました。

次の要因が考えられます。

  • 接続先EADsサーバで内部エラーが発生した。

  • 接続先EADsサーバが閉塞状態となっている。

  • 接続先EADsサーバのユーザファンクション内でエラーが発生した。

  • 指定したキャッシュ名のキャッシュが接続先EADsサーバに存在しない。

  • 指定したkeyのサイズがクラスタに格納できるkeyの最大サイズを超えている。

  • データの格納先の空き容量が不足している。

4010

EAD_ERROR_SERVER_UNSUPPORTED_REQUEST

InternalServerException

EADsクライアントが送信したリクエストを，接続先EADsサーバが処理できませんでした。

次の要因が考えられます。

  • ユーザファンクションの引数に，接続先EADsサーバがデシリアライズできないオブジェクトを指定した。

  • データが破損しているなどの理由で，接続先EADsサーバがリクエストを処理できない。

4020

EAD_ERROR_SERVER_EVENTHANDLER

InternalServerException

データの更新操作および多重化は成功したが，ユーザイベントハンドラ内の処理で例外が発生しました。

接続先EADsサーバのユーザイベントハンドラ内の処理で例外が発生しました。

4030

EAD_ERROR_SERVER_UNAVAILABLE

InternalServerException

接続先EADsサーバプロセスが一時的に利用できません。

接続先EADsサーバの最大同時接続数を超えました。

4040

EAD_ERROR_SERVER_INCOMPATIBLE_CLUSTERINFO

InternalServerException

接続先EADsサーバが保持するクラスタ構成情報と，EADsクライアントが保持するクラスタ構成情報に互換性がありません。

再起動した接続先EADsサーバのクラスタ構成情報が，EADsクライアントが保持するクラスタ構成情報と一致しません。

4060

EAD_ERROR_SERVER_REPLACE_METHOD_NOT_MATCHED

InternalServerException

replace()実行時，すでに格納されているvalueがcomparativeValueと一致しなかったため，valueを格納できませんでした。

Cacheクラスのreplace()で条件に指定したvalueとキャッシュ上のvalueが一致しませんでした。

4070

EAD_ERROR_SERVER_REPLACE_METHOD_KEY_NOT_EXIST

InternalServerException

replace()実行時，指定したkeyが存在しなかったため（keyに関連づけられたvalueが存在しなかったため），valueを格納できませんでした。

Cacheクラスのreplace()で指定したkeyに関連づけられたvalueが存在しなかったため，valueの比較ができませんでした。

4080

EAD_ERROR_SERVER_CREATE_METHOD_KEY_EXIST

InternalServerException

create()実行時，すでに格納されているkeyが存在したため，valueを格納できませんでした。

Cacheクラスのcreate()で指定したkeyに関連づけられたvalueがすでに格納されています。

4090

EAD_ERROR_SERVER_UPDATE_METHOD_KEY_NOT_EXIST

InternalServerException

update()実行時，格納されているkeyが存在しなかったため，valueを格納できませんでした。

Cacheクラスのupdate()で指定したkeyに関連づけられたvalueが格納されていません。

4100

EAD_ERROR_SERVER_NOT_RUNNING

InternalServerException

データのコピー元，およびコピー先のEADsサーバがすべて縮退状態または停止状態です。

EADsクライアントからのリクエストを処理するEADsサーバと，データのコピー先EADsサーバがすべて縮退状態または停止状態です。

5000

EAD_ERROR_CLIENT

InternalClientException

EADsクライアントで内部エラーが発生しました。

クライアントライブラリ内で予期しないエラーが発生しました。

5010

EAD_ERROR_CLIENT_OUT_OF_MEMORY

InternalClientException

EADsクライアント内でメモリ確保に失敗しました。

クライアントライブラリ内でメモリ確保に失敗しました。

ページの先頭へ

他社商品名称に関する表示

All Rights Reserved. Copyright (C) 2012, 2014, Hitachi, Ltd.