18.2.5 ServerInfo interface
- Organization of this subsection
-
(1) Description
This interface acquires information about an EADS server.
(2) Interface name
com.hitachi.software.xeads.common.ServerInfo
(3) List of methods
The following table lists and describes the methods provided by the ServerInfo interface:
Method name |
Description |
---|---|
Acquires the name of the EADS server (management directory name) that is executing the user function. |
|
Acquires the IP address and port number of the EADS server that is executing the user function. |
|
Acquires the EADS server ID of the EADS server that is executing the user function. |
|
[Deprecated] Acquires a list of cache names of the caches that have been created on the EADS server that is executing the user function. The acquired cache names are listed in ascending order based on their ASCII code values. |
|
[Deprecated] Acquires information about the cache type from the cache with a specified cache name. |
|
Acquires the explicit heap size allocated for caches by the EADS server that is executing the user function. |
|
Acquires the usage amount of the explicit heap allocated for caches by the EADS server that is executing the user function. |
|
[Deprecated] Acquires the size of one cache data file (value defined in the cache property file). |
|
[Deprecated] Acquires the size of the space available for storing persistent data in the cache data file currently under import processing. |
|
[Deprecated] Acquires the number of cache data files (value defined in the cache property file). |
|
[Deprecated] Acquires the number of unused cache data files that are currently available. |
(4) getName()
(a) Description
This method acquires the name of the EADS server (management directory name) that is executing the user function.
(b) Format
public String getName()
(c) Return value
This method returns the name of the EADS server (management directory name) that is executing the user function.
(5) getAddress()
(a) Description
This method acquires the IP address and port number of the EADS server that is executing the user function.
(b) Format
public InetSocketAddress getAddress()
(c) Return value
This method returns a java.net.InetSocketAddress instance indicating the IP address and port number of a server.
(6) getId()
(a) Description
This method acquires the EADS server ID of the EADS server that is executing the user function.
(b) Format
public int getId()
(c) Return value
This method returns the EADS server ID of the EADS server that is executing the user function.
(7) [Deprecated] getCacheNames()
- Reference note
-
This method is deprecated. Instead, use the getCacheNames() of the ClusterInfo interface.
(a) Description
This method acquires a list of cache names of the caches that have been created on the EADS server that is executing the user function.
The acquired cache names are listed in ascending order based on their ASCII code values.
(b) Format
public java.util.Set<String> getCacheNames()
(c) Return value
This method returns a list of cache names of the caches that have been created on the EADS server that is executing the user function.
If this method is called within init() or destroy() of the Function interface, null is returned.
(8) [Deprecated] getCacheType()
- Reference note
-
This method is deprecated. Instead, use the getType() of the ClusterInfo interface.
(a) Description
This method acquires information about the cache type from the cache with a specified cache name.
(b) Format
public CacheType getCacheType(String cacheName) throws EADsStoreException
(c) Parameters
- cacheName
-
Specifies a cache name.
For details about the data that can be specified, see 15.2.2(4) Data types that can be specified as cache names.
If the name of a cache that has not been created is specified, an error results.
(d) Return value
This method returns information about the cache type.
If this method is called within init() or destroy() of the Function interface, null is returned.
(e) Exceptions
-
UserOperationException (illegal user operation)
-
EADsStoreException (unexpected error)
(9) getEHeapSize()
(a) Description
This method acquires the explicit heap size allocated for caches by the EADS server that is executing the user function.
(b) Format
public long getEHeapSize() throws EADsStoreException
(c) Return value
This method returns the explicit heap size (in bytes) allocated for caches by the EADS server.
If this method is called within init() or destroy() of the Function interface, 0 is returned.
(d) Exceptions
-
InternalServerException (EADS server internal error)
-
EADsStoreException (unexpected error)
(10) getEHeapUsageSize()
(a) Description
This method acquires the usage amount of the explicit heap allocated for caches by the EADS server that is executing the user function.
(b) Format
public long getEHeapSize() throws EADsStoreException
(c) Return value
This method returns the usage amount (in bytes) of the explicit heap allocated for caches by the EADS server.
If this method is called within init() or destroy() of the Function interface, 0 is returned.
(d) Exceptions
-
InternalServerException (EADS server internal error)
-
EADsStoreException (unexpected error)
(11) [Deprecated] getCacheDataFileSpecifiedSize()
- Reference note
-
This method is deprecated. Instead, use the getCacheDataFileSize() of the CacheInfo interface.
(a) Description
This method acquires the size (in bytes) of one cache data file (value defined in the cache property file).
(b) Format
public long getCacheDataFileSpecifiedSize(String cacheName) throws EADsStoreException
(c) Parameters
- cacheName
-
Specifies a cache name.
For details about the data that can be specified, see 15.2.2(4) Data types that can be specified as cache names.
If the name of a cache that has not been created is specified, an error results.
(d) Return value
This method returns the size (in bytes) of one cache data file (value defined in the cache property file).
If this method is called within init() or destroy() of the Function interface, null is returned.
(e) Exceptions
-
UserOperationException (illegal user operation)
-
EADsStoreException (unexpected error)
(12) [Deprecated] getCacheDataFileRemainingSize()
- Reference note
-
This method is deprecated. Instead, use the getRemainingAreaSizeOfWritingCacheDataFile() of the CacheInfo interface.
(a) Description
This method acquires the size (in bytes) of the space available for storing persistent data in the cache data file currently under import processing.
(b) Format
public long getCacheDataFileRemainingSize(String cacheName, String key) throws EADsStoreException
(c) Parameters
- cacheName
-
Specifies a cache name.
For details about the data that can be specified, see 15.2.2(4) Data types that can be specified as cache names.
If the name of a cache that has not been created is specified, an error results.
- key
-
Specifies a key to be associated with the value. The specification must be a group name.
For details about the data that can be specified, see 15.2.2(1) Data types that can be specified as keys.
Note that if the specified key does not belong to the EADS server that is executing the user function, an error results.
(d) Return value
This method returns the size (in bytes) of the space available for storing persistent data in the cache data file currently under import processing.
If this method is called within init() or destroy() of the Function interface, 0 is returned.
(e) Exceptions
-
UserOperationException (illegal user operation)
-
InternalServerException (EADS server internal error)
-
EADsStoreException (unexpected error)
(f) Notes
-
The available file size returned by this method is the information at the time the method executes. This value might change due to cache operations or compaction.
-
This method acquires information about the EADS server that is executing this method. The method cannot acquire information about other EADS servers.
-
If this method's return value indicates sufficient space in the cache data files but a space shortage has occurred on the EADS server to which data is to be copied, that target EADS server will be isolated when data is actually stored. Determine whether data can actually be stored taking into account the available space on the target EADS server in addition to this method's return value.
(13) [Deprecated] getCacheDataFileSpecifiedNumber()
- Reference note
-
This method is deprecated. Instead, use the getCacheDataFilesNumber() of the CacheInfo interface.
(a) Description
This method acquires the number of cache data files (value defined in the cache property file).
(b) Format
public int getCacheDataFileSpecifiedNumber(String cacheName) throws EADsStoreException
(c) Parameters
- cacheName
-
Specifies a cache name.
For details about the data that can be specified, see 15.2.2(4) Data types that can be specified as cache names.
If the name of a cache that has not been created is specified, an error results.
(d) Return value
This method returns the number of cache data files (value defined in the cache property file).
If this method is called within init() or destroy() of the Function interface, 0 is returned.
(e) Exceptions
-
UserOperationException (illegal user operation)
-
EADsStoreException (unexpected error)
(14) [Deprecated] getCacheDataFileUnusedNumber()
- Reference note
-
This method is deprecated. Instead, use the getRemainingCacheDataFilesNumber() of the CacheInfo interface.
(a) Description
This method acquires the number of unused cache data files that are currently available.
(b) Format
public int getCacheDataFileUnusedNumber(String cacheName, String key) throws EADsStoreException
(c) Parameters
- cacheName
-
Specifies a cache name.
For details about the data that can be specified, see 15.2.2(4) Data types that can be specified as cache names.
If the name of a cache that has not been created is specified, an error results.
- key
-
Specifies a key to be associated with the value. The specification must be a group name.
For details about the data that can be specified, see 15.2.2(1) Data types that can be specified as keys.
Note that if the specified key does not belong to the EADS server that is executing the user function, an error results.
(d) Return value
This method returns the number of unused cache data files that are currently available. This value does not include the number of files reserved by the EADS server.
If the cache data file currently under import processing is the last available cache data file, the method returns 0.
If this method is called within init() or destroy() of the Function interface, 0 is returned.
(e) Exceptions
-
UserOperationException (illegal user operation)
-
InternalServerException (EADS server internal error)
-
EADsStoreException (unexpected error)
(f) Notes
-
The number of unused files returned by this method is the information at the time the method executes. This value might change due to cache operations or compaction.
-
This method acquires information about the EADS server that is executing this method. The method cannot acquire information about other EADS servers.
-
If this method's return value indicates sufficient space in the cache data files but a space shortage has occurred on the EADS server to which data is to be copied, that target EADS server will be isolated when data is actually stored. Determine whether data can actually be stored taking into account the available space on the target EADS server in addition to this method's return value.