18.1.5 CacheException class
- Organization of this subsection
(1) Description
This is an exception class that is returned when an operation on the Cache and CacheManager classes fails.
Use getErrorCode() to obtain an error code to determine the nature of the error.
(2) Inheritance relationship
java.lang.Object java.lang.Throwable java.lang.Exception com.hitachi.software.xeads.client.api.CacheException
(3) Format
public class CacheException extends Exception
(4) List of methods
The following table lists and describes the methods provided by the CacheException class:
Method name |
Description |
---|---|
Acquires an error code for an exception that has occurred. |
(5) getErrorCode()
(a) Description
This method acquires an error code for an exception that has occurred.
(b) Format
public int getErrorCode()
(c) Return value
This method returns an error code as a return value. The following table lists the error codes and describes the nature and cause of the error:
Error code |
Error code literal |
Exception class |
Nature of error |
Cause of error |
Processing status of data updating API method# |
Error code when 0300 is specified in the eads.client.compat parameter in the client properties |
---|---|---|---|---|---|---|
1000 |
CacheException |
An unexpected error occurred. |
An unexpected error occurred within the program. |
U |
1000 |
|
1010 |
UserOperationException |
A specified parameter is invalid. |
An invalid parameter was specified in the API method argument. |
N |
1010 |
|
1030 |
UserOperationException |
The processing cannot be performed because usage of the EADS client has been terminated. |
A method of CacheManager class was executed after destroy() of the CacheManager class was executed. |
N |
1030 |
|
1040 |
UserOperationException |
The processing cannot be performed because the cache has not been started. |
Possible causes are as follows:
|
N |
1040 |
|
1050 |
UserOperationException |
Serialization processing failed on the EADS client. |
The object specified in the API method argument cannot be serialized. |
N |
1050 |
|
1060 |
UserOperationException |
Deserialization processing failed on the EADS client. |
The object acquired from the EADS server could not be deserialized on the EADS client. The object might not be included in the class path of the EADS client. |
-- |
1060 |
|
1100 |
UserOperationException |
An attempt was made to stop a cache that has already stopped. |
The following are possible causes of the error:
|
-- |
1100 |
|
1110 |
UserOperationException |
The specified EADS server's address information does not match any EADS server address information maintained by the EADS client. |
The address information (IP address and port number) of the EADS server specified in the argument of the API method does not match any EADS server address information maintained by the EADS client. |
-- |
1110 |
|
1120 |
UserOperationException |
The number of connections to be pooled for the same connection target has already reached the maximum value and all of them are in use. |
The number of concurrent threads issuing requests to the same EADS server has exceeded the maximum number of connections. |
N |
1120 |
|
2000 |
InitializeException |
EADS client initialization processing resulted in an error. |
An unexpected error occurred during execution of create() of the CacheManager class. |
-- |
2000 |
|
2010 |
InitializeException |
The client property file could not be imported. |
Possible causes are as follows:
|
-- |
2010 |
|
2020 |
InitializeException |
A definition in the client property file was invalid. |
A definition in the client property file is invalid. |
-- |
2020 |
|
2030 |
InitializeException |
Initialization of logs failed. |
Possible causes are as follows:
|
-- |
2030 |
|
2040 |
InitializeException |
Establishment of a connection with the EADS server specified in the client property file failed. |
Possible causes are as follows:
|
-- |
2040 |
|
3000 |
ServerCommunicationException |
An error occurred during communication with the EADS server. |
Possible causes are as follows:
|
U |
3000 |
|
3001 |
ServerCommunicationException |
A communication error occurred while a request was being sent to an EADS server. |
Possible causes are as follows:
|
U |
3000 |
|
3002 |
ServerCommunicationException |
A communication error occurred while a response was being received from an EADS server. |
Possible causes are as follows:
|
U |
3000 |
|
3010 |
ServerCommunicationException |
A timeout occurred during communication with the EADS server. |
Possible causes are as follows:
|
U |
3010 |
|
3011 |
ServerCommunicationException |
A timeout occurred while a request was being sent to an EADS server. |
Possible causes are as follows:
|
U |
3010 |
|
3012 |
ServerCommunicationException |
A timeout occurred while a response was being received from an EADS server. |
Possible causes are as follows:
|
U |
3010 |
|
3020 |
ServerCommunicationException |
Connection establishment with the EADS server failed. |
Possible causes are as follows:
|
N |
3020 |
|
3030 |
ServerCommunicationException |
A protocol error occurred during communication with the EADS server. |
The connection-target EADS server might be invalid. |
U |
3030 |
|
3040 |
ServerCommunicationException |
Establishment of a connection with all connectable EADS servers failed. |
Possible causes are as follows:
|
-- |
3040 |
|
4000 |
InternalServerException |
An unexpected internal error occurred on the EADS server. |
An unexpected problem occurred on the connection-target EADS server. |
U |
4000 |
|
4010 |
InternalServerException |
The connection-target EADS server could not process the request sent by the EADS client. |
Possible causes are as follows:
|
N |
4010 |
|
4030 |
InternalServerException |
The connection-target EADS server process is temporarily unavailable. |
The maximum number of simultaneous connections to the EADS server has been exceeded. |
N |
4030 |
|
4040 |
InternalServerException |
The cluster information maintained by the connection-target EADS server is not compatible with the cluster information maintained by the EADS client. |
The cluster information maintained by the restarted connection-target EADS server does not match the cluster information maintained by the EADS client. |
N |
4040 |
|
4060 |
InternalServerException |
The value could not be stored because the stored value did not match comparativeValue during execution of replace(). |
The value specified for the condition in replace() of the Cache class did not match the value in cache. |
N |
4060 |
|
4070 |
InternalServerException |
The value could not be stored because the specified key did not exist during execution of replace() (the value associated with the key did not exist). |
Values could not be compared because the value associated with the key specified in replace() of the Cache class did not exist. |
N |
4070 |
|
4080 |
InternalServerException |
The value could not be stored because the key had already been stored during execution of create(). |
The value associated with the key specified in create() of the Cache class has already been stored. |
N |
4080 |
|
4090 |
InternalServerException |
The value could not be stored because the key was not stored during execution of update(). |
The value associated with the key specified in update() of the Cache class has not been stored. |
N |
4090 |
|
4100 |
InternalServerException |
No EADS server is available for processing requests. |
Possible causes are as follows:
|
N |
4100 |
|
4110 |
InternalServerException |
The EADS server is in a status in which requests cannot be processed. |
The request could not be processed due to the status of the connection-target EADS server. |
N |
4000 |
|
4200 |
InternalServerException |
A cache operation failed. |
An operation could not be performed on a cache because a problem occurred on the connection-target EADS server. Stop the operation and check the EADS server's status. |
N |
4000 |
|
4210 |
InternalServerException |
A cache operation failed because the specified cache did not exist. |
An operation could not be performed on a cache because the specified cache did not exist. Stop operation on the specified cache and check the EADS server's status. |
N |
4000 |
|
4230 |
InternalServerException |
A cache operation failed because the cluster configuration was changed during request processing. |
An operation could not be performed on a cache because the cluster configuration was changed during request processing. Perform the cache operation again after the cluster configuration change processing has been completed. |
N |
4000 |
|
4300 |
InternalServerException |
An internal error occurred during a cache operation, but redundant copies of data had not been created. |
An internal error occurred during a cache operation on the connection-target EADS server. No other normal EADS servers are affected because redundant copies of data had not been created. You can restart the same operation after the EADS server is isolated and then the connection target is changed to a normal EADS server. |
N |
4000 |
|
4310 |
InternalServerException |
An internal error occurred on the EADS server during cache operation and the data update operation failed. |
An internal error occurred on the connection-target EADS server during cache operation. Because redundant copies of data had already been created, once the erroneous connection-target EADS server is isolated and the connection target is changed to a normal server, you can resume the operation from the status in which data had been updated. |
U |
4000 |
|
4700 |
InternalServerException |
An error occurred in the user function on the EADS server. |
An error occurred in the user function on the connection-target EADS server. Check the user function's processing. |
-- |
4000 |
|
4710 |
InternalServerException |
Serialization processing on the return value of the user function failed on the EADS server. |
An object that is not serializable is specified for the return value of the user function executed on the connection-target EADS server. |
-- |
4000 |
|
4720 |
InternalServerException |
An object that cannot be deserialized by the EADS server is specified in the argument of the user function. |
An object that cannot be deserialized by the connection-target EADS server is specified in the argument of the user function. |
-- |
4100 |
|
4730 |
InternalServerException |
No user function with the specified user function name exists on the EADS server. |
No user function with the specified user function name exists on the connection-target EADS server. |
-- |
4000 |
|
4800 |
InternalServerException |
There is a shortage of memory for storing data. |
The request could not be processed because the memory for storing data (explicit heap) was insufficient on the connection-target EADS server. |
N |
4000 |
|
4810 |
InternalServerException |
There is a shortage of capacity in the cache files for storing data. |
The request could not be processed because the capacity of cache files for storing data was insufficient on the connection-target EADS server. |
N |
4000 |
|
4820 |
InternalServerException |
The number of keys that can be stored on the EADS server has reached the upper limit. |
The request could not be processed because the number of keys that can be specified on the connection-target EADS server had reached the upper limit. |
N |
4000 |
|
4830 |
InternalServerException |
The size of the specified key, group name, or value is greater than the maximum size permitted in the cluster. |
The request could not be processed because the size of the specified key, group name, or value was greater than the maximum size permitted in the cluster. |
N |
4000 |
|
4999 |
InternalServerException |
A nonanalyzable internal error occurred on the EADS server. |
An internal error occurred on the connection-target EADS server, but the error could not be analyzed because the version of the connection-target EADS server was later than the version of the EADS client libraries. |
U |
4000 |
|
5000 |
InternalClientException |
An internal error occurred on the EADS client. |
An unexpected error occurred in client libraries. |
U |
5000 |
|
5010 |
InternalClientException |
Memory allocation in the EADS client failed. |
Memory allocation failed in client libraries. |
U |
5010 |
|
5020 |
InternalClientException |
Batch operation was cancelled. |
Unperformed operations were cancelled because batch operation could not be continued. |
N |
5020 |
|
6000 |
BatchOperationException |
All of the batch operations failed. |
An attempt was made to perform a batch operation on data by using an API method, but all operations failed. |
-- |
6000 |
|
6010 |
BatchOperationException |
Part of the batch operations failed. |
An attempt was made to perform a batch operation on data by using an API method, but some of the operations failed. |
-- |
6010 |
- #
-
Indicates whether data updating had occurred when the error code was issued during execution of an API method for updating data, such as put() or remove().
The meanings of the letters in this column are as follows:
U: Whether the data had been updated is unknown. Check whether the processing was completed.
N: The data has not been updated.
--: This error code is not issued when an API method for updating data, such as put() or remove(), is executed.